單一的RecyclerView實現的效果圖:
上圖隨意用的幾個Android自帶的icon,不太美觀請輕點吐槽....
既然本篇博文介紹的是基本用法,僅提供本人拙見,就不手把手教程如何實現,所以請伸手黨止步哈.
引用
- Gradle依賴
compile 'com.android.support:recyclerview-v7:25.0.1'
- 主布局引用
<android.support.v7.widget.RecyclerView
android:id="@+id/recyclerview"
android:scrollbars="none"
android:layout_width="match_parent"
android:layout_height="match_parent" />
LayoutManager:
這是一個抽象類,負責將每個Item視圖在RecylerView中的布局,系統提供了3個實現類:
- LinearLayoutManager 現行管理器,支持橫向、縱向。
- GridLayoutManager 網格布局管理器
- StaggeredGridLayoutManager 瀑布就式布局管理器
LinearLayoutManager mLinearLayoutManager = new LinearLayoutManager(MainActivity.this); //GridLayoutManager mGridLayoutManager = new GridLayoutManager(MainActivity.this, 4); /*StaggeredGridLayoutManager mStaggeredGridLayoutManager = new StaggeredGridLayoutManager(4, StaggeredGridLayoutManager.VERTICAL);*/ mLinearLayoutManager.setOrientation(LinearLayoutManager.VERTICAL);//豎直方向 //水平方向:LinearLayoutManager.HORIZONTAL
ItemAnimator:
ItemAnimator也是一個抽象類,系統為我們提供了一種默認的實現類,當Adapter執行notifyItemRemoved()、
notifyItemInserted()進行增加/刪除某一項Item時會有動畫效果,還用一種是移動Item。
DefaultItemAnimator mDefaultItemAnimator=new DefaultItemAnimator();
DividerItemDecoration
顧名思義就是Item間的分割線,實現很簡單(注意RecyclerView包版本)
DividerItemDecoration mDividerItemDecoration =new DividerItemDecoration(MainActivity.this,DividerItemDecoration.VERTICAL);
分割線樣式在你的AppTheme里面添加:
<!-- Base application theme. -->
<style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">
...
<item name="android:listDivider">@drawable/divider_bg</item> //shape
</style>
** RecyclerViewAdapter**
Adapter 沒有提供Item點擊回調給我們,因此,我們需要主動回調Item或Item內控件的點擊事件。
public class RecyclerViewAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
Context mContext;
OnItemClickListener onItemClickListener;
List<UserInfo> userInfoList;
public RecyclerViewAdapter(Context mContext,List<UserInfo> userInfoList) {
this.mContext = mContext;
this.userInfoList = userInfoList;
}
@Override
public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
View view = LayoutInflater.from(mContext).inflate(R.layout.item_data_list, parent, false);
return new ViewHolder(view);
}
@Override
public void onBindViewHolder(RecyclerView.ViewHolder holder, final int position) {
ViewHolder vh = (ViewHolder) holder;
/*當ItemView被點擊時,我們通過接口回調給調用方法。如果還需對外提供ItemView內某個Button或
TextView的點擊事件,將vh.itemView改為相應控件即可*/
UserInfo userInfo = userInfoList.get(position);
if(userInfo.getName()!=null) {
vh.tv_name..setText(userInfo.getName());
}
vh.itemView.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
if (onItemClickListener != null) {
onItemClickListener.onItemClick();
}
}
});
}
//向外提供點擊回調方法。
public void setOnItemClickListener(OnItemClickListener onItemClickListener) {
this.onItemClickListener = onItemClickListener;
}
//Item的點擊接口
public interface OnItemClickListener {
void onItemClick();
}
@Override
public int getItemCount() {
//Item總數
return userInfoList !=null ? userInfoList.size() : 0;
}
@Override
public int getItemViewType(int position) {
return super.getItemViewType(position);
}
private class ViewHolder extends RecyclerView.ViewHolder {
TextView tv_name;
ViewHolder(View itemView) {
super(itemView);
tv_name = (TextView) itemView.findViewById(R.id.tv_name);
}
}
}
以上是最簡單的Adapter寫法,粗略介紹一下每個方法的作用
getItemCount():
視圖總數,如果我們不需要多樣式的Item顯示不同的數據,可以像上面寫的一樣返回List數據的個數。如果我們需要像博文開頭的效果圖那樣的效果,就需要我們計算好所有Item的數量,例如頭布局數+中間布局數+腳布局數+分割線數。getItemViewType(int position):
該方法里有個參數position,當Adapter正在加載位置為position的ItemView視圖樣式時,通過這個方法獲取到我們自定義的ItemViewType,再一步步的通過這個ItemViewType加載視圖樣式然后填充數據...例如效果圖,頭部布局的位置(position)為0,我們設置頭部的CardView布局的ItemViewType為0(不一定是0),在onCreateViewHolder方法中就可以通過viewType來加載相應的Item視圖
@Override
public int getItemViewType(int position) {
if (position == 0){
return topViewType;//private final int topViewType = 0;
}
...
}
- onCreateViewHolder(ViewGroup parent, int viewType):
既然要實現多樣式,那么你不同的Item的樣式要改吧,我們可以通過viewType去加載相應的布局,并將布局傳入ViewHolder進行保存,以達復用。
@Override
public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
if (viewType == topViewType){
View view = LayoutInflater.from(mContext).inflate(R.layout.item_top, parent, false);
return new ViewHolder(view);
}
...
}
- onBindViewHolder(RecyclerView.ViewHolder holder, int position) :
好了,拿到Adapter的position位置上的ViewHolder,我們將數據綁定在holder上。但是這里的position是Adapter的位置。也就是說,如果現在要綁定中間布局的數據,我們的position為頭布局Item數+position。
@Override
public void onBindViewHolder(RecyclerView.ViewHolder holder, final int position) {
if (holder instanceof ViewHolder){
ViewHolder vh = (ViewHolder) holder;
}
...
}
- 調用
RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recyclerview);
recyclerView.setItemAnimator(mDefaultItemAnimator);//設置默認動畫(可選)
recyclerView.setLayoutManager(mLinearLayoutManager);//設置布局管理器(必選)
recyclerView.addItemDecoration(new DividerItemDecoration(this, mDividerItemDecoration);//設置分割線(可選)
RecyclerViewAdapter recyclerViewAdapter = new RecyclerViewAdapter(MainActivity.this, userInfoList);
recyclerView.setAdapter(recyclerViewAdapter);//加載適配器(必選)