目录:
-
一 RecyclerView简介
-
二 RecyclerView为什么会出现
-
三 基本使用方法
-
四 高级用法
Scrollbars
Item间分割线
Item显示方式
自定义LayoutManager
RecyclerView的点击事件
高级效果 波纹点击
添加 删除时动画
与某些View结合使用
滑动监听addOnScrollListener 可实现下拉刷新等
ItemTouchHelper实现item删除,互相拉动
-
五 RecyclerView多种布局显示
-
六 注意(未全)
-
七 开源库XRecyclerView
一 RecyclerView简介
官方对RecycleView的描述是在有限的窗口中大量显示数据集
的灵活view,类似ListView,GridViewRecyclerView在support.V7包里,个人觉得Google是为了用它来替代ListView
可以实现
1.ListView的功能(包括横向)
2.GridView的功能
3.横向ScrollView
4.瀑布流
5.方便添加animation(item的add remove时)
二 RecyclerView为什么会出现
优点
高度解耦,随意定制。它提供的LayoutManager,ItemDecoration,ItemAnimator可以让开发者自定义奇特的效果
RecyclerView封装了ViewHolder
通过设置LayoutManager可以设计Item的显示的方式,横,竖甚至瀑布流
通过ItemDecoration可以控制Item间的间隔条,还有自定义间隔条
通过ItemAnimator可以控制Item增删的动画
缺点
- 短按长按点击事件需要自己来实现(WTF)
虽然有缺点,但是几乎忽略不计,RecyclerView的随意定制,其自带的ViewHolder不再像ListView中ViewHolder作为View出现,其“Recycle”的强大,一行代码切换布局样式的优点使其势必取代ListView
三 基本使用方法
当前IDE:Android Studio 2.2正式版
jdk1.8.102
compileSdkVersion 25
buildToolsVersion "25.0.2"
gradle导包
compile 'com.android.support:recyclerview-v7:25.2.0'
然后layout布局文件中加入
<android.support.v7.widget.RecyclerView
android:id="@+id/activity_main_recycle_view"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
code中需要
//设置布局管理器,必须
mRecyclerView.setLayoutManager(layout);
//设置RecycleView的Adapter,必须
mRecyclerView.setAdapter(adapter)
//设置分割线,非必须
mRecyclerView.addItemDecoration(ItemDecoration);
//设置item的增删动画,非必须
mRecyclerView.setItemAnimator(animator);
现在先最简单创建一个列表
新建Item的布局recycleview_item,以TextView为根节点
<TextView xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/recycle_textview"
android:layout_width="match_parent"
android:layout_height="50dp"
android:gravity="center"
android:textSize="20sp"/>
新建一个RecyclerView.Adapter适配器TestRecycleViewAdapter
public class TestRecycleViewAdapter extends RecyclerView.Adapter<TestRecycleViewAdapter.ViewHolderA> {
private Context mContext;
private List<String> mList;
public TestRecycleViewAdapter(Context context, List<String> list) {
mContext = context;
mList = list;
}
@Override
public ViewHolderA onCreateViewHolder(ViewGroup parent, int viewType) {
//此处动态加载ViewHolder的布局文件并返回holder
View view = LayoutInflater.from(mContext).inflate(R.layout.recycleview_item, parent, false);
ViewHolderA holderA = new ViewHolderA(view);
return holderA;
}
@Override
public void onBindViewHolder(ViewHolderA holder, int position) {
//此处设置Item中view的数据
holder.mTextView.setText(mList.get(position));
}
@Override
public int getItemCount() {
//生成的item的数量
return mList.size();
}
//Item的ViewHolder以及item内部布局控件的id绑定
class ViewHolderA extends RecyclerView.ViewHolder{
TextView mTextView;
public ViewHolderA(View itemView) {
super(itemView);
mTextView = (TextView) itemView.findViewById(R.id.recycle_textview);
}
}
}
用Android Studio生成Adapter结构技巧
- 先新建一个类TestRecycleViewAdapter
- 继承自RecyclerView.Adapter<这里填ViewHolder名字的>,现在出现红线,先不管它
- 然后在TestRecycleViewAdapter 内部写内部类ViewHolderA 继承自 RecyclerView.ViewHolder,这个时候会自动生成构造函数
- 接着将ViewHolder的名字ViewHolderA填入第2步粗体处,注意这里是内部类所以正确填入是TestRecycleViewAdapter.ViewHolderA
- 接着点红线,然后IDE会自己生成所需的3个方法
Activity中代码是这样
public class MainActivity extends AppCompatActivity {
private List<String> list;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
RecyclerView mRecyclerView = (RecyclerView) findViewById(R.id.activity_main_recycle_view);
mRecyclerView.setLayoutManager(new LinearLayoutManager(this));
initData();
//实例化并传输数据给adapter
TestRecycleViewAdapter adapter = new TestRecycleViewAdapter(getApplicationContext(), list);
mRecyclerView.setAdapter(adapter);
}
/**
* 添加数据
* */
private void initData() {
list = new ArrayList<>();
for (int i = 0; i < 50; i++) {
list.add("item" + i);
}
}
}
这样子一个最基本的RecyclerView就写好了,效果图
可以看到默认没有Scrollbars,没有item之间的间隔线,没有item点击效果,实际上这些我们需要自定义(虽然有点麻烦)
四 高级用法
1 Scrollbars
- 只需要在RecycleView根节点加上
android:scrollbars="vertical"
默认为none,还有横向horizontal样式的
2 Item间分割线
- 可以给item设置margin,不过感觉好丑
只要在item的layout里加上
android:layout_marginTop="3dp"//只需要这一行
android:background="#cf1616"//显示成红色比较明显
- 另外就是高大上的ItemDecoration了,直接在code中加上
mRecyclerView.addItemDecoration(new DividerItemDecoration(this, DividerItemDecoration.VERTICAL));
这里的context要注意用Activity的Context,假如用了Application的Context会显示默认的样式,谢谢@且听风吟9527的提醒
数字1:启动Activity在这些类中是可以的,但是需要创建一个新的task,一般情况不推荐;
数字2:在这些类中去layout inflate是合法的,但是会使用系统默认的主题样式,如果你自定义了某些样式可能不会被使用;
数字3:在Receiver为null时允许,在4.2或以上的版本中,用于获取黏性广播的当前值。(可以无视);
ContentProvider、BroadcastReceiver之所以在上述表格中,是因为在其内部方法中都有一个context用于使用。
但是我们不能仅限于此,
默认实现类DividerItemDecoration类中源代码部分如下
public class DividerItemDecoration extends RecyclerView.ItemDecoration {
public static final int HORIZONTAL = LinearLayout.HORIZONTAL;
public static final int VERTICAL = LinearLayout.VERTICAL;
//关键在这里,看到有个属性定义成了listDivider
private static final int[] ATTRS = new int[]{ android.R.attr.listDivider };
.......
public DividerItemDecoration(Context context, int orientation) {
//这里调用了属性值listDivider
final TypedArray a = context.obtainStyledAttributes(ATTRS);
mDivider = a.getDrawable(0);
a.recycle();
setOrientation(orientation);
}
........
所以,自定义间隔线步骤如下:
在Style文件里加上name="android:listDivider"的item
<item name="android:listDivider">@drawable/divider_backgroud</item>
书写divider_bg.xml文件,shape文件为渐变xml
<shape xmlns:android="http://schemas.android.com/apk/res/android"
android:shape="rectangle">
<gradient
android:centerColor="#b3b35f"
android:endColor="#515187"
android:startColor="#b34747"
android:type="linear" />
<size android:height="5dp"/>
</shape>
这样一个自定义间隔线样式就好了
网络与瀑布流的间隔线个人水平暂时弄不好.......(搁置中、、、、QAQ)
3 Item显示方式
GridLayout
只需要将
mRecyclerView.setLayoutManager(layoutManager);
layoutManager设为
mRecyclerView.setLayoutManager(new GridLayoutManager(this, 5));
就可以实现5列的网格布局
我们看到网格样式看起来像流式的List,那是因为没有左右间隔线的问题(其实是水平不行),
左右间隔线弄不出来QAQ,现在只能在recycleview_item.xml里面增加属性做一个假的间隔线QAQ
android:layout_marginStart="1dp"
瀑布流
同上
mRecyclerView.setLayoutManager(new StaggeredGridLayoutManager(3,StaggeredGridLayoutManager.VERTICAL));
感觉上和网格布局没啥差别,因为这上面的item我们使用了固定的高度,我们可以在适配器的onBindViewHolder方法中随机设置item高度
- 先在adapter的里声明
private List<Integer> mHeight;
- 在构造方法里随机生成高度值
mHeight = new ArrayList<Integer>();
for (int i = 0; i < mList.size(); i++) {
mHeight.add((int) (80 + Math.random() * 300));
}
- 接着在onBindViewHolder方法里
ViewGroup.LayoutParams lp = holder.mTextView.getLayoutParams();
lp.height = mHeight.get(position);
类似的,不止有竖屏的效果,横屏的只要修改
mRecyclerView.setLayoutManager(new StaggeredGridLayoutManager(3, StaggeredGridLayoutManager.HORIZONTAL));
就可以快速实现类似的效果
4 自定义LayoutManager
请参考
RecyclerView自定义LayoutManager,打造不规则布局
另外
对LayoutManager的分析,创建一个 RecyclerView LayoutManager
5 RecycleView的点击事件
RecycleView并没有提供类似setOnItemClickListener()这样的注册监听器方法,而是需要我们自己给子项view注册响应事件
我们只需要在Adapter的onBindViewHolder方法里添加
public void onBindViewHolder(ViewHolderA holder, final int position) {
.....
.....
holder.mTextView.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
Toast.makeText(mContext, "item"+position,Toast.LENGTH_SHORT).show();
}
});
.....
}
这样就轻松实现了TextView的点击事件,同理,长按的类似如此
RecycleView的强大之处也在这里,就算是ViewHolder里的View多层嵌套了几个view都可以轻松的实现点击事件
6 高级效果 波纹点击
实现方法,在item布局文件根节点加上
android:foreground="?android:attr/selectableItemBackground"
7 添加 删除时动画
在adapter里新添加方法
public void addData(int position){
mList.add(position, "新增" + position);
//通知适配器item内容插入
notifyItemInserted(position);
}
public void RemoveData(int position){
mList.remove(position);
//通知适配器item内容删除
notifyItemRemoved(position);
}
然后在Activity里添加action栏菜单
@Override
public boolean onCreateOptionsMenu(Menu menu) {
getMenuInflater().inflate(R.menu.main, menu);
return super.onCreateOptionsMenu(menu);
}
@Override
public boolean onOptionsItemSelected(MenuItem item) {
switch (item.getItemId()){
case R.id.menu_add:
adapter.addData(1);
break;
case R.id.menu_remove:
adapter.RemoveData(1);
break;
}
return true;
}
menu文件
<menu xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto">
<item
android:id="@+id/menu_remove"
android:icon="@android:drawable/alert_light_frame"
android:title="remove"
app:showAsAction="ifRoom"/>
<item
android:id="@+id/menu_add"
android:icon="@android:drawable/ic_input_add"
android:orderInCategory="100"
android:title="add"
app:showAsAction="ifRoom"/>
</menu>
然后,这个是默认的动画,现在有很多开源库,具体可以Google
mRecyclerView.setItemAnimator(new DefaultItemAnimator());
8 与某些View结合使用
- 可以被SwipeRefreshLayout实现Android原生下拉刷新,也可以实现第三方下拉刷新
- item可以使用CardView,恩,超漂亮
9 滑动监听addOnScrollListener 可实现下拉刷新等
实现这个借口的俩个方法
- onScrollStateChanged
- onScrolled
mRecyclerView.addOnScrollListener(new RecyclerView.OnScrollListener() {
//标记当前是否向最后一项滑动
boolean isSlidingToLast = false;
@Override
public void onScrollStateChanged(RecyclerView recyclerView, int newState) {
super.onScrollStateChanged(recyclerView, newState);
//获取当前的LayoutManager
LinearLayoutManager manager = (LinearLayoutManager) recyclerView.getLayoutManager();
//当不滚动的时候
if (newState == RecyclerView.SCROLL_STATE_IDLE) {
//得到最后一个完全显示的item的position
int lastViusalItem = manager.findLastCompletelyVisibleItemPosition();
//总的ITemPosition
int totalItemCount = manager.getItemCount();
//当前是否向下滑,是否滚动到LastItem
if (lastViusalItem == (totalItemCount - 1) && isSlidingToLast) {
// 这里就是下拉加载更多功能的逻辑
//往item的List里添加数据,并通知适配器更新
adapter.addListData(lastViusalItem);
}
}
}
@Override
public void onScrolled(RecyclerView recyclerView, int dx, int dy) {
super.onScrolled(recyclerView, dx, dy);
//如果dy>0则当前向下滑state
if (dy > 0) {
isSlidingToLast = true;
} else if (dy < 0) {
isSlidingToLast = false;
}
}
});
adapter里添加
public void addListData(int position){
for (int i = 0; i <6; i++) {
mList.add("底部添加" + i);
}
//通知适配器item内容删除
notifyItemChanged(position);
}
这里的LayoutManager对象manager还可以获取到很多参数,比如
可以用tm来实现更多逻辑功能
10 ItemTouchHelper实现item删除,互相拉动
一个大神写的
Android实现RecyclerView侧滑删除和长按拖拽-ItemTouchHelper
,讲的很清楚,这里不再详解,贴上测试的代码,仅做记录
在setAdapter后面添加
ItemTouchHelper.Callback mCallback = new ItemTouchHelper.SimpleCallback(ItemTouchHelper.DOWN|ItemTouchHelper.UP, ItemTouchHelper.RIGHT) {
@Override
public boolean onMove(RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder, RecyclerView.ViewHolder target) {
int fromPosition = viewHolder.getAdapterPosition();//得到拖动ViewHolder的position
int toPosition = target.getAdapterPosition();//得到目标ViewHolder的position
if (fromPosition < toPosition){
// 向下
for (int i = fromPosition; i < toPosition; i++) {
Collections.swap(list, i, i+1);
}
}else {
for (int i = fromPosition; i < toPosition; i++) {
// 向上
Collections.swap(list, i, i-1);
}
}
mTestRecycleViewAdapterMulType.notifyItemMoved(fromPosition, toPosition);
//返回true表示执行拖动
return true;
}
@Override
public void onSwiped(RecyclerView.ViewHolder viewHolder, int direction) {
int position = viewHolder.getAdapterPosition();
list.remove(position);
mTestRecycleViewAdapterMulType.notifyItemRemoved(position);
}
};
ItemTouchHelper mItemTouchHelper = new ItemTouchHelper(mCallback);
mItemTouchHelper.attachToRecyclerView(mRecyclerView);
效果
五 RecycleView多种布局显示
先看效果
RecycleView.Adapter也提供了getItemViewType方法,此方法和ListView加载多布局一样。
这里需要注意的是这里的范型不再是自己写的ViewHolder
public class TestRecycleViewAdapterMulType extends RecyclerView.Adapter<RecyclerView.ViewHolder>
重写adapter的getItemViewType
public int getItemViewType(int position) {
if (position == 0) {
//111代表顶部item
return 111;
} else if (position == getItemCount() - 1) {
//111代表di部item
return 112;
}
//111代表中间item
return 110;
}
自定义3个ViewHolder,分别表示top ,bottom 和中间的item布局
/**
* 代表顶部item
*/
class ViewHolderA extends RecyclerView.ViewHolder {
ImageView mImageViewA;
public ViewHolderA(View itemView) {
super(itemView);
mImageViewA = (ImageView) itemView.findViewById(R.id.top_imageview);
}
}
/**
* 代表di部item
*/
class ViewHolderB extends RecyclerView.ViewHolder {
ImageView mImageViewB;
public ViewHolderB(View itemView) {
super(itemView);
mImageViewB = (ImageView) itemView.findViewById(R.id.bottom_imageview);
}
}
/**
* 代表中间item
*/
class ViewHolderC extends RecyclerView.ViewHolder {
TextView mTextView;
public ViewHolderC(View itemView) {
super(itemView);
mTextView = (TextView) itemView.findViewById(R.id.recycle_textview);
}
}
在onCreateViewHolder方法里
@Override
public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
View view = null;
RecyclerView.ViewHolder holder = null;
//此处动态加载ViewHolder的布局文件并返回holder
switch (viewType) {
case 111:
//111代表顶部item
view = LayoutInflater.from(mContext).inflate(R.layout.top, parent, false);
holder = new ViewHolderA(view);
break;
case 112:
//112代表顶部item
view = LayoutInflater.from(mContext).inflate(R.layout.bottom, parent, false);
holder = new ViewHolderB(view);
break;
case 110:
//112代表中间item
view = LayoutInflater.from(mContext).inflate(R.layout.recycleview_item, parent, false);
holder = new ViewHolderC(view);
break;
}
return holder;
}
最后是onBindViewHolder,在这里分别设置不同布局item数据
@Override
public void onBindViewHolder(RecyclerView.ViewHolder holder, final int position) {
// //这样写也行
// if(holder instanceof ViewHolderA){
// ViewHolderA holderA = (ViewHolderA) holder;
// holderA.mImageViewA.setImageResource(R.mipmap.ic_launcher);
// }else if(holder instanceof ViewHolderB).....
// .....
switch (getItemViewType(position)) {
case 111:
ViewHolderA holderA = (ViewHolderA) holder;
holderA.mImageViewA.setImageResource(R.mipmap.ic_launcher);
break;
case 112:
ViewHolderB holderB = (ViewHolderB) holder;
holderB.mImageViewB.setImageResource(R.mipmap.ic_launcher);
break;
case 110:
ViewHolderC holderC = (ViewHolderC) holder;
holderC.mTextView.setText(mList.get(position));
break;
}
}
贴一下完整Adapter代码
**
* Created by NIWA on 2017/3/9.
*/
public class TestRecycleViewAdapterMulType extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
private Context mContext;
private List<String> mList;
public TestRecycleViewAdapterMulType(Context context, List<String> list) {
mContext = context;
mList = list;
}
@Override
public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
View view = null;
RecyclerView.ViewHolder holder = null;
//此处动态加载ViewHolder的布局文件并返回holder
switch (viewType) {
case 111:
//111代表顶部item
view = LayoutInflater.from(mContext).inflate(R.layout.top, parent, false);
holder = new ViewHolderA(view);
break;
case 112:
//112代表顶部item
view = LayoutInflater.from(mContext).inflate(R.layout.bottom, parent, false);
holder = new ViewHolderB(view);
break;
case 110:
//112代表中间item
view = LayoutInflater.from(mContext).inflate(R.layout.recycleview_item, parent, false);
holder = new ViewHolderC(view);
break;
}
return holder;
}
@Override
public void onBindViewHolder(RecyclerView.ViewHolder holder, final int position) {
// //这样写也行
// if(holder instanceof ViewHolderA){
// ViewHolderA holderA = (ViewHolderA) holder;
// holderA.mImageViewA.setImageResource(R.mipmap.ic_launcher);
// }else if(holder instanceof ViewHolderB).....
// .....
switch (getItemViewType(position)) {
case 111:
ViewHolderA holderA = (ViewHolderA) holder;
holderA.mImageViewA.setImageResource(R.mipmap.ic_launcher);
break;
case 112:
ViewHolderB holderB = (ViewHolderB) holder;
holderB.mImageViewB.setImageResource(R.mipmap.ic_launcher);
break;
case 110:
ViewHolderC holderC = (ViewHolderC) holder;
holderC.mTextView.setText(mList.get(position));
break;
}
}
@Override
public int getItemCount() {
//生成的item的数量
return mList.size();
}
/**
* 代表顶部item
*/
class ViewHolderA extends RecyclerView.ViewHolder {
ImageView mImageViewA;
public ViewHolderA(View itemView) {
super(itemView);
mImageViewA = (ImageView) itemView.findViewById(R.id.top_imageview);
}
}
/**
* 代表di部item
*/
class ViewHolderB extends RecyclerView.ViewHolder {
ImageView mImageViewB;
public ViewHolderB(View itemView) {
super(itemView);
mImageViewB = (ImageView) itemView.findViewById(R.id.bottom_imageview);
}
}
/**
* 代表中间item
*/
class ViewHolderC extends RecyclerView.ViewHolder {
TextView mTextView;
public ViewHolderC(View itemView) {
super(itemView);
mTextView = (TextView) itemView.findViewById(R.id.recycle_textview);
}
}
@Override
public int getItemViewType(int position) {
if (position == 0) {
//111代表顶部item
return 111;
} else if (position == getItemCount() - 1) {
//因为item是从0开始,所以最后一项应该是getItemCount() - 1
//111代表di部item
return 112;
}
//111代表中间item
return 110;
}
}
最后在Activity里
mTestRecycleViewAdapterMulType = new TestRecycleViewAdapterMulType(getApplicationContext(), list);
mRecyclerView.setAdapter(mTestRecycleViewAdapterMulType);
heiheihei
六 注意
- 刷新数据的几个方法
notifyItemInserted();
notifyItemRangeInserted();
notifyItemChanged();
notifyItemRangeChanged();
notifyItemRemoved();
notifyItemRangeRemoved();
七 开源库
1. XRecyclerView
据我所知,支付宝用了这个库,比较轻量级别
- 用法和原生RecycleView一样
- 封装好了下拉刷新,上拉加载,刷新动画
- 增加头部,甚至增加俩个headerView
2.BaseRecyclerViewAdapterHelper
用了之后你才发现RecyclerView的Adapter也可以写的这么优雅,功能很全,ListView时代的感觉。
当然一切开源库,不要过度依赖开源库,一切都要建立在踏实的基础上,以上多加练习。
The End