官方介紹,RecyclerView用于在有限的窗口展現(xiàn)大量的數(shù)據(jù),其實早已經(jīng)有了類似的控件,如ListView、GridView,那么相比它們,RecyclerView有什么樣優(yōu)勢呢?
RecyclerView標(biāo)準(zhǔn)化了ViewHolder,而且異常的靈活,可以輕松實現(xiàn)ListView實現(xiàn)不了的樣式和功能:
設(shè)置布局管理器以控制Item的布局方式,橫向、豎向以及瀑布流方式。
可設(shè)置Item操作的動畫(刪除或者添加等)
可設(shè)置Item的間隔樣式(可繪制)
但是關(guān)于Item的點擊和長按事件,需要用戶自己去實現(xiàn)。
在使用RecyclerView時候,必須指定一個適配器Adapter和一個布局管理器LayoutManager。
適配器繼承RecyclerView.Adapter類 ,具體實現(xiàn)類似ListView的適配器,取決于數(shù)據(jù)信息以及展示的UI。
布局管理器用于LayoutManager類 , 確定RecyclerView中Item的展示方式以及決定何時復(fù)用已經(jīng)不可見的Item,避免重復(fù)創(chuàng)建以及執(zhí)行高成本的findViewById()方法。
用法:
RecyclerView mRecyclerView = (RecyclerView)findViewById(R.id.recycler_view);
// 設(shè)置布局管理器
mRecyclerView.setLayoutManager(mLayoutManager);
// 設(shè)置adapter
mRecyclerView.setAdapter(mAdapter);
// 設(shè)置Item添加和移除的動畫
mRecyclerView.setItemAnimator(new DefaultItemAnimator());
// 設(shè)置Item之間間隔樣式
mRecyclerView.addItemDecoration(mDividerItemDecoration);
RecyclerView提供了三種布局管理器:
LinerLayoutManager 以垂直或者水平列表方式展示Item
GridLayoutManager 以網(wǎng)格方式展示Item
StaggeredGridLayoutManager 以瀑布流方式展示Item
基本使用:
RecyclerView屬于新增的控件,Android團隊將RecyclerView定義在了support庫當(dāng)中。所以,若要使用,需現(xiàn)在build.gradle中加入依賴庫
dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
compile 'com.android.support:appcompat-v7:25.1.0'
compile 'com.android.support:recyclerview-v7:25.1.0' //添加RecycleView的依賴庫
testCompile 'junit:junit:4.12'
}
布局文件中添加recyclerview
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent">
<android.support.v7.widget.RecyclerView
android:id="@+id/recycler_view"
android:layout_width="match_parent"
android:layout_height="match_parent"
/>
</LinearLayout>
recyclerview子項 fruit_item.xml:
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_margin="5dp">
<ImageView
android:id="@+id/fruit_image"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="center_horizontal"
/>
<TextView
android:id="@+id/fruit_name"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="left"
android:layout_marginTop="10dp"
/>
</LinearLayout>
實現(xiàn)指定的適配器adapter必須重寫下面三個方法:
1. public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType)
2. public void onBindViewHolder(ViewHolder holder, int position)
3. public int getItemCount()
public class FruitAdapter extends RecyclerView.Adapter<FruitAdapter.ViewHolder>{
private List<Fruit>mFruitList;
//定義一個內(nèi)部類ViewHolder,繼承自RecyclerView.ViewHolder,用來緩存子項的各個實例,提高效率
static class ViewHolder extends RecyclerView.ViewHolder{
View fruitView;
ImageView fruitImage;
TextView fruitName;
public ViewHolder(View view){
super(view);
fruitView = view;
fruitImage = (ImageView)view.findViewById(R.id.fruit_image);
fruitName=(TextView)view.findViewById(R.id.fruit_name);
}
}
//綁定傳入的數(shù)據(jù)源
public FruitAdapter(List<Fruit> fruitList){
mFruitList = fruitList;
}
//實現(xiàn)onCreateViewHolder方法,返回給recyclerView使用
@Override
public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.fruit_item,parent,false);
final ViewHolder holder = new ViewHolder(view);
holder.fruitView.setOnClickListener(new View.OnClickListener(){
@Override
public void onClick(View v) {
int position = holder.getAdapterPosition();
Fruit fruit = mFruitList.get(position);
Toast.makeText(v.getContext(),"you clicked view "+fruit.getName(),Toast.LENGTH_SHORT).show();
}
});
holder.fruitImage.setOnClickListener(new View.OnClickListener(){
@Override
public void onClick(View v) {
int position = holder.getAdapterPosition();
Fruit fruit = mFruitList.get(position);
Toast.makeText(v.getContext(),"you clicked image "+fruit.getName(),Toast.LENGTH_SHORT).show();
}
});
return holder;
}
//實現(xiàn)onBindViewHolder方法,設(shè)置子Item上各個實例
@Override
public void onBindViewHolder(ViewHolder holder, int position) {
Fruit fruit = mFruitList.get(position);
holder.fruitImage.setImageResource(fruit.getImageId());
holder.fruitName.setText(fruit.getName());
}
//返回子項個數(shù)
@Override
public int getItemCount() {
return mFruitList.size();
}
}
使用RecycleView:
public class MainActivity extends AppCompatActivity {
private List<Fruit> fruitList = new ArrayList<>();
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
initFruits();
RecyclerView recyclerView = (RecyclerView)findViewById(R.id.recycler_view);
//LinearLayoutManager layoutManager = new LinearLayoutManager(this); //線性,垂直或水平布局
//設(shè)置為水平排列,用setOrientation方法設(shè)置
//layoutManager.setOrientation(LinearLayoutManager.HORIZONTAL);
/*StaggeredGridLayoutManager()接收兩個參數(shù),第一個是指定布局列數(shù),第二個指定布局的排列方向*/
//實例化瀑布流布局管理器
StaggeredGridLayoutManager layoutManager = new StaggeredGridLayoutManager(3,StaggeredGridLayoutManager.VERTICAL);
//實例化適配器
FruitAdapter adapter = new FruitAdapter(fruitList);
//設(shè)置recyclerView的布局管理器
recyclerView.setLayoutManager(layoutManager);
//設(shè)置recyclerView的適配器
recyclerView.setAdapter(adapter);
}
}
RecyclerView的點擊事件: 可直接在onCreateViewHolder方法中注冊監(jiān)聽點擊事件
@Override
public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.fruit_item,parent,false);
final ViewHolder holder = new ViewHolder(view);
//直接在onCreateViewHolder方法中設(shè)置監(jiān)聽點擊事件
holder.fruitView.setOnClickListener(new View.OnClickListener(){
@Override
public void onClick(View v) {
int position = holder.getAdapterPosition();
Fruit fruit = mFruitList.get(position);
Toast.makeText(v.getContext(),"you clicked view "+fruit.getName(),Toast.LENGTH_SHORT).show();
}
});
holder.fruitImage.setOnClickListener(new View.OnClickListener(){
@Override
public void onClick(View v) {
int position = holder.getAdapterPosition();
Fruit fruit = mFruitList.get(position);
Toast.makeText(v.getContext(),"you clicked image "+fruit.getName(),Toast.LENGTH_SHORT).show();
}
});
return holder;
}
運行效果:
自定義間隔可使用 RecyclerView.addItemDecoration()
動畫
前面說過,RecyclerView可以設(shè)置列表中Item刪除和添加的動畫,在v7包中給我們提供了一種默認的Item刪除和添加的動畫,如果沒有特殊的需求,默認使用這個動畫即可。
// 設(shè)置Item添加和移除的動畫
mRecyclerView.setItemAnimator(new DefaultItemAnimator());
可以在adapter中添加方法:
public void addNewItem() {
if(mData == null) {
mData = new ArrayList<>();
}
mData.add(0, "new Item");
notifyItemInserted(0); //添加后發(fā)通知
}
public void deleteItem() {
if(mData == null || mData.isEmpty()) {
return;
}
mData.remove(0);
notifyItemRemoved(0); //刪除后發(fā)通知
}
然后在活動中調(diào)用: 就會看到動畫效果 再調(diào)用 mLayoutManager.scrollToPosition(0),回到最新的地方
public void onClick(View v) {
int id = v.getId();
if(id == R.id.rv_add_item_btn) {
mAdapter.addNewItem();
// 由于Adapter內(nèi)部是直接在首個Item位置做增加操作,增加完畢后列表移動到首個Item位置
mLayoutManager.scrollToPosition(0);
} else if(id == R.id.rv_del_item_btn){
mAdapter.deleteItem();
// 由于Adapter內(nèi)部是直接在首個Item位置做刪除操作,刪除完畢后列表移動到首個Item位置
mLayoutManager.scrollToPosition(0);
}
}