React Native填坑之旅 -- FlatList

在React Native里有不少种方法来建立可滚动的list。好比，ScrollView和ListView。他们都各有优缺点。可是在React Native 0.43里增长了两种行的list view。一个是FlatList, 一个是SectionList。今天咱们就来详细了解一下FlatList。

若是你熟悉RN以前的ListView的话你会发现FlatList的API更加的简单，只须要给它一列数据，而后根据每一项数据绘制行就能够。

源代码在github上。代码中使用的是RN 0.49.5。

基本使用方法

基本上你只要给FlatList的两个props指定值就能够了，一个是data，一个是renderItem。数据源通常就是一个数组，而renderItem就是每一行的绘制方法。绘制行的时候只须要获取当前的数据项就能够。

正式开始以前，咱们看下代码是什么样子的。

import React from 'react';
import {
  View,
  Text,
  FlatList,
  Dimensions,
} from 'react-native';

import MessageCell from './MessageCell';

const { width, height } = Dimensions.get('window');
const SCREEN_WIDTH = width;

export default class MessageContainer extends React.Component {
  constructor(props) {
    super(props);

    this.state = {
      error: false,
      page: 1,
      refreshing: false,
      loading: false,
      data: {},
    };
  }

  componentDidMount() {
    this.requestData();
  }

  requestData = () => {
    const url = 'Some rest api url address';
    fetch(url).then(res => {    
      return res.json()
    }).then(res => {
      this.setState({
        data: [...this.state.data, ...res],
      });
    }).catch(err => {
      this.setState({ error: err, loading: false, refreshing: false});
    });
  };

  render() {
    return (
      <View style={{ flex: 1, justifyContent: 'center', alignItems: 'stretch', backgroundColor: 'white' }}>
        <Text>Message</Text>
        <FlatList
          data={[{ key: 'a' }, { key: 'b' }, { key: 'c' }, { key: 'd' }]}
          renderItem={({ item }) => (
            <MessageCell item={item} />
          )} />
      </View>
    );
  }
}

首先import必要的组件：import { FlatList } from 'react-native';。固然还有其余的一些组件。render方法里就能够写绘制的代码了:

render() {
    return (
      <View style={...}>
        <Text>Message</Text>
        <FlatList
          data={this.state.data}
          renderItem={({ item }) => (
            <MessageCell item={item} />
          )} />
      </View>
    );
  }

data是从github的API上请求来的数据，json数据被解析以后填充到了this.state.data里。就像这样：data: [...this.state.data, ...res]。每一个元素是一个只有一个key键值的对象。renderItem方法里会根据每个item返回一个MessageCell组件。这个组件会根据传入的数据呈现不一样的内容。

每行须要一个key

React Native为了很快的达到重绘改变了的一组组件，规定要给这一组组件里的每个都设置一个key。FlatList的每一行也都须要一个key。

咱们能够直接设置一个key。好比，每一个元素的返回json里都有一个id属性，正好就能够用来做为每一行的key值。FlatList还有另外的一个设置方式.使用keyExtractor。

render() {
    return (
      <View style={styles.container}>
        <Text>Message</Text>
        <FlatList
          ...
          keyExtractor={item => item.id} />
      </View>
    );

分割线 - seperator

咱们的APP自己在显示message的时候没有明显的分割线，而是用一块一块的方式显示的。若是只是简单的一条线分割两行，那么只须要设置行组件的boderBottom相关的属性就能够了。
如设置行组件的borderBottom：

<View style={ borderTopWidth: 0, borderBottomWidth: 1, borderBottomColor: 'grey' }>
  // content...
</View>

若是你必定要一个分割线的话可使用FlatList的ItemSeperatorComponent prop。如：

renderSeparator = () => {
    return (
        <View
        style={{
        height: 1,
        width: "86%",
        backgroundColor: "#CED0CE",
        marginLeft: "14%"
        }}
        />
    );
  };

使用seperator：

render() {
  return (
    <List containerStyle={{ borderTopWidth: 0, borderBottomWidth: 0 }}>
      <FlatList
        ...
        ItemSeparatorComponent={this.renderSeparator}
      />
    </List>
  );
}

在FlatList里使用prop ItemSeparatorComponent就能够。

注意：list的顶部和底部的分割组件是不绘制的。

下拉刷新和上拉加载更多

自从这两个交互的方式自从发明出来以后就基本上是每个应用里list的标配了。咱们来看看FlatList如何添加这两个功能的。

render() {
    return (
      <View style={styles.container}>
        <Text>Message</Text>
        <FlatList
          ...
          refreshing={this.state.refreshing}
          onRefresh={this.handleRefresh}
          onEndReached={this.handleLoadMore}
          onEndReachedThreshold={0} />
      </View>
    );
  }

FlatList的几个props：
refreshing：代表list是否在refresh的状态。
onRefresh：开始refresh的事件。在这个方法里开始设置refresh的时候组件的state，并在setState方法的回调里开始请求后端的数据。
onEndReached: 上拉加载跟个多的事件。在这里设置加载更多对应的组件状态，并在setState方法的回调里请求后端数据。
onEndReachedThreshold：这个值是触发onEndReached方法的阈值。值是RN的逻辑像素。

下面看一下下拉刷新的方法。上拉加载更多基本相似，各位能够参考代码。

handleRefresh = () => {
    this.setState({
      page: 1,
      refreshing: true,
      loading: false,
      data: [],
    }, () => {
      this.requestData();
    });
  }

请求github的API的方法是：

requestData = () => {
    const url = 'https://api.github.com/users/[your github name]/repos';
    fetch(url).then(res => {
      console.log('started fetch');
      return res.json()
    }).then(res => {
      this.setState({
        data: [...this.state.data, ...res], 
        error: res.error || null,
        laoding: false,
        refreshing: false,
      });
    }).catch(err => {
      console.log('==> fetch error', err);
      this.setState({ error: err, loading: false, refreshing: false});
    });
  }

在下拉刷新开始请求后端的数据的时候首先设置组件状态。给组件的state设置初始值。

下拉刷新的话，每次都会清空已经存在的数据，并在以后给他设置为得到的第一页（或者）最新的数据，因此page:1。接下来要开始刷新，那么表示刷新的小菊花就须要转起来，因此refreshing的值设为true。loading在这个时候是不存在的，因此为false。

在setState方法的回调里开始请求后端的数据。数据返回以后，下拉刷新或者加载更多的状态都不存在。若是请求数据的时候有错，那么咱们要处理错误。因此秦秋网络数据的方法为：

requestData = () => {
    const url = 'https://api.github.com/users/futurechallenger/repos';
    fetch(url).then(res => {
      console.log('started fetch');
      return res.json()
    }).then(res => {
      this.setState({
        data: [...this.state.data, ...res], 
        error: res.error || null,
        laoding: false,
        refreshing: false,
      });
    }).catch(err => {
      console.log('==> fetch error', err);
      this.setState({ error: err, loading: false, refreshing: false});
    });
  }

在返回的数据转化为json格式以后，合成data。这个时候refreshing和loading都已经完成，值都设置为false。数据是累加的：data: [...this.state.data, ...res],，因此每次在下拉刷新的时候this.setState({data: []})，在上拉加载更多的时候能够留着data不置空。

List的header和footer

这个很是的简单，只要直接看代码就能够明白了。和使用prop renderItem同样的，header和footer都有对应的prop来绘制。

// Header
  renderHeader = () => {
    return <SearchBar placeholder="Type Here..." lightTheme round />;
  };

  // Footer
  renderFooter = () => {
    if (!this.state.loading) return null;

    return (
      <View
        style={{
          paddingVertical: 20,
          borderTopWidth: 1,
          borderColor: "#CED0CE"
        }}
      >
        <ActivityIndicator animating size="large" />
      </View>
    );
  };

而后这么用：

render() {
  return (
    <List containerStyle={{ borderTopWidth: 0, borderBottomWidth: 0 }}>
      <FlatList
        ...
        ListHeaderComponent={this.renderHeader}
        ListFooterComponent={this.renderFooter}
      />
    </List>
  );
}

但愿这些对大家有用。