自定义动态列表 属于 Android Jetpack 的一部分。
您可以自定义RecyclerView
对象以满足您的特定需求。使用 RecyclerView 创建动态列表中描述的标准类提供了大多数开发者所需的所有功能。在许多情况下,您只需要设计每个视图持有者的视图并编写代码以使用适当的数据更新这些视图。但是,如果您的应用有特殊要求,您可以通过多种方式修改标准行为。本文档描述了一些可能的自定义。
修改布局
RecyclerView
使用布局管理器将各个项目放置在屏幕上,并确定何时重用用户不再可见的项目视图。为了重用(或_循环_)视图,布局管理器可能会要求适配器用数据集中的不同元素替换视图的内容。通过这种方式循环使用视图可以提高性能,避免创建不必要的视图或执行代价高昂的findViewById()
查找。Android 支持库包含三个标准布局管理器,每个管理器都提供许多自定义选项
LinearLayoutManager
:将项目排列在一维列表中。使用带有LinearLayoutManager
的RecyclerView
提供类似于ListView
布局的功能。GridLayoutManager
:将项目排列在二维网格中,就像棋盘上的方格一样。使用带有GridLayoutManager
的RecyclerView
提供类似于GridView
布局的功能。StaggeredGridLayoutManager
:将项目排列在二维网格中,每列都与前一列略微偏移,就像美国国旗上的星星一样。
如果这些布局管理器不适合您的需求,您可以通过扩展RecyclerView.LayoutManager
抽象类来创建自己的布局管理器。
添加项目动画
每当项目发生更改时,RecyclerView
都会使用_动画器_ 来更改其外观。此动画器是一个扩展抽象RecyclerView.ItemAnimator
类的对象。默认情况下,RecyclerView
使用DefaultItemAnimator
提供动画。如果您想提供自定义动画,您可以通过扩展RecyclerView.ItemAnimator
来定义自己的动画器对象。
启用列表项选择
recyclerview-selection
库允许用户使用触摸或鼠标输入选择RecyclerView
列表中的项目。这使您可以保留对所选项目的视觉呈现的控制。您还可以保留对控制选择行为的策略的控制,例如哪些项目有资格被选择以及可以选择的项目数量。
要向RecyclerView
实例添加选择支持,请按照以下步骤操作
- 确定要使用的选择键类型,然后构建
ItemKeyProvider
。您可以使用三种键类型来标识所选项目
Parcelable
及其子类,例如Uri
字符串
长整型
有关选择键类型的详细信息,请参阅
SelectionTracker.Builder
。 - 实现
ItemDetailsLookup
。 - 更新
RecyclerView
中的项目View
对象,以反映用户选择或取消选择它们。选择库不为所选项目提供默认视觉装饰。在实现
onBindViewHolder()
时提供此装饰。我们推荐以下方法- 在
onBindViewHolder()
中,调用setActivated()
—**不是**setSelected()
—在View
对象上使用true
或false
,具体取决于项目是否被选中。 - 更新视图的样式以表示激活状态。我们建议使用颜色状态列表资源 来配置样式。
- 在
- 使用
ActionMode
为用户提供用于对选择执行操作的工具。 - 执行任何解释的辅助操作。
- 使用
SelectionTracker.Builder
组装所有内容。 - 在活动生命周期事件中包含选择。
ItemDetailsLookup
允许选择库访问有关RecyclerView
项目的信息,前提是给定MotionEvent
。它实际上是ItemDetails
实例的工厂,这些实例由RecyclerView.ViewHolder
实例支持或从中提取。
注册SelectionTracker.SelectionObserver
以在选择更改时收到通知。首次创建选择时,启动ActionMode
以将其呈现给用户并提供特定于选择的操作。例如,您可以向ActionMode
栏添加一个删除按钮,并将栏上的后退箭头连接到清除选择。当选择变为空时——如果用户最后一次清除选择——则终止操作模式。
在事件处理管道的末尾,库可能会确定用户正在尝试通过点击来激活项目,或者正在尝试拖动项目或一组所选项目。通过注册相应的侦听器来响应这些解释。有关更多信息,请参阅SelectionTracker.Builder
。
以下示例显示了如何将这些部分组合在一起
Kotlin
var tracker = SelectionTracker.Builder( "my-selection-id", recyclerView, StableIdKeyProvider(recyclerView), MyDetailsLookup(recyclerView), StorageStrategy.createLongStorage()) .withOnItemActivatedListener(myItemActivatedListener) .build()
Java
SelectionTracker tracker = new SelectionTracker.Builder<>( "my-selection-id", recyclerView, new StableIdKeyProvider(recyclerView), new MyDetailsLookup(recyclerView), StorageStrategy.createLongStorage()) .withOnItemActivatedListener(myItemActivatedListener) .build();
要构建SelectionTracker
实例,您的应用必须提供与用于将RecyclerView
初始化为SelectionTracker.Builder
的RecyclerView.Adapter
相同的适配器。因此,在创建SelectionTracker
实例后,将其注入到您的RecyclerView.Adapter
中。否则,您无法从onBindViewHolder()
方法检查项目的选中状态。
要跨活动生命周期事件保留选择状态,您的应用必须分别从活动的onSaveInstanceState()
和onRestoreInstanceState()
方法调用选择跟踪器的onSaveInstanceState()
和onRestoreInstanceState()
方法。您的应用还必须向SelectionTracker.Builder
构造函数提供唯一的选择 ID。需要此 ID,因为活动或片段可能有多个不同的可选择列表,所有这些列表都需要在其保存的状态中持久化。
其他资源
有关其他信息,请参阅以下参考资料。
- 使用
RecyclerView
的向日葵演示应用。 - 使用 RecyclerView 显示可滚动列表 代码实验室。
- Android Kotlin 基础知识:RecyclerView 基础 代码实验室。