ScrollView嵌套FlatList报错,需实现多列列表布局该如何解决?
VirtualizedLists should never be nested inside plain ScrollViews with the same orientation - use another VirtualizedList-backed container instead.
这个是React Native框架抛出的警告,核心原因是FlatList基于VirtualizedList实现,本身自带滚动能力,和外层同方向的普通ScrollView嵌套后会出现滚动手势冲突、列表项懒加载失效、性能大幅下降的问题,也会导致列表的下拉刷新、上拉加载等功能异常。
你需要实现的是「顶部自定义头部 + 下方3列网格列表」的滚动页面,推荐优先使用第一种方案:
方案1:使用FlatList的ListHeaderComponent属性(推荐)
完全移除外层的ScrollView,把原本放在ScrollView里的头部内容全部放到FlatList的ListHeaderComponent属性中,由FlatList接管整个页面的滚动能力,既保留3列布局的能力,也符合官方性能规范。
修改后代码如下:
return ( <View style={{flex: 1, backgroundColor: '#612d7c'}}> <FlatList data={products} style={{marginBottom: 20}} numColumns={3} ListHeaderComponent={ <> <View style={{marginTop: headerHeight}}> <ProfilePictureItem /> </View> <View style={styles.badgeTextContainer}> <Text style={styles.badgeText}>Badges</Text> </View> <Card style={styles.card}> </> } renderItem={itemData => ( <BadgeItem key={itemData.item.id} style={styles.badge}/> )} ListFooterComponent={<View style={{height: 20}} />} /> </View> );
如果你的Card组件需要包裹整个列表,也可以把FlatList整体放到Card内部,头部内容仍放在ListHeaderComponent中即可。
方案2:禁用内部FlatList的滚动能力(仅适合短列表场景)
如果业务场景必须保留外层ScrollView,可以给内部的FlatList添加scrollEnabled={false}属性,同时给FlatList设置flexGrow: 0的样式,让FlatList一次性渲染所有子项、不自带滚动能力,由外层ScrollView接管整体滚动。
修改对应代码片段如下:
<FlatList data={products} style={{marginBottom: 20, flexGrow: 0}} scrollEnabled={false} renderItem={itemData => ( <BadgeItem key={itemData.item.id} style={styles.badge}/> )} numColumns={3} />
注意:这个方案会导致FlatList的虚拟滚动、懒加载能力完全失效,列表项超过20个时会出现明显的性能下降、内存占用过高的问题,仅适合列表项数量极少的场景。
内容的提问来源于stack exchange,提问作者Julio Palacios

