Android 组件化——SXRecyclerView,android 实现选择题模式
@Override
public?boolean?isEnable(int?position)?{
if?(getItemViewType(position)?==?TYPE_TITLE){
return?false;
}
return?true;
}
原生 RecyclerView 没有该方法,此方法是 SXRecyclerView 添加的。此方法返回 false 就代表对应位置的 ItemView 不启用 SXRecyclerView 相关功能,也就是说不响应点击事件、长按事件、触摸反馈、多选功能等。该方法默认返回 true。示意图:[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-Bwtb05cn-1571054129566)(https://upload-images.jianshu.io/upload_images/15679108-efb2e91234227fef?imageMogr2/auto-orient/strip)]
click
[](
)多选功能
要使用多选功能,有两个必要的步骤:1、设置多选模式,多选模式如下:
CHOICE_MODE_NONE?:不启动多选功能。默认值为这种。
CHOICE_MODE_MULTIPLE?:主动触发启动多选功能。触发方式有长按和主动调用
startMultiChoice()
方法两种触发方式。
2、设置选择模式监听器,并根据需求实现相关的方法与 ActionMode 进行交互。代码如下:
//设置选择模式为多选模式
mRecyclerView.setChoiceMode(SXRecyclerView.CHOICE_MODE_MULTIPLE);
//设置多选模式监听器
mRecyclerView.setMultiChoiceModeListener(new SXRecyclerView.MultiChoiceModeListener() {
@Override
public void onItemCheckedStateChanged(ActionMode mode, int position, long id, boolean checked) {
}
@Override
public boolean onCreateActionMode(ActionMode mode, Menu menu) {
return true;
}
@Override
public boolean onPrepareActionMode(ActionMode mode, Menu menu) {
return true;
}
@Override
public boolean onActionItemClicked(ActionMode mode, MenuItem item) {
return true;
}
@Override
public void onDestroyActionMode(ActionMode mode) {
}
});
这里的多选模式是与 ActionMode 进行绑定交互的,具体的实现可以参考下 demo。默认情况下,所有的 ItemView 都是可以被选中的。如果要让某些项不可选中,除了前文提到的重写 Adaper 中的isEnable(int position)
方法让对应位置的 ItemView 失效。还可以通过 Adapter 的另外一个方法来设置:
//返回 false 的数据项不可被选中
@Override
public?boolean?isSelectable(int?position)?{
if?(position?%?5?==?0)?{
return?false;
}
return?true;
}
不同于isEnable(int position)
方法,isSelectable(int position)
方法只作用于多选功能,返回 false 的 ItemView 只是不能被选中,包括点击、长按事件在内的其他功能都能响应。一般使用多选功能都会在选中 ItemView 的时候对相应的 ItemView 进行标记,比如打个勾之类的操作。为了更简单直接地实现选中标记操作,SXRecyclerView 提供了一种实现方式,就是对 ViewHolder 实现Checkable
接口,这样在选中状态发生改变时,setChecked(boolean checked)
方法都会被调用,我们就可以在该方法中对 ItemView 为所欲为了。
//?实现 Checkable 接口,可以简单直接地实现多选标记功能
class?MyViewHolder?extends?RecyclerView.ViewHolder?implements?Checkable?{
TextView?mTextView;
ImageView?mImageView;
public?MyViewHolder(View?itemView)?{
super(itemView);
mTextView?=?(TextView)?itemView.findViewById(R.id.item_tv);
mImageView?=?(ImageView)?itemView.findViewById(R.id.img_check);
}
//此 ItemView 选中状态发生改变时该方法会回调
@Override
public?void?setChecked(boolean?checked)?{
if?(checked)?{
mImageView.setVisibility(View.VISIBLE);
}?else?{
mImageView.setVisibility(View.GONE);
}
}
@Override
public?boolean?isChecked()?{
return?false;
}
@Override
public?void?toggle()?{
}
}
**tip :**多选功能的相关方法如下:
public boolean startMultiChoice()
:进入多选状态public void finishMultiChoice()
:退出多选状态public Boolean isInMutiChoiceState()
:判断 SXRecyclerview 是否处于多选状态public void setItemChecked(int position, boolean value)
:设置某项的选中状态public void clearChoices()
:清除所有的选中状态public long[] getCheckedItemIds()
:获取当前选中的项的 id 集合public List<integer style="margin: 0px; padding: 0px; max-width: 100%; box-sizing: border-box !important; word-wrap: break-word !important; font-size: inherit; color: inherit; line-height: inherit;">getCheckedItemPositions()</integer>
:获取当前选中的项的 position 集合public boolean isItemChecked(int position)
:判断某项是否选中public int getCheckedItemCount()
:获取选中项总数public void checkedAll()
:全选public void unCheckedAll()
:全不选
示意图:[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-rl5sXIC3-1571054129567)(https://upload-images.jianshu.io/upload_images/15679108-cb339145e4fd4608?imageMogr2/auto-orient/strip)]
multichoice
[](
)PinnedHeader
PinnedHeader 是指对 ViewHolder 进行分组,每个组都有一个 Header,在滑动过程中,处于顶部的组的 Header 都会悬浮在 SXRecyclerView 顶部不会滑出屏幕,直到下一个 Header 滑到 SXRecyclerView 顶部位置时才会将上一个 Header 顶出屏幕。实现 PinnedHeader 效果,有 2 个必要的步骤:1、需要在其 Adapter 中实现以下接口
public?interface?RecyclerPinnedHeaderAdapter<VH?extends?MzRecyclerView.ViewHolder>?{
//?返回 PinnedHeader?的编号 id
//?通过 id 来对 ViewHolder 进行分组,相同 id 的 viewHolder 会分到同一组,对应相同的 PinnedHeader
//?返回?负数?的时候,表示该?PinnedHeader?不显示
long?getHeaderId(int?position);
//?创建?PinnedHeader 的样式
VH?onCreateHeaderViewHolder(ViewGroup?parent);
//?绑定?PinnedHeader 的数据
void?onBindHeaderViewHolder(VH?holder,?int?position);
int?getItemCount();
}
2、以实现了 RecyclerPinnedHeaderAdapter 的 Adapter 对象为参数,创建 RecyclerPinnedHeaderDecoration 对象,并通过 addItemDecoration 添加到 SXRecyclerView 中,这时已经可以显示 PinnedHeader 了。
//创建 RecyclerPinnedHeaderDecoration
RecyclerPinnedHeaderDecoration?headersDecor?=?new?RecyclerPinnedHeaderDecoration(adapter);
//将创建 RecyclerPinnedHeaderDecoration 作为一个 ItemDecoration 添加到 Recyclerview 中,从而实现将 PinnedHeader 绘制到 SXRecyclerview 中
mRecyclerView.addItemDecoration(headersDecor); </pre>
RecyclerPinnedHeaderDecoration 提供了 PinnedHeader 监听器,悬浮在顶部的 PinnedHeader 发生改变(被顶出屏幕或者屏幕外有新的 PinnedHeader 进来)时触发监听器回调,通过此监听器可以对悬浮头添加一些标识或者做一些动画效果。示例代码如下:
<pre style="margin: 0px; padding: 0px; max-width: 100%; box-sizing: border-box !important; word-wrap: break-word !important; color: inherit; font-size: inherit; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: 2; text-align: justify; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255); line-height: inherit;">//可以通过对 RecyclerPinnedHeaderDecoration 设置监听器,来实现对切换 PinnedHeader 的监听
headersDecor.setP
innedHeaderListener(new?RecyclerPinnedHeaderDecoration.OnPinnedHeaderChangeListener()?{
@Override
public?void?OnPinnedHeaderChange(RecyclerView?recyclerView,?View?currentHeader,?int?currentPosition,?long?currentHeaderId,?View?lastHeader,?int?lastPosition,?long?lastHeaderId)?{
//do?something
}
});
评论