Android RecyclerView的Item点击事件实现整理
自从开始使用RecyclerView代替ListView，会发现有很多地方需要学习。前一段时间的学习记录有：
RecyclerView的滚动事件研究-DevWiki
RecyclerView的ViewHolder和Adapter的封装优化-DevWiki
RecyclerView问题记录-DevWiki
实现RecyclerView的Item的点击事件有三种方式：
- 在创建ItemView时添加点击监听
- 当ItemViewattachRecyclerView时实现
- 通过RecyclerView已有的方法addOnItemTouchListener()实现
1.在创建ItemView时添加点击监听
思路是：因为ViewHolder我们可以拿到每个Item的根布局，所以如果我们为根布局设置单独的OnClick监听并将其开放给Adapter，那不就可以在组装RecyclerView时就能够设置ItemClickListener，只不过这个Listener不是设置到RecyclerView上而是设置到Adapter。具体实现代码如下：
publicclassSampleAdapterextendsRecyclerView.Adapter<SampleAdapter.SampleViewHolder>{
privateList<DataBean>mDatas;
privateOnItemClickListenermListener;//Item点击事件
publicDataBeangetItem(intposition){
returnmDatas==null?null:mDatas.get(position);
}
@Override
publicSampleViewHolderonCreateViewHolder(ViewGroupparent,intviewType){
ViewitemView=LayoutInflater.from(parent.getContext()).inflate(R.layout.item,parent,false);
returnnewSampleViewHolder(itemView);
}
@Override
publicvoidonBindViewHolder(SampleViewHolderholder,intposition){
}
@Override
publicintgetItemCount(){
returnmDatas==null?0:mDatas.size();
}
classSampleViewHolderextendsRecyclerView.ViewHolderimplementsView.OnClickListener,View.OnLongClickListener{
publicSampleViewHolder(ViewitemView){
super(itemView);
//TODO:初始化View
...
itemView.setOnClickListener(this);
itemView.setOnLongClickListener(this);
}
@Override
publicvoidonClick(Viewv){
if(mListener!=null){
mListener.onItemClick(SampleAdapter.this,v,getLayoutPosition());
}
}
@Override
publicbooleanonLongClick(Viewv){
if(mListener!=null){
mListener.onItemLongClick(SampleAdapter.this,v,getLayoutPosition());
returntrue;
}
returnfalse;
}
}
}
2.当ItemViewattachRecyclerView时实现
该实现方法是在阅读国外的一篇博客时发现的,原文链接如下：GettingyourclicksonRecyclerView
实现的代码如下：
publicclassItemClickSupport{
privatestaticfinalintKEY=0x99999999;
privatefinalRecyclerViewmRecyclerView;
privateOnItemClickListenermOnItemClickListener;
privateOnItemLongClickListenermOnItemLongClickListener;
privateView.OnClickListenermOnClickListener=newView.OnClickListener(){
@Override
publicvoidonClick(Viewv){
if(mOnItemClickListener!=null){
RecyclerView.ViewHolderholder=mRecyclerView.getChildViewHolder(v);
mOnItemClickListener.onItemClicked(mRecyclerView,v,holder.getAdapterPosition());
}
}
};
privateView.OnLongClickListenermOnLongClickListener=newView.OnLongClickListener(){
@Override
publicbooleanonLongClick(Viewv){
if(mOnItemLongClickListener!=null){
RecyclerView.ViewHolderholder=mRecyclerView.getChildViewHolder(v);
returnmOnItemLongClickListener.onItemLongClicked(mRecyclerView,v,holder.getAdapterPosition());
}
returnfalse;
}
};
privateRecyclerView.OnChildAttachStateChangeListenermAttachListener=newRecyclerView.OnChildAttachStateChangeListener(){
@Override
publicvoidonChildViewAttachedToWindow(Viewview){
if(mOnItemClickListener!=null){
view.setOnClickListener(mOnClickListener);
}
if(mOnItemLongClickListener!=null){
view.setOnLongClickListener(mOnLongClickListener);
}
}
@Override
publicvoidonChildViewDetachedFromWindow(Viewview){
}
};
/**
*ItemClickSupport的私有构造方法
*/
privateItemClickSupport(RecyclerViewrecyclerView){
mRecyclerView=recyclerView;
mRecyclerView.setTag(KEY,this);
//为RecyclerView设置OnChildAttachStateChangeListener事件监听
mRecyclerView.addOnChildAttachStateChangeListener(mAttachListener);
}
/**
*为RecyclerView设置ItemClickSupport
*/
publicstaticItemClickSupportaddTo(RecyclerViewview){
ItemClickSupportsupport=(ItemClickSupport)view.getTag(KEY);
if(support==null){
support=newItemClickSupport(view);
}
returnsupport;
}
/**
*为RecyclerView移除ItemClickSupport
*/
publicstaticItemClickSupportremoveFrom(RecyclerViewview){
ItemClickSupportsupport=(ItemClickSupport)view.getTag(KEY);
if(support!=null){
support.detach(view);
}
returnsupport;
}
/**
*为RecyclerView设置点击事件监听
*/
publicItemClickSupportsetOnItemClickListener(OnItemClickListenerlistener){
mOnItemClickListener=listener;
returnthis;
}
/**
*为RecyclerView设置长按事件监听
*/
publicItemClickSupportsetOnItemLongClickListener(OnItemLongClickListenerlistener){
mOnItemLongClickListener=listener;
returnthis;
}
/**
*为RecyclerView移除OnChildAttachStateChangeListener事件监听
*/
privatevoiddetach(RecyclerViewview){
view.removeOnChildAttachStateChangeListener(mAttachListener);
view.setTag(KEY,null);
}
/**
*RecyclerView的点击事件监听接口
*/
publicinterfaceOnItemClickListener{
voidonItemClicked(RecyclerViewrecyclerView,ViewitemView,intposition);
}
/**
*RecyclerView的长按事件监听接口
*/
publicinterfaceOnItemLongClickListener{
booleanonItemLongClicked(RecyclerViewrecyclerView,ViewitemView,intposition);
}
}
上面的代码中给RecyclerView设置了OnChildAttachStateChangeListener事件监听，当子ViewattachRecyclerView时设置事件监听。
privateRecyclerView.OnChildAttachStateChangeListenermAttachListener=newRecyclerView.OnChildAttachStateChangeListener(){
@Override
publicvoidonChildViewAttachedToWindow(Viewview){
if(mOnItemClickListener!=null){
view.setOnClickListener(mOnClickListener);
}
if(mOnItemLongClickListener!=null){
view.setOnLongClickListener(mOnLongClickListener);
}
}
@Override
publicvoidonChildViewDetachedFromWindow(Viewview){}
};
使用时只需要调用addTo(RecycleViewview)方法得到ItemClickSupport对象，然后调用setOnItemClickListener()方法和setOnItemLongClickListener()方法设置ItemView的点击事件和长按事件监听即可。
3.通过RecyclerView已有的方法addOnItemTouchListener()实现
3.1、查看源码
查看RecyclerView源码可以看到,RecyclerView预留了一个Item的触摸事件方法：
/**
*Addan{@linkOnItemTouchListener}tointercepttoucheventsbeforetheyaredispatched
*tochildviewsorthisview'sstandardscrollingbehavior.
*
*<p>Clientcodemayuselistenerstoimplementitemmanipulationbehavior.Oncealistener
*returnstruefrom
*{@linkOnItemTouchListener#onInterceptTouchEvent(RecyclerView,MotionEvent)}its
*{@linkOnItemTouchListener#onTouchEvent(RecyclerView,MotionEvent)}methodwillbecalled
*foreachincomingMotionEventuntiltheendofthegesture.</p>
*
*@paramlistenerListenertoadd
*@seeSimpleOnItemTouchListener
*/
publicvoidaddOnItemTouchListener(OnItemTouchListenerlistener){
mOnItemTouchListeners.add(listener);
}
通过注释我们可知,此方法是在滚动事件之前调用，需要传入一个OnItemTouchListener对象。OnItemTouchListener的代码如下：
publicstaticinterfaceOnItemTouchListener{
publicbooleanonInterceptTouchEvent(RecyclerViewrv,MotionEvente);
publicvoidonTouchEvent(RecyclerViewrv,MotionEvente);
publicvoidonRequestDisallowInterceptTouchEvent(booleandisallowIntercept);
}
此接口还提供了一个实现类，且官方推荐使用该实现类SimpleOnItemTouchListener：
/**
*Animplementationof{@linkRecyclerView.OnItemTouchListener}thathasemptymethodbodiesand
*defaultreturnvalues.
*
*Youmayprefertoextendthisclassifyoudon'tneedtooverrideallmethods.Another
*benefitofusingthisclassisfuturecompatibility.Astheinterfacemaychange,we'll
*alwaysprovideadefaultimplementationonthisclasssothatyourcodewon'tbreakwhen
*youupdatetoanewversionofthesupportlibrary.
*/
publicstaticclassSimpleOnItemTouchListenerimplementsRecyclerView.OnItemTouchListener{
<spanstyle="font-family:'MicrosoftYaHei';">
</span>@Override
publicbooleanonInterceptTouchEvent(RecyclerViewrv,MotionEvente){
returnfalse;
}
@Override
publicvoidonTouchEvent(RecyclerViewrv,MotionEvente){
}
@Override
publicvoidonRequestDisallowInterceptTouchEvent(booleandisallowIntercept){
}
}
在触摸接口中，当触摸时会回调一个MotionEvent对象，通过使用GestureDetectorCompat来解析用户的操作。
3.2、了解GestureDetector的工作原理
对于触摸屏，其原生的消息无非按下、抬起、移动这几种，我们只需要简单重载onTouch或者设置触摸侦听器setOnTouchListener即可进行处理。不过，为了提高我们的APP的用户体验，有时候我们需要识别用户的手势，Android给我们提供的手势识别工具GestureDetector就可以帮上大忙了。
GestureDetector的工作原理是，当我们接收到用户触摸消息时，将这个消息交给GestureDetector去加工，我们通过设置侦听器获得GestureDetector处理后的手势。
GestureDetector提供了两个侦听器接口，OnGestureListener处理单击类消息，OnDoubleTapListener处理双击类消息。
OnGestureListener的接口有这几个：
//单击，触摸屏按下时立刻触发 abstractbooleanonDown(MotionEvente); //抬起，手指离开触摸屏时触发(长按、滚动、滑动时，不会触发这个手势) abstractbooleanonSingleTapUp(MotionEvente); //短按，触摸屏按下后片刻后抬起，会触发这个手势，如果迅速抬起则不会 abstractvoidonShowPress(MotionEvente); //长按，触摸屏按下后既不抬起也不移动，过一段时间后触发 abstractvoidonLongPress(MotionEvente); //滚动，触摸屏按下后移动 abstractbooleanonScroll(MotionEvente1,MotionEvente2,floatdistanceX,floatdistanceY); //滑动，触摸屏按下后快速移动并抬起，会先触发滚动手势，跟着触发一个滑动手势 abstractbooleanonFling(MotionEvente1,MotionEvente2,floatvelocityX,floatvelocityY); OnDoubleTapListener的接口有这几个：
//双击，手指在触摸屏上迅速点击第二下时触发 abstractbooleanonDoubleTap(MotionEvente); //双击的按下跟抬起各触发一次 abstractbooleanonDoubleTapEvent(MotionEvente); //单击确认，即很快的按下并抬起，但并不连续点击第二下 abstractbooleanonSingleTapConfirmed(MotionEvente);
有时候我们并不需要处理上面所有手势，方便起见，Android提供了另外一个类SimpleOnGestureListener实现了如上接口，我们只需要继承SimpleOnGestureListener然后重载需要的手势即可。
3.3、实现点击事件监听
了解了GestureDetector的工作原理之后，便开始实现RecycleView的Item的点击事件。首先写一个SimpleRecycleViewItemClickListener类继承SimpleOnItemTouchListener，构造时传入Item点击回调OnItemClickListener，并覆写父类的booleanonInterceptTouchEvent(RecyclerViewrv,MotionEvente)方法，具体代码如下：
/**
*RecyclerView的Item点击事件监听
*
*@authorliyunlong
*@date2016/11/219:42
*/
publicclassSimpleRecycleViewItemClickListenerextendsRecyclerView.SimpleOnItemTouchListener{
privateOnItemClickListenermListener;
privateGestureDetectorCompatmGestureDetector;
publicSimpleRecycleViewItemClickListener(OnItemClickListenerlistener){
this.mListener=listener;
}
@Override
publicbooleanonInterceptTouchEvent(RecyclerViewrv,MotionEvente){
if(mGestureDetector==null){
initGestureDetector(rv);
}
if(mGestureDetector.onTouchEvent(e)){//把事件交给GestureDetector处理
returntrue;
}else{
returnfalse;
}
}
/**
*初始化GestureDetector
*/
privatevoidinitGestureDetector(finalRecyclerViewrecyclerView){
mGestureDetector=newGestureDetectorCompat(recyclerView.getContext(),newGestureDetector.SimpleOnGestureListener(){//这里选择SimpleOnGestureListener实现类，可以根据需要选择重写的方法
/**
*单击事件
*/
@Override
publicbooleanonSingleTapUp(MotionEvente){
ViewchildView=recyclerView.findChildViewUnder(e.getX(),e.getY());
if(childView!=null&&mListener!=null){
mListener.onItemClick(childView,recyclerView.getChildLayoutPosition(childView));
returntrue;
}
returnfalse;
}
/**
*长按事件
*/
@Override
publicvoidonLongPress(MotionEvente){
ViewchildView=recyclerView.findChildViewUnder(e.getX(),e.getY());
if(childView!=null&&mListener!=null){
mListener.onItemLongClick(childView,recyclerView.getChildLayoutPosition(childView));
}
}
/**
*双击事件
*/
@Override
publicbooleanonDoubleTapEvent(MotionEvente){
intaction=e.getAction();
if(action==MotionEvent.ACTION_UP){
ViewchildView=recyclerView.findChildViewUnder(e.getX(),e.getY());
if(childView!=null&&mListener!=null){
mListener.onItemDoubleClick(childView,recyclerView.getChildLayoutPosition(childView));
returntrue;
}
}
returnfalse;
}
});
}
/**
*RecyclerView的Item点击事件监听接口
*
*@authorliyunlong
*@date2016/11/219:43
*/
publicinterfaceOnItemClickListener{
/**
*当ItemView的单击事件触发时调用
*/
voidonItemClick(Viewview,intposition);
/**
*当ItemView的长按事件触发时调用
*/
voidonItemLongClick(Viewview,intposition);
/**
*当ItemView的双击事件触发时调用
*/
voidonItemDoubleClick(Viewview,intposition);
}
/**
*RecyclerView的Item点击事件监听实现
*
*@authorliyunlong
*@date2016/11/2110:05
*/
publicclassSimpleOnItemClickListenerimplementsOnItemClickListener{
@Override
publicvoidonItemClick(Viewview,intposition){
}
@Override
publicvoidonItemLongClick(Viewview,intposition){
}
@Override
publicvoidonItemDoubleClick(Viewview,intposition){
}
}
}
在GestureDetectorCompat的手势回调中我们覆写：
- booleanonSingleTapUp(MotionEvente)：单击事件回调
- voidonLongPress(MotionEvente)：长按事件回调
- booleanonDoubleTapEvent(MotionEvente)：双击事件回调
如果我们只需要监听单击事件，而不需要监听长按事件和双击事件，构造SimpleRecycleViewItemClickListener时只需要传入SimpleOnItemClickListener即可，如果需要处理其它的手势监听，也可以覆写对应的手势回调方法。
4.三种方法对比
以上三种方式分别是：
- 在创建ItemView时添加点击监听
- 当ItemViewattachRecyclerView时实现
- 通过RecyclerView已有的方法addOnItemTouchListener()实现
从以上三种方式的实现过程可知:
三种均可实现ItemView的点击事件和长按事件的监听。
第一种和第二种方式可以很方便对ItemView中的子View进行监听。
第三种方式可以很方便获取用户点击的坐标。
第二种方式和第三种方式可以写在单独的类中，相对于第一种写在Adapter的方式可使代码更独立整洁。
综上所述:
如果你只想监听ItemView的点击事件或长按事件，三种方式均可。
如果你想监听ItemView中每个子View的点击事件，采用第一种或者第二种比较方便。
感谢阅读，希望能帮助到大家，谢谢大家对本站的支持！