ReactNative中FlatList(ListView已过期)组件

React Native中开始是ListView,对于下拉、上拉刷新加载等功能,需要额外的添加,ListView被放弃,现在使用FlatListt或是SectionList

FlatList

  • 用于显示一个垂直的滚动列表,其中样式相同仅数据不同

  • 更适于长列表数据,且元素个数可以增删。和ScrollView不同的是,

  • FlatList并不立即渲染所有元素,而是优先渲染屏幕上可见的元素

  • 组件必须的两个属性是data和renderItem。

    • data是列表的数据源
    • renderItem则从数据源中逐个解析数据,然后返回一个设定好格式的组件来渲染
<FlatList
  data={[{key: 'a'}, {key: 'b'}]}
  renderItem={({item}) => <Text>{item.key}</Text>}
/>
  • FlatList支持以下功能
    • 完全跨平台。
  • 支持水平布局模式。
  • 行组件显示或隐藏时可配置回调事件。
  • 支持单独的头部组件。
  • 支持单独的尾部组件。
  • 支持自定义行间分隔线。
  • 支持下拉刷新。
  • 支持上拉加载。
  • 支持跳转到指定行(ScrollToIndex)

FlatList相关属性

  • ItemSeparatorComponent
    行与行之间的分隔线组件。不会出现在第一行之前和最后一行之后

  • ListEmptyComponent
    列表为空时渲染该组件。可以是React Component, 也可以是一个render函数, 或者渲染好的element

  • ListFooterComponent
    尾部组件

  • ListHeaderComponent
    头部组件

  • columnWrapperStyle
    如果设置了多列布局(即将numColumns值设为大于1的整数),则可以额外指定此样式作用在每行容器上

  • data
    data属性目前只支持普通数组。如果需要使用其他特殊数据结构,例如immutable数组,请直接使用更底层的VirtualizedList组件

  • extraData
    如果有除data以外的数据用在列表中(不论是用在renderItem还是Header或者Footer中),请在此属性中指定。同时此数据在修改时也需要先修改其引用地址(比如先复制到一个新的Object或者数组中),然后再修改其值,否则界面很可能不会刷新

  • getItem
    获取每个Item

  • getItemCount
    获取Item属相

  • horizontal
    设置为true则变为水平布局模式。

  • initialNumToRender
    指定一开始渲染的元素数量,最好刚刚够填满一个屏幕,这样保证了用最短的时间给用户呈现可见的内容。注意这第一批次渲染的元素不会在滑动过程中被卸载,这样是为了保证用户执行返回顶部的操作时,不需要重新渲染首批元素。

  • initialScrollIndex
    开始时屏幕顶端的元素是列表中的第 initialScrollIndex 个元素, 而不是第一个元素。设置这个属性会关闭对“滚动到顶端”这个动作的优化(参见VirtualizedList 的 initialNumToRender 属性)。位于 initialScrollIndex 位置的元素总是会被立刻渲染。需要先设置 getItemLayout 属性。

  • keyExtractor
    此函数用于为给定的item生成一个不重复的key。Key的作用是使React能够区分同类元素的不同个体,以便在刷新时能够确定其变化的位置,减少重新渲染的开销。若不指定此函数,则默认抽取item.key作为key值。若item.key也不存在,则使用数组下标。

  • legacyImplementation
    设置为true则使用旧的ListView的实现。

  • numColumns
    多列布局只能在非水平模式下使用,即必须是horizontal={false}
    。此时组件内元素会从左到右从上到下按Z字形排列,类似启用了flexWrap的布局。组件内元素必须是等高的——暂时还无法支持瀑布流布局。

  • onEndReached
    当列表被滚动到距离内容最底部不足onEndReachedThreshold
    的距离时调用。

  • onEndReachedThreshold
    决定当距离内容最底部还有多远时触发onEndReached
    回调。注意此参数是一个比值而非像素单位。比如,0.5表示距离内容最底部的距离为当前列表可见长度的一半时触发。

  • onRefresh
    如果设置了此选项,则会在列表头部添加一个标准的RefreshControl控件,以便实现“下拉刷新”的功能。同时你需要正确设置refreshing属性。

  • onViewableItemsChanged
    在可见行元素变化时调用。可见范围和变化频率等参数的配置请设置viewabilityconfig属性

  • refreshing
    在等待加载新数据时将此属性设为true,列表就会显示出一个正在加载的符号

  • renderItem: (info: {item: ItemT, index: number})
    根据行数据data,渲染每一行的组件

FlatList方法

  • scrollToEnd
    滚动到底部。如果不设置getItemLayout属性的话,可能会比较卡。

  • scrollToIndex
    将位于指定位置的元素滚动到可视区的指定位置,当 viewPosition 为 0 时将它滚动到屏幕顶部,为 1 时将它滚动到屏幕底部,为 0.5 时将它滚动到屏幕中央。如果不设置getItemLayout属性的话,无法跳转到当前可视区域以外的位置。

  • scrollToItem
    这个方法会顺序遍历元素。尽可能使用 scrollToIndex 。 如果不设置getItemLayout属性的话,可能会比较卡

  • scrollToOffset
    滚动列表到指定的偏移(以像素为单位),等同于 ScrollView 的 scrollTo 方法。

  • recordInteraction()
    主动通知列表发生了一个事件,以使列表重新计算可视区域。比如说当waitForInteractions 为 true 并且用户没有滚动列表时,就可以调用这个方法。不过一般来说,当用户点击了一个列表项,或发生了一个导航动作时,我们就可以调用这个方法。

  • flashScrollIndicators()
    短暂地显示滚动指示器。

先关的一些效果

效果参考链接(ES5的写法)

第一个效果代码

import React, {Component} from 'react';

import {
  FlatList,
  StyleSheet,
  Text,
  View,
  Image,
  TouchableOpacity,
  AlertIOS,
} from 'react-native';

//首先要导入Dimensions包
var Diemnsions = require('Dimensions');
var width = Diemnsions.get('window').width;
//获取数据
var wineData = require('./Wine.json');

export default class App7 extends Component {
  render() {
    return (
      <FlatList
        //加载数据源
        data={wineData}
        //展示数据
        renderItem={({ index, item }) => this.showCell(index, item)}
        //默认情况下每行都需要提供一个不重复的key属性
        keyExtractor={(item, index) => (index)}
      />
    );
  }
  showCell(index, item) {
    return (
      //添加手势
      <TouchableOpacity activeOpacity={0.5} onPress={() => { AlertIOS.alert('点击了' + index + '行') }}>
        <View style={styles.cellViewStyle}>
          <Image style={{marginRight: 10,width: 60,height: 60}} source={{ url: item.image }} />
          <View style={{justifyContent: 'center'}}>
            <Text style={styles.topTextStyle}>{item.name}</Text>
            <Text style={{color:'blue'}}>¥{item.money}</Text>
          </View>
        </View>
      </TouchableOpacity>
    )
  }
}

const styles = StyleSheet.create({
  cellViewStyle: {
    marginTop: 25,
    borderBottomWidth: 0.5,
    borderBottomColor: '#e8e8e8',
    flexDirection: 'row',
  },
  topTextStyle: {
    color: 'red',
    fontSize: 15,
    width: width * 0.7,
    marginBottom: 8,
  },
})

第二个效果

import React, {Component} from 'react';
import {
    FlatList,
    StyleSheet,
    Text,
    View,
    Image,
    TouchableOpacity,
    AlertIOS,
} from 'react-native';

//首先要导入Dimensions包
var Diemnsions = require('Dimensions');
var width = Diemnsions.get('window').width;

//获取数据
var shareData = require('./shareData.json').data;

var cols = 3;
var cellH = 100;
var vMargin = (width - cellH * cols) / (cols + 1);
var HMargin = 25;

export default class App8 extends Component {
    render() {
        return (
            <FlatList
                //加载数据源
                data={shareData}
                //展示数据
                renderItem={({ index, item }) => this.showCell(index, item)}
                //默认情况下每行都需要提供一个不重复的key属性
                keyExtractor={(item, index) => (index)}
                //设置垂直布局()
                horizontal={false}
                //设置水平的排列的个数(只有垂直布局才起作用)
                numColumns={4}
            />
        );
    }
    showCell(index, item) {
        return (
            //添加手势
            <TouchableOpacity activeOpacity={0.5} onPress={() => { AlertIOS.alert('第' + index + '个') }}>
                <View style={styles.cellViewStyle}>
                    <Image source={{ url: item.icon }} style={{ width: 80, height: 80 }} />
                    <Text>{item.title}</Text>
                </View>
            </TouchableOpacity>
        )
    }
}
const styles = StyleSheet.create({
    cellViewStyle: {
        width: cellH,
        height: cellH,
        marginLeft: vMargin,
        marginTop: HMargin,
        alignItems: 'center',
    },
})
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 160,706评论 4 366
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 68,002评论 1 301
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 110,462评论 0 250
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,375评论 0 216
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,763评论 3 294
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,849评论 1 224
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 32,033评论 2 317
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,768评论 0 204
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,490评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,734评论 2 253
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,204评论 1 264
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,566评论 3 260
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,227评论 3 241
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,137评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,934评论 0 201
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,926评论 2 283
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,774评论 2 274