React Native 中更优的列表视图
在社区群组中发布预告后,许多人已经开始尝试我们新的列表组件,但我们今天才正式宣布它们!不再有 ListView
或 DataSource
、陈旧的行、被忽略的 bug 或过多的内存消耗——通过最新的 React Native 2017 年 3 月发布候选版(0.43-rc.1
),您可以从新的组件套件中选择最适合您用例的组件,它们开箱即用,具有出色的性能和功能集。
<FlatList>
这是用于简单、高性能列表的主力组件。提供一个数据数组和一个 renderItem
函数即可使用。
<FlatList
data={[{title: 'Title Text', key: 'item1'}, ...]}
renderItem={({item}) => <ListItem title={item.title} />}
/>
<SectionList>
如果您想渲染一组数据,这些数据被分成逻辑部分,可能带有章节标题(例如,在按字母顺序排列的地址簿中),并且可能具有异构数据和渲染(例如,一个包含一些按钮的个人资料视图,然后是合成器,接着是照片网格,然后是朋友网格,最后是故事列表),那么这是最佳选择。
<SectionList
renderItem={({item}) => <ListItem title={item.title} />}
renderSectionHeader={({section}) => <H1 title={section.key} />}
sections={[ // homogeneous rendering between sections
{data: [...], key: ...},
{data: [...], key: ...},
{data: [...], key: ...},
]}
/>
<SectionList
sections={[ // heterogeneous rendering between sections
{data: [...], key: ..., renderItem: ...},
{data: [...], key: ..., renderItem: ...},
{data: [...], key: ..., renderItem: ...},
]}
/>
<VirtualizedList>
幕后实现,提供更灵活的 API。如果您的数据不是纯数组(例如,不可变列表),则特别方便。
功能
列表在许多场景中都会用到,因此我们为新组件提供了丰富的功能,以开箱即用地处理大多数用例
- 滚动加载(
onEndReached
)。 - 下拉刷新(
onRefresh
/refreshing
)。 - 可配置的可见性 (VPV) 回调(
onViewableItemsChanged
/viewabilityConfig
)。 - 水平模式(
horizontal
)。 - 智能的项目和章节分隔符。
- 多列支持(
numColumns
) scrollToEnd
、scrollToIndex
和scrollToItem
- 更好的 Flow 类型支持。
一些注意事项
-
当内容滚动出渲染窗口时,项目子树的内部状态不会被保留。请确保所有数据都存储在项目数据或外部存储(如 Flux、Redux 或 Relay)中。
-
这些组件基于
PureComponent
,这意味着如果props
保持浅相等,它们将不会重新渲染。请确保您的renderItem
函数直接依赖的所有内容都作为 prop 传递,并且在更新后不会===
,否则您的 UI 可能不会随着更改而更新。这包括data
prop 和父组件状态。例如<FlatList
data={this.state.data}
renderItem={({item}) => (
<MyItem
item={item}
onPress={() =>
this.setState(oldState => ({
selected: {
// New instance breaks `===`
...oldState.selected, // copy old data
[item.key]: !oldState.selected[item.key], // toggle
},
}))
}
selected={
!!this.state.selected[item.key] // renderItem depends on state
}
/>
)}
selected={
// Can be any prop that doesn't collide with existing props
this.state.selected // A change to selected should re-render FlatList
}
/> -
为了限制内存并实现平滑滚动,内容在屏幕外异步渲染。这意味着滚动速度可能比填充速度快,从而短暂看到空白内容。这是一个可以根据每个应用程序的需求进行调整的权衡,我们正在幕后努力改进它。
-
默认情况下,这些新列表会在每个项目上查找
key
prop,并将其用作 React key。或者,您可以提供一个自定义的keyExtractor
prop。
性能
除了简化 API 之外,新的列表组件还具有显著的性能增强,其中最主要的是无论行数多少,内存使用量都几乎保持恒定。这是通过“虚拟化”渲染窗口之外的元素来实现的,即将其从组件层次结构中完全卸载,并回收 React 组件的 JS 内存,以及阴影树和 UI 视图的原生内存。这有一个需要注意的地方,即内部组件状态将不会被保留,因此请务必在组件本身之外跟踪任何重要的状态,例如在 Relay、Redux 或 Flux 存储中。
限制渲染窗口还可以减少 React 和原生平台需要完成的工作量,例如视图遍历。即使您正在渲染一百万个元素中的最后一个,使用这些新列表也无需遍历所有这些元素即可渲染。您甚至可以使用 scrollToIndex
跳到中间,而不会造成过多的渲染。
我们还在调度方面进行了一些改进,这应该有助于提高应用程序的响应速度。渲染窗口边缘的项目会在任何活动手势、动画或其他交互完成后,以较低的优先级不频繁地渲染。
高级用法
与 ListView
不同,渲染窗口中的所有项目在任何 props 更改时都会重新渲染。通常这没有问题,因为窗口化会将项目数量减少到恒定值,但如果您的项目比较复杂,您应该确保遵循 React 性能最佳实践,并在组件中适当使用 React.PureComponent
和/或 shouldComponentUpdate
来限制递归子树的重新渲染。
如果您可以在不渲染行的情况下计算其高度,可以通过提供 getItemLayout
prop 来改善用户体验。这使得使用 scrollToIndex
等方法滚动到特定项目更加流畅,并且会改善滚动指示器 UI,因为可以在不渲染内容的情况下确定其高度。
如果您有另一种数据类型,例如不可变列表,那么 <VirtualizedList>
是最佳选择。它接受一个 getItem
prop,允许您为任何给定索引返回项目数据,并且具有更宽松的 Flow 类型。
如果您有不寻常的用例,还可以调整许多参数。例如,您可以使用 windowSize
来权衡内存使用量与用户体验,使用 maxToRenderPerBatch
来调整填充率与响应速度,使用 onEndReachedThreshold
来控制何时进行滚动加载等。
未来工作
- 现有界面的迁移(最终废弃
ListView
)。 - 随着我们发现/听到需求,将提供更多功能(请告诉我们!)。
- 粘性章节标题支持。
- 更多性能优化。
- 支持带状态的功能性项目组件。