RecyclerView利用ItemDecoration实现头部悬停效果【类似微信通讯录效果】

本文主要是介绍RecyclerView利用ItemDecoration实现头部悬停效果【类似微信通讯录效果】,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

对于RecyclerView的ItemDecoration相信大家都不会陌生,因为RecyclerView并不像ListView那样自带分割线,所以我们需要继承ItemDecoration去手动绘制分割线。本篇文章主要是利用ItemDecoration的特性来绘制实现悬浮效果,就像微信中的通讯录一样,只不过微信的通讯录没有悬停而已。

没有效果图,光bb是不具有说服力的,下面我们来看下效果图
这里写图片描述

ItemDecoration中的几个关键方法介绍

(1)getItemOffsets()

(2)onDraw()

(3)onDrawOver()

说明:在解释上面的几个重要的方法之前,我们先来看一张图
这里写图片描述
这里非常感谢Piasy大牛提供的图片,原文地址:https://blog.piasy.com/2016/03/26/Insight-Android-RecyclerView-ItemDecoration/?utm_source=tuicool&utm_medium=referral

由上面的效果图可以看出来,通过设置RecyclerView的item的不同方向的padding值,可以让我们的item空出不同方向的距离,我们就可以利用空出的距离来绘制我们的悬浮栏了。为什么说是padding值呢?我们大体说一下,查看官方DividerItemDecoration源码,不能翻墙了,借用上图作者文章中的一段代码

@Overridepublic void getItemOffsets(Rect outRect, int itemPosition, RecyclerView parent) {if (mOrientation == VERTICAL_LIST) {outRect.set(0, 0, 0, mDivider.getIntrinsicHeight());} else {outRect.set(0, 0, mDivider.getIntrinsicWidth(), 0);}}

我们看到了,以其中一种情况分析,当我们的item是垂直排列的时候,outRect.set(0, 0, 0, mDivider.getIntrinsicHeight());下方空出来的是mDivider.getIntrinsicHeight()高度的距离。在RecyclerView源代码中找到调用getItemOffsets()的方法,即:getItemDecorInsetsForChild(View child)方法

Rect getItemDecorInsetsForChild(View child) {final LayoutParams lp = (LayoutParams) child.getLayoutParams();if (!lp.mInsetsDirty) {return lp.mDecorInsets;}if (mState.isPreLayout() && (lp.isItemChanged() || lp.isViewInvalid())) {// changed/invalid items should not be updated until they are rebound.return lp.mDecorInsets;}final Rect insets = lp.mDecorInsets;insets.set(0, 0, 0, 0);final int decorCount = mItemDecorations.size();for (int i = 0; i < decorCount; i++) {mTempRect.set(0, 0, 0, 0);mItemDecorations.get(i).getItemOffsets(mTempRect, child, this, mState);insets.left += mTempRect.left;insets.top += mTempRect.top;insets.right += mTempRect.right;insets.bottom += mTempRect.bottom;}lp.mInsetsDirty = false;return insets;}

我们看到,outRect.set(left, top, right, bottom)的值放到了Rect对象的insets 变量中,然后我们再继续查找这个insets,如何查找,我们需要看看谁调用了 getItemDecorInsetsForChild(View child) 方法。在RecyclerView源码中继续搜索,定位到measureChild(View child, int widthUsed, int heightUsed)方法

/*** Measure a child view using standard measurement policy, taking the padding* of the parent RecyclerView and any added item decorations into account.** <p>If the RecyclerView can be scrolled in either dimension the caller may* pass 0 as the widthUsed or heightUsed parameters as they will be irrelevant.</p>** @param child Child view to measure* @param widthUsed Width in pixels currently consumed by other views, if relevant* @param heightUsed Height in pixels currently consumed by other views, if relevant*/public void measureChild(View child, int widthUsed, int heightUsed) {final LayoutParams lp = (LayoutParams) child.getLayoutParams();final Rect insets = mRecyclerView.getItemDecorInsetsForChild(child);widthUsed += insets.left + insets.right;heightUsed += insets.top + insets.bottom;final int widthSpec = getChildMeasureSpec(getWidth(), getWidthMode(),getPaddingLeft() + getPaddingRight() + widthUsed, lp.width,canScrollHorizontally());final int heightSpec = getChildMeasureSpec(getHeight(), getHeightMode(),getPaddingTop() + getPaddingBottom() + heightUsed, lp.height,canScrollVertically());if (shouldMeasureChild(child, widthSpec, heightSpec, lp)) {child.measure(widthSpec, heightSpec);}}

现在就清晰了,在测量子item的宽高时,原来存到insets中的left、right、top、bottom分别加到了对应的padding值中去了,getChildMeasureSpec(getWidth(), getWidthMode(),getPaddingLeft() +getPaddingRight() + widthUsed, lp.width,canScrollHorizontally());

说了这么多就是为了分析getItemOffsets()方法的作用,就是通过设置RecyclerView的item的上下左右padding值,来预留出空间,通过上面的图片加之源码的分析,我们理解起来就更加容易了。

既然已经预留了item的paddingTop的距离了,那么我们就需要用到第二个方法onDraw()去绘制我们要显示的内容。由效果图可以看出我们要绘制的就是一个矩形条以及文字,所以接下来的工作就又回归到我们熟悉的自定义view上面了。首先我们要先new出来画笔,getItemOffsets()方法中具体该预留多高的空间?其实就是矩形条的高度,分析完了,接下来看这两个方法中的代码逻辑

@Overridepublic void getItemOffsets(Rect outRect, View view, RecyclerView parent, RecyclerView.State state) {super.getItemOffsets(outRect, view, parent, state);//通过查看源码可知道获取position的方法int position = ((RecyclerView.LayoutParams)view.getLayoutParams()).getViewLayoutPosition();if(position > -1){if(position == 0){//默认第一个位置,肯定是要设置悬浮栏的,这里只需要上边top留出空间即可outRect.set(0, titleHeight, 0, 0);//里面参数表示:左上右下的内边距padding距离}else{//继续分情况判断,当滑动到某一个item时(position位置)得到tag标签,与上一个item对应的标签不一致( position-1 位置),说明这是下一分组了if(lists.get(position).getTag() != null && !lists.get(position).getTag().equals(lists.get(position-1).getTag())){//说明这是下一组了,需要留出空间好去绘制悬浮栏用outRect.set(0, titleHeight, 0, 0);}else{//标签相同说明是同一组的数据,比如都是 A 组下面的数据,那么就不需要再留出空间绘制悬浮栏了,共用同一个 A 组即可outRect.set(0, 0, 0, 0);}}}}

说明一点:我们该通过具体哪种方法获得position相应的位置呢?不知道的话就可以点进去查看源代码中是如何处理的

public void getItemOffsets(Rect outRect, View view, RecyclerView parent, State state) {getItemOffsets(outRect, ((LayoutParams) view.getLayoutParams()).getViewLayoutPosition(),parent);}其中:
/*** Returns the adapter position that the view this LayoutParams is attached to corresponds* to as of latest layout calculation.** @return the adapter position this view as of latest layout pass*/public int getViewLayoutPosition() {return mViewHolder.getLayoutPosition();}

接着,我们继续看我们的onDraw()方法

@Overridepublic void onDraw(Canvas c, RecyclerView parent, RecyclerView.State state) {super.onDraw(c, parent, state);//先画出带有背景颜色的矩形条悬浮栏,从哪个位置开始绘制到哪个位置结束,则需要先确定位置,再画文字(即:title)int left = parent.getPaddingLeft();int right = parent.getWidth() - parent.getPaddingRight();//父view(RecyclerView)有padding值,子view有margin值int childCount = parent.getChildCount();//得到的数据其实是一屏可见的item数量并非总item数,再复用for(int i = 0; i < childCount; i++){View child = parent.getChildAt(i);//子view(即:item)有可能设置有margin值,所以需要parms来设置margin值。 RecyclerView.LayoutParams params = (RecyclerView.LayoutParams) child.getLayoutParams();//以及 获取 position 位置int position = params.getViewLayoutPosition();if(position > -1){if(position == 0){//肯定是要绘制一个悬浮栏 以及 悬浮栏内的文字//画矩形悬浮条以及文字drawRectAndText(c, left, right, child, params, position);}else{if(lists.get(position).getTag() != null && !lists.get(position).getTag().equals(lists.get(position - 1).getTag())){//和上一个Tag不一样,说明是另一个新的分组//画矩形悬浮条以及文字drawRectAndText(c, left, right, child, params, position);}else{//说明是一组的,什么也不画,共用同一个Tag}}}}}

这样,我们就实现了简单的微信中的通讯录效果,在调试过程中,我们可以发现:当我们在getItemOffsets()方法中通过outRect.set(0, titleHeight, 0, 0)为我们的onDraw()中绘制矩形条预留空间,假如我们预留的空间小于我们要绘制的实际高度时,也就是说我们在getItemOffsets()方法中预留了20dp的paddingTop距离,而我们实际在onDraw()中绘制的矩形高度时30dp,那么又将出现什么现象呢?先看效果图

这里写图片描述

我们看到绘制的灰色的矩形条超出getItemOffsets()为我们预留的空间时,就会被item遮盖,但是会有残影,如上图所示。有童鞋该说了,为什么顶部的A矩形条没有,那是因为我重写了另一个方法,也就是我们接下啦要介绍的onDrawOver()方法。出现这个的原因是因为ItemDecoration的onDraw()方法比View(RecyclerView)的onDraw()先执行,也就是说,ItemDecoration的onDraw()绘制的内容处于最底层。ItemDecoration的onDraw()方法为什么会先于View的onDraw()方法执行?我们可以查看源代码,由于篇幅原因,这里就不再分析了。

接下来,我们分析最后一个方法:onDrawOver()方法

从上面分析被遮盖的图片中,我们看到为什么A所在的矩形条没有没item遮盖住呢?因为我们在onDrawOver()方法中绘制了一个靠顶的矩形条,onDrawOver()方法自带悬浮特性。也就是说,这里的A所在的矩形条是在item的上层的。从而可以看出onDrawOver()方法是最后才执行的(当然了,执行的顺序还是需要查看源代码的!!!),简单说下这几个执行的顺序:getItemOffsets()方法—>ItemDecoration的onDraw()方法—>View的onDraw()方法绘制item的view—>ItemDecoration的onDrawOver()方法。

@Overridepublic void onDrawOver(Canvas c, RecyclerView parent, RecyclerView.State state) {super.onDrawOver(c, parent, state);//其实就是获取到每一个可见的位置的item时,执行画顶层悬浮栏int firstPosition = ((LinearLayoutManager)parent.getLayoutManager()).findFirstVisibleItemPosition();//    View child = parent.getChildAt(firstPosition);View child = parent.findViewHolderForLayoutPosition(firstPosition).itemView;//绘制悬浮栏,其实这里和上面onDraw()绘制方法差不多,只不过,这里面的绘制是在最上层,会悬浮paint.setColor(Color.parseColor("#FFDFDFDF"));c.drawRect(parent.getPaddingLeft(), parent.getPaddingTop(), parent.getRight() - parent.getPaddingRight(), parent.getPaddingTop() + titleHeight, paint);//绘制文字paint.setColor(Color.parseColor("#88888888"));paint.getTextBounds(lists.get(firstPosition).getTag(), 0, lists.get(firstPosition).getTag().length(), rectBounds);c.drawText(lists.get(firstPosition).getTag(), child.getPaddingLeft(), parent.getPaddingTop() + titleHeight - (titleHeight/2 - rectBounds.height()/2), paint);}
上述代码中,我们可以看到item是不是需要预留空间,需要根据tag标记来决定。这个tag标记是我们定义在实体类中的一个字段,作用就是为了根据此标记将具有同一此标记的数据分到同一组中。

接下来看下我们的实体类

/***  实体类*/public class CategoryBean implements Serializable{private static final long serialVersionUID = 5136218664701666396L;private String tag;//所属的分类private String categoryName;public CategoryBean(String tag, String categoryName) {this.tag = tag;this.categoryName = categoryName;}public String getTag() {return tag;}public void setTag(String tag) {this.tag = tag;}public String getCategoryName() {return categoryName;}public void setCategoryName(String categoryName) {this.categoryName = categoryName;}
}

adapter适配器

/***  适配器*/public class CategoryAdapter extends RecyclerView.Adapter<CategoryAdapter.CategoryViewHolder>{private Context context;private List<CategoryBean> lists;private LayoutInflater inflater;public CategoryAdapter(Context context, List<CategoryBean> lists) {this.context = context;this.lists = lists;inflater = LayoutInflater.from(context);}@Overridepublic CategoryViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {View view = inflater.inflate(R.layout.item_category, parent, false);CategoryViewHolder holder = new CategoryViewHolder(view);return holder;}@Overridepublic void onBindViewHolder(CategoryViewHolder holder, final int position) {CategoryBean bean = lists.get(position);holder.tvName.setText(bean.getCategoryName());holder.itemView.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View v) {Toast.makeText(context, "点击了的位置position= "+ position, Toast.LENGTH_SHORT).show();}});}@Overridepublic int getItemCount() {return null !=lists ?lists.size() : 0;}public static class CategoryViewHolder extends RecyclerView.ViewHolder{TextView tvName;public CategoryViewHolder(View itemView) {super(itemView);tvName = (TextView) itemView.findViewById(R.id.tvName);}}
}

最后,我们看看如何去使用

public class MainActivity extends AppCompatActivity {private TitleItemDecoration titleItemDecoration;private RecyclerView recyclerView;private CategoryAdapter adapter;private List<CategoryBean> lists;@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);recyclerView = (RecyclerView) findViewById(R.id.recyclerView);recyclerView.setLayoutManager(new LinearLayoutManager(this));//设置测试数据setDatas();adapter = new CategoryAdapter(this, lists);recyclerView.setAdapter(adapter);titleItemDecoration = new TitleItemDecoration(this, lists);recyclerView.addItemDecoration(titleItemDecoration);}private void setDatas() {lists = new ArrayList<>();lists.add(new CategoryBean("A", "哎"));lists.add(new CategoryBean("A", "爱"));lists.add(new CategoryBean("A", "昂"));lists.add(new CategoryBean("B", "beautiful"));lists.add(new CategoryBean("B", "beak"));lists.add(new CategoryBean("B", "but"));lists.add(new CategoryBean("B", "bring"));lists.add(new CategoryBean("C", "category"));lists.add(new CategoryBean("C", "can"));lists.add(new CategoryBean("C", "captive"));lists.add(new CategoryBean("C", "computer"));lists.add(new CategoryBean("D", "default"));}
}
参考的牛人博客链接
张旭童 http://blog.csdn.net/zxt0601
Piasy https://blog.piasy.com/2016/03/26/Insight-Android-RecyclerView-ItemDecoration/?utm_source=tuicool&utm_medium=referral
站在牛人的肩膀上,我们将会更加轻松。非常感谢那些无私奉献的大牛们。当我们遇到一些解决不了或者没思路的问题时,要学会翻阅源码,或者官方的一些示例代码,会有意外的惊喜。最后不得不说,RecyclerView中相关的内容很多很强大。
希望能对你有所帮助,主要代码已经贴出来了,下班咯,源代码就不再上传了,如果有需要源码的请跟我说下
点击下载源码

这篇关于RecyclerView利用ItemDecoration实现头部悬停效果【类似微信通讯录效果】的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/155027

相关文章

Java反射实现多属性去重与分组功能

《Java反射实现多属性去重与分组功能》在Java开发中,​​List是一种非常常用的数据结构,通常我们会遇到这样的问题:如何处理​​List​​​中的相同字段?无论是去重还是分组,合理的操作可以提高... 目录一、开发环境与基础组件准备1.环境配置:2. 代码结构说明:二、基础反射工具:BeanUtils

使用Python实现base64字符串与图片互转的详细步骤

《使用Python实现base64字符串与图片互转的详细步骤》要将一个Base64编码的字符串转换为图片文件并保存下来,可以使用Python的base64模块来实现,这一过程包括解码Base64字符串... 目录1. 图片编码为 Base64 字符串2. Base64 字符串解码为图片文件3. 示例使用注意

使用Python实现获取屏幕像素颜色值

《使用Python实现获取屏幕像素颜色值》这篇文章主要为大家详细介绍了如何使用Python实现获取屏幕像素颜色值,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 一、一个小工具,按住F10键,颜色值会跟着显示。完整代码import tkinter as tkimport pyau

在Java中将XLS转换为XLSX的实现方案

《在Java中将XLS转换为XLSX的实现方案》在本文中,我们将探讨传统ExcelXLS格式与现代XLSX格式的结构差异,并为Java开发者提供转换方案,通过了解底层原理、性能优势及实用工具,您将掌握... 目录为什么升级XLS到XLSX值得投入?实际转换过程解析推荐技术方案对比Apache POI实现编程

IDEA如何实现远程断点调试jar包

《IDEA如何实现远程断点调试jar包》:本文主要介绍IDEA如何实现远程断点调试jar包的问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录问题步骤总结问题以jar包的形式运行Spring Boot项目时报错,但是在IDEA开发环境javascript下编译

Python实现自动化Word文档样式复制与内容生成

《Python实现自动化Word文档样式复制与内容生成》在办公自动化领域,高效处理Word文档的样式和内容复制是一个常见需求,本文将展示如何利用Python的python-docx库实现... 目录一、为什么需要自动化 Word 文档处理二、核心功能实现:样式与表格的深度复制1. 表格复制(含样式与内容)2

python获取cmd环境变量值的实现代码

《python获取cmd环境变量值的实现代码》:本文主要介绍在Python中获取命令行(cmd)环境变量的值,可以使用标准库中的os模块,需要的朋友可以参考下... 前言全局说明在执行py过程中,总要使用到系统环境变量一、说明1.1 环境:Windows 11 家庭版 24H2 26100.4061

Python中bisect_left 函数实现高效插入与有序列表管理

《Python中bisect_left函数实现高效插入与有序列表管理》Python的bisect_left函数通过二分查找高效定位有序列表插入位置,与bisect_right的区别在于处理重复元素时... 目录一、bisect_left 基本介绍1.1 函数定义1.2 核心功能二、bisect_left 与

VSCode设置python SDK路径的实现步骤

《VSCode设置pythonSDK路径的实现步骤》本文主要介绍了VSCode设置pythonSDK路径的实现步骤,包括命令面板切换、settings.json配置、环境变量及虚拟环境处理,具有一定... 目录一、通过命令面板快速切换(推荐方法)二、通过 settings.json 配置(项目级/全局)三、

pandas实现数据concat拼接的示例代码

《pandas实现数据concat拼接的示例代码》pandas.concat用于合并DataFrame或Series,本文主要介绍了pandas实现数据concat拼接的示例代码,具有一定的参考价值,... 目录语法示例:使用pandas.concat合并数据默认的concat:参数axis=0,join=