跳到主要内容
版本:0.80

优化 Flatlist 配置

术语

  • VirtualizedList: FlatList 背后的组件(React Native 对 Virtual List 概念的实现。)

  • 内存占用: 列表信息在内存中保存了多少,这可能会导致应用崩溃。

  • 响应性: 应用对交互作出响应的能力。例如,低响应性就是你触摸某个组件后,它不会立即响应,而是要等一会儿才响应。

  • 空白区域:VirtualizedList 无法足够快地渲染你的项目时,你可能会滚动到列表中一部分尚未渲染的组件区域,它们会显示为空白空间。

  • 视口: 渲染到像素上的可见内容区域。

  • 窗口: 应该挂载项目的区域,通常比视口大得多。

属性

以下是一些有助于提升 FlatList 性能的属性:

removeClippedSubviews

类型默认值
BooleanAndroid 上为 true,否则为 false

如果为 true,视口之外的视图会自动从原生视图层级中分离出去。

优点: 通过将视口之外的视图排除在原生渲染和绘制遍历之外,可以减少主线程上的耗时,从而降低掉帧风险。

缺点: 请注意,这种实现可能存在 bug,例如内容缺失(主要在 iOS 上观察到),尤其是在你使用变换和/或绝对定位做复杂处理时。还要注意,这不会显著节省内存,因为这些视图并没有被释放,只是被分离了。

maxToRenderPerBatch

类型默认值
Number10

这是一个可以通过 FlatList 传递的 VirtualizedList 属性。它控制每批渲染的项目数量,也就是每次滚动时接下来渲染的那一块项目。

优点: 设置更大的数值意味着滚动时可见空白区域更少(提高填充率)。

缺点: 每批渲染更多项目意味着 JavaScript 执行时间更长,可能会阻塞其他事件处理,比如点击,从而影响响应性。

updateCellsBatchingPeriod

类型默认值
Number50

maxToRenderPerBatch 说明每批渲染多少项目,而设置 updateCellsBatchingPeriod 则告诉你的 VirtualizedList 两次批量渲染之间的延迟毫秒数(即组件渲染窗口化项目的频率)。

优点: 将这个属性与 maxToRenderPerBatch 结合使用,可以灵活地例如以较低频率渲染更多项目,或者以较高频率渲染更少项目。

缺点: 较低频率的批次可能会导致空白区域,较高频率的批次可能会带来响应性问题。

initialNumToRender

类型默认值
Number10

初始渲染的项目数量。

优点: 为不同设备精确定义能够覆盖屏幕的项目数量。这对于初始渲染来说可能是一个很大的性能提升。

缺点: 设置过低的 initialNumToRender 可能会导致空白区域,尤其是在初始渲染时它小到不足以覆盖视口的情况下。

windowSize

类型默认值
Number21

这里传入的数字是一个测量单位,其中 1 等于你的视口高度。默认值是 21(上方 10 个视口,下方 10 个视口,中间 1 个视口)。

优点: 更大的 windowSize 会降低滚动时看到空白区域的概率。另一方面,更小的 windowSize 会让同时挂载的项目更少,从而节省内存。

缺点: 更大的 windowSize 会带来更多内存占用。更小的 windowSize 会让看到空白区域的概率更高。

列表项

下面是一些关于列表项组件的建议。它们是列表的核心,因此需要足够快。

使用基础组件

你的组件越复杂,渲染就越慢。尽量避免在列表项中加入过多逻辑和嵌套。如果你在应用中大量复用这个列表项组件,请专门为大列表创建一个组件,并尽量减少其中的逻辑和嵌套。

使用轻量组件

你的组件越重,渲染就越慢。避免使用大型图片(列表项请使用裁剪后的版本或缩略图,并尽可能小)。与设计团队沟通,在列表中尽量减少效果、交互和信息量。把这些内容展示在项目详情中。

使用 memo()

React.memo() 会创建一个记忆化组件,只有当传入组件的 props 发生变化时才会重新渲染。我们可以使用这个函数来优化 FlatList 中的组件。

React TSX
import {memo} from 'react';
import {View, Text} from 'react-native';

const MyListItem = memo(
({title}: {title: string}) => (
<View>
<Text>{title}</Text>
</View>
),
(prevProps, nextProps) => {
return prevProps.title === nextProps.title;
},
);

export default MyListItem;

在这个示例中,我们已确定只有当 title 发生变化时,MyListItem 才应重新渲染。我们将比较函数作为 React.memo() 的第二个参数传入,这样组件就只会在指定的 prop 发生变化时重新渲染。如果比较函数返回 true,组件将不会重新渲染。

使用缓存优化过的图片

你可以使用社区包(例如来自 Dream11@d11/react-native-fast-image)来获得更高性能的图片。列表中的每张图片都是一个 new Image() 实例。它越快到达 loaded 钩子,JavaScript 线程就能越快再次空闲下来。

使用 getItemLayout

如果你的所有列表项组件高度都相同(横向列表则是宽度相同),提供 getItemLayout 属性可以让你的 FlatList 无需管理异步布局计算。这是一种非常理想的优化技术。

如果你的组件尺寸是动态的,而你确实需要性能,可以考虑请设计团队看看是否可以重新设计,以获得更好的性能。

使用 keyExtractor 或 key

你可以为 FlatList 组件设置 keyExtractor。这个属性用于缓存,也作为 React 的 key 来跟踪项目重排序。

你也可以在项目组件中使用 key 属性。

避免在 renderItem 中使用匿名函数

对于函数组件,将 renderItem 函数移到返回的 JSX 外部。此外,确保它被 useCallback 钩子包裹,以防止它在每次渲染时被重新创建。

对于类组件,将 renderItem 函数移到 render 函数外部,这样它就不会在每次调用 render 函数时重新创建自身。

React TSX
const renderItem = useCallback(({item}) => (
<View key={item.key}>
<Text>{item.title}</Text>
</View>
), []);

return (
// ...

<FlatList data={items} renderItem={renderItem} />;
// ...
);