這是一篇Android RecyclerView使用介紹哦
RecyclerView三種自帶佈局
RecyclerView是support.v7包中的控制元件,可以說是ListView和GridView的增強升級版。
官方對RecyclerView的描述是(不翻譯不是因為我英語差啊,真的):
A flexible view for providing a limited window into a large data set.
RecyclerView從2014年釋出到現在已經很長時間了,使用已經相當普遍。
本文主要介紹了RecyclerView的基礎使用、自動載入更多資料、item的拖拽和划動刪除。詳細效果和使用請看我的demo;
RecyclerView基礎用法
RecyclerView的用法和ListView類似。我用網格佈局為例,先上程式碼再細說。
首先在佈局中要建立這個控制元件:
<?xml version="1.0" encoding="utf-8"?>
<android.support.design.widget.CoordinatorLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/grid_coordinatorLayout"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:fitsSystemWindows="true"
android:background="#ffffff"
tools:context="com.zcp.recyclerviewddmo.GridActivity">
<!--工具欄-->
<android.support.design.widget.AppBarLayout
android:layout_width ="match_parent"
android:layout_height="wrap_content"
android:theme="@style/AppTheme.AppBarOverlay">
<android.support.v7.widget.Toolbar
android:id="@+id/toolbar"
android:layout_width="match_parent"
android:layout_height="?attr/actionBarSize"
android:background="?attr/colorPrimary"
/>
</android.support.design.widget.AppBarLayout>
<!--下拉重新整理控制元件-->
<android.support.v4.widget.SwipeRefreshLayout
android:id="@+id/grid_swipe_refresh"
android:layout_width="match_parent"
android:layout_height="match_parent"
app:layout_behavior="@string/appbar_scrolling_view_behavior"
>
<!--本文主角-->
<android.support.v7.widget.RecyclerView
android:id="@+id/grid_recycler"
android:layout_width="match_parent"
android:layout_height="match_parent"
/>
</android.support.v4.widget.SwipeRefreshLayout>
</android.support.design.widget.CoordinatorLayout>
Activity的程式碼如下:
public class GridActivity extends AppCompatActivity {
private static RecyclerView recyclerview;
private CoordinatorLayout coordinatorLayout;
private GridAdapter mAdapter;
private List<Meizi> meizis;
private GridLayoutManager mLayoutManager;
private int lastVisibleItem ;
private int page=1;
private ItemTouchHelper itemTouchHelper;
private SwipeRefreshLayout swipeRefreshLayout;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_grid);
Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar);
setSupportActionBar(toolbar);
initView();//初始化佈局
setListener();//設定監聽事件
//執行載入資料
new GetData().execute("http://gank.io/api/data/福利/10/1");
}
private void initView(){
coordinatorLayout=(CoordinatorLayout)findViewById(R.id.grid_coordinatorLayout);
recyclerview=(RecyclerView)findViewById(R.id.grid_recycler);
mLayoutManager=new GridLayoutManager(GridActivity.this,3,GridLayoutManager.VERTICAL,false);//設定為一個3列的縱向網格佈局
recyclerview.setLayoutManager(mLayoutManager);
swipeRefreshLayout=(SwipeRefreshLayout) findViewById(R.id.grid_swipe_refresh) ;
//調整SwipeRefreshLayout的位置
swipeRefreshLayout.setProgressViewOffset(false, 0, (int) TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP, 24, getResources().getDisplayMetrics()));
}
private void setListener(){
//swipeRefreshLayout重新整理監聽
swipeRefreshLayout.setOnRefreshListener(new SwipeRefreshLayout.OnRefreshListener() {
@Override
public void onRefresh() {
page=1;
new GetData().execute("http://gank.io/api/data/福利/10/1");
}
});
}
private class GetData extends AsyncTask<String, Integer, String> {
@Override
protected void onPreExecute() {
super.onPreExecute();
//設定swipeRefreshLayout為重新整理狀態
swipeRefreshLayout.setRefreshing(true);
}
@Override
protected String doInBackground(String... params) {
return MyOkhttp.get(params[0]);
}
protected void onPostExecute(String result) {
super.onPostExecute(result);
if(!TextUtils.isEmpty(result)){
JSONObject jsonObject;
Gson gson=new Gson();
String jsonData=null;
try {
jsonObject = new JSONObject(result);
jsonData = jsonObject.getString("results");
} catch (JSONException e) {
e.printStackTrace();
}
if(meizis==null||meizis.size()==0){
meizis= gson.fromJson(jsonData, new TypeToken<List<Meizi>>() {}.getType());
Meizi pages=new Meizi();
pages.setPage(page);
meizis.add(pages);//在資料鏈表中加入一個用於顯示頁數的item
}else{
List<Meizi> more= gson.fromJson(jsonData, new TypeToken<List<Meizi>>() {}.getType());
meizis.addAll(more);
Meizi pages=new Meizi();
pages.setPage(page);
meizis.add(pages);//在資料鏈表中加入一個用於顯示頁數的item
}
if(mAdapter==null){
recyclerview.setAdapter(mAdapter = new GridAdapter(GridActivity.this,meizis));//recyclerview設定介面卡
//實現介面卡自定義的點選監聽
mAdapter.setOnItemClickListener(new GridAdapter.OnRecyclerViewItemClickListener() {
@Override
public void onItemClick(View view) {
int position=recyclerview.getChildAdapterPosition(view);
SnackbarUtil.ShortSnackbar(coordinatorLayout,"點選第"+position+"個",SnackbarUtil.Info).show();
//彩色Snackbar工具類,請看我之前的文章《沒時間解釋了,快使用Snackbar!——Android Snackbar花式使用指南》http://www.jianshu.com/p/cd1e80e64311
}
@Override
public void onItemLongClick(View view) {
}
});
}else{
//讓介面卡重新整理資料
mAdapter.notifyDataSetChanged();
}
}
//停止swipeRefreshLayout載入動畫
swipeRefreshLayout.setRefreshing(false);
}
}
}
接下來我們看RecyclerView的介面卡:
public class GridAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> implements View.OnClickListener, View.OnLongClickListener {
private Context mContext;
private List<Meizi> datas;//資料
//自定義監聽事件
public static interface OnRecyclerViewItemClickListener {
void onItemClick(View view);
void onItemLongClick(View view);
}
private OnRecyclerViewItemClickListener mOnItemClickListener = null;
public void setOnItemClickListener(OnRecyclerViewItemClickListener listener) {
mOnItemClickListener = listener;
}
//介面卡初始化
public GridAdapter(Context context,List<Meizi> datas) {
mContext=context;
this.datas=datas;
}
@Override
public int getItemViewType(int position) {
//判斷item類別,是圖還是顯示頁數(圖片有URL)
if (!TextUtils.isEmpty(datas.get(position).getUrl())) {
return 0;
} else {
return 1;
}
}
@Override
public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType)
{
//根據item類別載入不同ViewHolder
if(viewType==0){
View view = LayoutInflater.from(mContext
).inflate(R.layout.grid_meizi_item, parent,
false);//這個佈局就是一個imageview用來顯示圖片
MyViewHolder holder = new MyViewHolder(view);
//給佈局設定點選和長點選監聽
view.setOnClickListener(this);
view.setOnLongClickListener(this);
return holder;
}else{
MyViewHolder2 holder2=new MyViewHolder2(LayoutInflater.from(
mContext).inflate(R.layout.page_item, parent,
false));//這個佈局就是一個textview用來顯示頁數
return holder2;
}
}
@Override
public void onBindViewHolder(RecyclerView.ViewHolder holder, int position) {
//將資料與item檢視進行繫結,如果是MyViewHolder就載入網路圖片,如果是MyViewHolder2就顯示頁數
if(holder instanceof MyViewHolder){
Picasso.with(mContext).load(datas.get(position).getUrl()).into(((MyViewHolder) holder).iv);//載入網路圖片
}else if(holder instanceof MyViewHolder2){
((MyViewHolder2) holder).tv.setText(datas.get(position).getPage()+"頁");
}
}
@Override
public int getItemCount()
{
return datas.size();//獲取資料的個數
}
//點選事件回撥
@Override
public void onClick(View v) {
if (mOnItemClickListener != null) {
mOnItemClickListener.onItemClick(v);
}
}
@Override
public boolean onLongClick(View v) {
if (mOnItemClickListener!= null) {
mOnItemClickListener.onItemLongClick(v);
}
return false;
}
//自定義ViewHolder,用於載入圖片
class MyViewHolder extends RecyclerView.ViewHolder
{
private ImageButton iv;
public MyViewHolder(View view)
{
super(view);
iv = (ImageButton) view.findViewById(R.id.iv);
}
}
//自定義ViewHolder,用於顯示頁數
class MyViewHolder2 extends RecyclerView.ViewHolder
{
private TextView tv;
public MyViewHolder2(View view)
{
super(view);
tv = (TextView) view.findViewById(R.id.tv);
}
}
//新增一個item
public void addItem(Meizi meizi, int position) {
meizis.add(position, meizi);
notifyItemInserted(position);
recyclerview.scrollToPosition(position);//recyclerview滾動到新加item處
}
//刪除一個item
public void removeItem(final int position) {
meizis.remove(position);
notifyItemRemoved(position);
}
}
資料類:
public class Meizi {
private String url;//圖片地址
private int page;//頁數
public String getUrl() {
return url;
}
public void setUrl(String url) {
this.url = url;
}
public int getPage() {
return page;
}
public void setPage(int page) {
this.page = page;
}
}
RecyclerView的使用和ListView很像吧。
RecyclerView需要通過setLayoutManager()方法設定佈局管理器,RecyclerView有三個預設佈局管理器LinearLayoutManager、GridLayoutManager、StaggeredGridLayoutManager,都支援橫向和縱向排列以及反向滑動。如果想把RecyclerView改為橫向滑動,也可以通過呼叫
mLayoutManager.setOrientation(GridLayoutManager.HORIZONTAL);
RecyclerView不像ListView一樣提供item的點選監聽,所以我們只能自己實現。RecyclerView的item點選事件監聽可以向我本文中為item的view設定監聽,也可以在recyclerView.addOnItemTouchListener裡去判斷手勢來實現。
通過呼叫如下方法可以設定item載入或移除時的動畫
recyclerView.setItemAnimator(new DefaultItemAnimator());
自動載入更多
要想實現滑動到列表某處時自動載入下一頁(比如剩最後兩個item時),可以通過對RecyclerView設定滑動監聽,獲取當前顯示的最後一個item在介面卡中的位置,如果該item的位置小於或等於介面卡item總個數減2,就載入下一頁資料。
GridLayoutManager和LinearLayoutManager時方法如下:
//recyclerview滾動監聽
recyclerview.addOnScrollListener(new RecyclerView.OnScrollListener() {
@Override
public void onScrollStateChanged(RecyclerView recyclerView, int newState) {
super.onScrollStateChanged(recyclerView, newState);
//0:當前螢幕停止滾動;1時:螢幕在滾動 且 使用者仍在觸碰或手指還在螢幕上;2時:隨使用者的操作,螢幕上產生的慣性滑動;
// 滑動狀態停止並且剩餘少於兩個item時,自動載入下一頁
if (newState == RecyclerView.SCROLL_STATE_IDLE
&& lastVisibleItem +2>=mLayoutManager.getItemCount()) {
new GetData().execute("http://gank.io/api/data/福利/10/"+(++page));
}
}
@Override
public void onScrolled(RecyclerView recyclerView, int dx, int dy) {
super.onScrolled(recyclerView, dx, dy);
//獲取載入的最後一個可見檢視在介面卡的位置。
lastVisibleItem = mLayoutManager.findLastVisibleItemPosition();
}
});
StaggeredGridLayoutManager因為item的位置是交錯的,findLastVisibleItemPosition()方法返回的是一個數組,所以我們得先判斷下這個陣列的最大值,上面的onScrolled方法寫成這樣
int[] positions= mLayoutManager.findLastVisibleItemPositions(null);
lastVisibleItem =Math.max(positions[0],positions[1]);//根據StaggeredGridLayoutManager設定的列數來定
自動載入下一頁.gif
XRecyclerView是別人寫的一個庫,實現了RecyclerView的下拉頭和底部載入佈局,需要的可以看下。
Item拖拽和滑動刪除
ItemTouchHelper是一個處理RecyclerView的滑動刪除和拖拽的輔助類,RecyclerView 的item拖拽移動和滑動刪除就靠它來實現。
ItemTouchHelper的監聽如下
itemTouchHelper=new ItemTouchHelper(new ItemTouchHelper.Callback() {
//用於設定拖拽和滑動的方向
@Override
public int getMovementFlags(RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder) {
int dragFlags=0,swipeFlags=0;
if(recyclerView.getLayoutManager() instanceof StaggeredGridLayoutManager||recyclerView.getLayoutManager() instanceof GridLayoutManager){
//網格式佈局有4個方向
dragFlags=ItemTouchHelper.UP|ItemTouchHelper.DOWN|ItemTouchHelper.LEFT|ItemTouchHelper.RIGHT;
}else if(recyclerView.getLayoutManager() instanceof LinearLayoutManager){
//線性式佈局有2個方向
dragFlags=ItemTouchHelper.UP|ItemTouchHelper.DOWN;
swipeFlags = ItemTouchHelper.START|ItemTouchHelper.END; //設定側滑方向為從兩個方向都可以
}
return makeMovementFlags(dragFlags,swipeFlags);//swipeFlags 為0的話item不滑動
}
//長摁item拖拽時會回撥這個方法
@Override
public boolean onMove(RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder, RecyclerView.ViewHolder target) {
int from=viewHolder.getAdapterPosition();
int to=target.getAdapterPosition();
Meizi moveItem=meizis.get(from);
meizis.remove(from);
meizis.add(to,moveItem);//交換資料鏈表中資料的位置
mAdapter.notifyItemMoved(from,to);//更新介面卡中item的位置
return true;
}
@Override
public void onSwiped(RecyclerView.ViewHolder viewHolder, int direction) {
//這裡處理滑動刪除
}
@Override
public boolean isLongPressDragEnabled() {
return false;//返回true則為所有item都設定可以拖拽
}
});
itemTouchHelper需要與recyclerView繫結才有效果,在recyclerView初始化的時候呼叫
itemTouchHelper.attachToRecyclerView(recyclerview);
因為我想要網格佈局中的圖片item可拖拽,而頁數item不可拖拽,所以我isLongPressDragEnabled()方法返回的false,而在item的長點選事件監聽中做具體處理。
mAdapter.setOnItemClickListener(new GridAdapter.OnRecyclerViewItemClickListener() {
@Override
public void onItemClick(View view) {
}
@Override
public void onItemLongClick(View view) {
itemTouchHelper.startDrag(recyclerview.getChildViewHolder(view));//設定拖拽item
}
});
如果你想為item設定拖拽和滑動時的響應動畫效果,可以利用ItemTouchHelper的下面三個方法。用線性佈局示例:
//當item拖拽開始時呼叫
@Override
public void onSelectedChanged(RecyclerView.ViewHolder viewHolder, int actionState) {
super.onSelectedChanged(viewHolder, actionState);
if(actionState==ItemTouchHelper.ACTION_STATE_DRAG){
viewHolder.itemView.setBackgroundColor(Color.LTGRAY);//拖拽時設定背景色為灰色
}
}
//當item拖拽完成時呼叫
@Override
public void clearView(RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder) {
super.clearView(recyclerView, viewHolder);
viewHolder.itemView.setBackgroundColor(Color.WHITE);//拖拽停止時設定背景色為白色
}
//當item檢視變化時呼叫
@Override
public void onChildDraw(Canvas c, RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder, float dX, float dY, int actionState, boolean isCurrentlyActive) {
super.onChildDraw(c, recyclerView, viewHolder, dX, dY, actionState, isCurrentlyActive);
//根據item滑動偏移的值修改item透明度。screenwidth是我提前獲得的螢幕寬度
viewHolder.itemView.setAlpha(1-Math.abs(dX)/screenwidth);
}
拖拽和滑動刪除.gif
本文送給說“三百六十行,行行出碼農”,然後來跟我搶飯碗的兩位兄弟。
我知道你們都喜歡看妹子 →_→...
大家覺得本文還行的話請點個贊n(≧▽≦)n