xiazunyang / recyclerview.decoration

RecyclerView常用的一些ItemDecoration装饰器,比如RecyclerView使用GridLayoutManager时,使每个ItemView之间的间距相等的SpaceItemDecoration;以及在垂直列表上显示悬浮视图的StickyItemDecoration。

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

RecyclerView

当前最新版本号:

SpaceItemDecoration

  • 使每个Item之间的距离保持指定的间距
  • 使用方法:
  1. 创建实例、指定间距并添加到RecyclerView即可。
recyclerView.addItemDecoration(SpaceItemDecoration(8.dp))

StickyItemDecoration

  • 在指定的Item顶部添加跟随Item滚动的悬浮视图。
  • 使用方法:
  1. 在RecyclerView.Adapter的实现类上实现StickySupport接口。
class ItemAdapter : PagingBindingAdapter<NumberItem, NumberItemBindingHolder, NumberViewBinding>(::NumberItemBindingHolder), StickySupport {
    /** 如果某个Position上的Item需要显示悬浮视图,则返回true */
    override fun isSticky(position: Int): Boolean {
        val previous = (position - 1).toString()
        val current = position.toString()
        return position == 0 || current.length > 1 && current.first() != previous.first()
    }

    /** 根据position创建要显示的悬浮视图 */
    override fun createStickyView(position: Int, parent: ViewGroup): View {
        val textView = TextView(parent.context)
        val itemString = position.toString()
        textView.text = if (itemString.length == 1) "0" else itemString.first().toString()
        textView.setPadding(24)
        val typedValue = TypedValue()
        parent.context.theme.resolveAttribute(R.attr.colorSecondary, typedValue, true)
        textView.setBackgroundColor(typedValue.data)
        return textView
    }
}
  1. 在RecyclerView上添加StickyItemDecoration即可
recyclerView.addItemDecoration(StickyItemDecoration())

image

引入

  1. 在你的android工程的根目录下的build.gradle文件中的适当的位置添加以下代码:
allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}
  1. 在你的android工程中对应的android模块的build.gradle文件中的适当位置添加以下代码:
implementation 'cn.numeron:recyclerview.decoration:latest_version'

About

RecyclerView常用的一些ItemDecoration装饰器,比如RecyclerView使用GridLayoutManager时,使每个ItemView之间的间距相等的SpaceItemDecoration;以及在垂直列表上显示悬浮视图的StickyItemDecoration。

License:Apache License 2.0


Languages

Language:Kotlin 100.0%