学自定义View之前怎么也搞不懂StickyHeader的绘制,今天总算是搞懂了,通过自己理解的方式把这玩意实现了一下
这篇文章主要是介绍一下StikeyHeader我自己的实现方式,至于RecyclerView自身的padding,item的margin等,有需要的话可以自己加上
先来几张图看看StickyHeader是怎么回事
这是初始化状态
Item布局来自huanghaibin-dev/CalendarView
接着往下滑滑滑~
同一个组的标题始终显示在顶部
下一个标题把上一个标题顶上去
总结一下需要实现的核心内容
- 同一个组的标题始终显示在顶部
- 下一个组的标题到达顶部时,把上一个赖着不走的标题给顶走
介绍一下ItemDecoration
emm,很多文章都介绍得不错,那我就:好文,这篇好文最后也有实现StickyHeader,有兴趣额的小伙伴可以对比一下我们的实现方式
Header分析
先从简单的入手:实现Header,也就是没有Sticky效果,Header会始终跟着列表滑动而滑动
首先我们把同一个标题下的Items看作是一个组,那就是要实现组内的第一个Item增加一个Header,此时自然就想到需要重写getItemOffsets
方法,给需要的Item增加额外空间,然后重写onDraw
方法绘制Header
Header实现
class HeaderDecoration(
private val callback: Callback
): RecyclerView.ItemDecoration() {
var mHeight = dp2px(30f)
private val mPaint = Paint().apply {
color = 0xFFC5C5C5.toInt()
style = Paint.Style.FILL
isAntiAlias = true
}
private val mTextPaint = TextPaint().apply {
color = 0xff353535.toInt()
textSize = sp2dp(14f)
isAntiAlias = true
baselineShift = (textSize / 2 - descent()).toInt()
textAlign = Paint.Align.CENTER
}
// 给组内第一个Item增加额外空间来绘制Header
override fun getItemOffsets(
outRect: Rect,
view: View,
parent: RecyclerView,
state: RecyclerView.State
) {
super.getItemOffsets(outRect, view, parent, state)
val pos = parent.getChildAdapterPosition(view)
if (isFirstInGroup(pos)) {
outRect.top = mHeight
}
}
// 绘制Header
override fun onDraw(c: Canvas, parent: RecyclerView, state: RecyclerView.State) {
super.onDraw(c, parent, state)
val left = 0f
val right = parent.width.toFloat()
val childCount = parent.childCount
for (i in 0 until childCount) {
val child = parent.getChildAt(i)
val pos = parent.getChildAdapterPosition(child)
if (pos == RecyclerView.NO_POSITION || !isFirstInGroup(pos)) continue
val top = child.top - mHeight.toFloat()
val bottom = top + mHeight.toFloat()
c.drawRect(left, top, right, bottom, mPaint)
val title = callback.getGroupTitle(pos)
c.drawText(title, left, top + mHeight / 2 + mTextPaint.baselineShift, mTextPaint)
}
}
// 判断item是否所在组的内第一个item
private fun isFirstInGroup(pos: Int): Boolean {
if (pos < 0)
return false
val index = callback.getGroupIndex(pos)
val preIndex = callback.getGroupIndex(pos - 1)
return index != preIndex
}
// 回调获取item所在组的下标和标题
interface Callback {
fun getGroupIndex(pos: Int): Int
fun getGroupTitle(pos: Int): String
}
}
说明一下
- 代码是kotlin
- TextPaint和Paint在绘制上没有差别!对某些细节有疑问的可以参考一下我在StackOverflow上的回答
代码说明:
- 在getItemOffsets中判断当前需要增加空间的Item是否第组内第一个Item,是的话就增加一个mHeight的高度
- 在onDraw中遍历布局中的itemView,判断这个itemView是不是组内第一个Item,是的话就把Header绘制到这个itemView的正上方,标题则通过回调获得
使用
rv.addItemDecoration(HeaderDecoration(object : GroupDecoration.Callback {
override fun getGroupIndex(pos: Int): Int {
return findParent(pos) // 具体怎么找到GroupIndex自己实现
}
override fun getGroupTitle(pos: Int): String {
return findParentTitle(pos) // 同上,自己实现
}
}))
StickyHeader分析
经过观察可以发现,StickyHeader是绘制在itemView之上的,所以需要在onDrawOver中绘制。另外通过观察发现,StickyHeader要么一直处于顶部不动,要么跟着组内最后一个Item滑走,所以只需要判断当前RecyclerView最顶部可见的item是不是在组中的最后一个item,是的话,StickyHeader的bottom就要与这个itemView的bottom重合,视觉上就是跟着这个itemView滑走,否则直接在顶部把StickyHeader绘制出来
StickyHeader实现
// 绘制StickyHeader
override fun onDrawOver(c: Canvas, parent: RecyclerView, state: RecyclerView.State) {
super.onDrawOver(c, parent, state)
val manager = parent.layoutManager as LinearLayoutManager
// 找到RecyclerView第一个可见的itemView在adapter中的位置
val firstPos = manager.findFirstVisibleItemPosition()
if (firstPos == RecyclerView.NO_POSITION)
return
if (isLastInGroup(firstPos)) {
// 标题要跟着组内最后一个滑走
val child = parent.findViewHolderForAdapterPosition(firstPos)?.itemView ?: return
val bottom = min(child.bottom, mHeight).toFloat()
val top = bottom - mHeight.toFloat()
val left = 0f
val right = parent.width.toFloat()
c.drawRect(left, top, right, bottom, mPaint)
val title = callback.getGroupTitle(firstPos)
c.drawText(title, left, top + mHeight / 2 + mTextPaint.baselineShift, mTextPaint)
} else {
// 直接绘制在顶部
val top = 0f
val bottom = mHeight.toFloat()
val left = 0f
val right = parent.width.toFloat()
c.drawRect(left, top, right, bottom, mPaint)
val title = callback.getGroupTitle(firstPos)
c.drawText(title, left, top + mHeight / 2 + mTextPaint.baselineShift, mTextPaint)
}
}
// 判断item是否所在组的内最后一个item
private fun isLastInGroup(pos: Int): Boolean {
if (pos < 0)
return false
val index = callback.getGroupIndex(pos)
val preIndex = callback.getGroupIndex(pos + 1)
return index != preIndex
}
代码说明:
- 如果item是组内最后一个item,需要用min函数确定StickyHeader的位置,保证StickyHeader能正确显示并随itemView滑出屏幕
另外可以发现,之前onDraw绘制的Header,在视觉上不会影响StickyHeader的显示,并且还能巧妙地和onDrawOver绘制的StickyHeader结合形成"下面标题把当前标题顶上去"的效果,所以onDraw的代码不用改变
以上就是我实现StickyHeader的实现方法