React Native填坑之旅--ListView篇

列表显示数据，基本什么应用都是必须。笔者写做的时候RN版本是0.34。今天就来从浅到深的看看React Native的ListView怎么使用。

首先是使用写死的数据，以后会使用网络请求的数据在界面中显示。最后加上一个ActivityIndicator，网络请求的过程当中显示Loading图标，加载完成以后显示数据，隐藏Loading图标。

最简单的

//@flow

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

export default class DemoList extends React.Component {
  constructor(props) {
    super(props);
    const ds = new ListView.DataSource({rowHasChanged: (r1, r2) => r1 !== r2});
    this.state = {
      dataSource: ds.cloneWithRows(['row 1', 'row 2'])
    };
  }

  render() {
    return (
      <ListView
        dataSource={this.state.dataSource}
        renderRow={(rowData) => <Text>{rowData}</Text>} />
    );
  }
}

引入所须要的内置组件之类的就很少说了。

第一步，在constructor里设置数据源，并同时指定何时从新绘制一行，就是在这个时候(r1, r2) => r1 !== r2} 重绘。

以后，在state里面设置数据源。下面从网络请求数据的时候state的做用就更加明显了。RN的组件在state发生改变的时候就会重绘。这个下面会详细解释。

最后，在render方法里返回ListView，这里的props里有一个renderRow。在这里指定的代码就是把数据源中每一行的数据绘制在Text里。

一步一步接近实际产品开发

下面就把绘制行的部分抽象出来。在Native应用的开发中，不管是iOS仍是Android，行绘制的部分都是单独出来的。在RN里虽然能够不独立出来，可是你也看到了，这样的写法遇到稍微复杂一点的行内容的时候就捉襟见肘了。不独立出来行绘制部分代码会很难维护。

这部分不复杂，独立出来之后是这样的：

import //...略...

export default class DemoList extends React.Component {
  constructor(props) {
    super(props);
    const ds = new ListView.DataSource({rowHasChanged: (r1, r2) => r1 !== r2});
    this.state = {
      dataSource: ds.cloneWithRows(['row 1', 'row 2'])
    };

    //bind
    this._renderRow = this._renderRow.bind(this);
  }

  _renderRow(rowData) {
    return (
      <View style={{height: 50}}>
        <Text>{rowData}</Text>
      </View>
    );
  }

  render() {
    return (
      <ListView dataSource={this.state.dataSource}
        renderRow={this._renderRow} />
    );
  }
}

这个例子和上例基本上同样。只是多了一个_renderRow(rowData)方法。

注意：在使用这个方法之前，必定要绑定：this._renderRow = this._renderRow.bind(this);。绑定也能够这样<ListView dataSource={this.state.dataSource} renderRow={this._renderRow.bind(this)} />。

在绘制行的时候，比以前稍微有一点改动。行文本的外面套了一个View，并指定这个View的高度为50。

加上装饰

从如今来看，数据只有两行。若是不滑动一下的话，看起来和两个上下排列的Text没有什么区别。

首先咱们加一个分割线：

export default class DemoList extends React.Component {
  constructor() {
    //记得使用方法以前绑定
    this._renderSeparator = this._renderSeparator.bind(this);
  }
  _renderRow(rowData) {
    // ...略...
  }

  _renderSeparator(sectionID: number, rowID: number, adjacentRowHighlighted: bool) {
    return (
      <View key={`{sectionID}-${rowID}`}
        style={{height: 1, backgroundColor: 'black'}}>
      </View>
    );
  }
  render() {
    return (
      <ListView dataSource={this.state.dataSource}
        renderRow={this._renderRow}
        renderSeparator={this._renderSeparator}
        />
    );
  }
}

这里须要额外说明一些，在方法里_renderSeparator(sectionID: number, rowID: number, adjacentRowHighlighted: bool)我看看到了在参数的名称后面都有类型的说明。这个不是ES6的也不是js里的，而是FB本身搞的一套静态类型检查工具里的定义。这个工具叫Flow。

若是你从一开始就没打算跟flow扯上任何关系，那么就按照ES标准写就好。

至于分割线也是很是简单。咱们这就返回了一个高度一个像素的，背景色为黑色的view。

点击和高亮

Row的点击不想Native那样，默认的通常就有了。在RN里，咱们须要手动赋予一行能够被点击的功能。

_renderRow(rowData: string, sectionID: number, rowID: number, highlightRow: (sectionID: number, rowID: number) => void) {
    return (
      <TouchableHighlight onPress={() => {
        this._pressRow(rowID);
        highlightRow(sectionID, rowID);
      }}>
        <View style={styles.row}>
          <Text style={styles.text}>{rowData}</Text>
        </View>
      </TouchableHighlight>
    );
  }

在RN里处理通常点击的不二选择就是TouchableHighlight。在TouchableHighlight里的onPress里调用自定义的_pressRow方法处理点击，highlightRow方法高亮行。

固然，这里就少不了用到样式了：

const styles = StyleSheet.create({
  row: {
    flexDirection: 'row',
    justifyContent: 'center',
    padding: 10,
    backgroundColor: '#F6F6F6',
  },
  text: {
    flex: 1,
  },
  seperator: {
    height: 1,
    backgroundColor: '#CCCCCC'
  }
});

把Cell分离

在实际的开发中，通常没有人会把Row（或者行）的绘制和ListView放在一块儿。咱们这里就演示如何把Row的绘制分离出去。

首先建立一个单独的文件，定义Cell：

import React from 'react';
import {
  View,
  Text,
  TouchableHighlight,
  StyleSheet
} from 'react-native';


export default class DemoCell extends React.Component {
  render() {
    return (
      <View>
        <TouchableHighlight onPress={this.props.onSelect}>
          <View style={styles.row}>
            <Text style={styles.text}>{this.props.rowData}</Text>
          </View>
        </TouchableHighlight>
      </View>
    );
  }
};

const styles = StyleSheet.create({
  row: {
    flexDirection: 'row',
    justifyContent: 'center',
    padding: 10,
    backgroundColor: '#F6F6F6',
  },
  text: {
    flex: 1,
  },
});

Row也是一个组件，是一个组件就能够在另外的组建里渲染。因此，单独定义的Row就是这么用的。

回到demoList.js文件。在_renderRow方法中修改代码：

_renderRow(rowData: string, sectionID: number, rowID: number, highlightRow: (sectionID: number, rowID: number) => void) {
    return (
      // <TouchableHighlight onPress={() => {
      //   this._pressRow(rowID);
      //   highlightRow(sectionID, rowID);
      // }}>
      //   <View style={styles.row}>
      //     <Text style={styles.text}>{rowData}</Text>
      //   </View>
      // </TouchableHighlight>
      <DemoCell onSelect={() => {
         this._pressRow(rowID);
         highlightRow(sectionID, rowID);
       }} rowData={rowData}/>
    );
  }

结合网络请求

ListView在实战中，除非是Settings之类的界面，数据都是从网络请求获得的。上一节中正好已经讲述了如何使用RN内置的fetch请求网络数据。这一节中就是用fetch来请求dribbble的数据。

在使用dribbble的数据以前你须要注册，得到Access Token。这是请求认证所必须的。

export default class DemoList extends React.Component {

  constructor(props) {
    super(props);
    const ds = new ListView.DataSource({rowHasChanged: (r1, r2) => r1 !== r2});
    this.state = {
      isLoading: false,
      isLoadingTail: false,
      dataSource: new ListView.DataSource({
        rowHasChanged: (row1, row2) => row1 !== row2,
      }),
      filter: this.props.filter,
      queryNumber: 0,
    };
    //...略...
  }

  //...略...

  _getShots(query: string) {
    this.setState({
      isLoading: true,
      queryNumber: this.state.queryNumber + 1,
      isLoadingTail: false,
    });

    api.getShotsByType(query, 1).then((responseData) => {
      this.setState({
        isLoading: false,
        dataSource: this._getDataSource(responseData),
      });
    }).catch((error) => {
      this.LOADING[query] = false;
      this.resultsCache.dataForQuery[query] = undefined;

      this.setState({
          dataSource: this._getDataSource([]),
          isLoading: false,
      });
    });
  }

仍是在类DemoList里，其余可有可无的代码先略去。要紧的地方是须要注意在constructor里设置state的时候dataSource如何设置的。

state的改变会影响到组件的绘制。因此，在_getShots方法里，开始请求以前先设置一个默认的state状态。在请求成功以后使用setState设置一个，在catch到异常的时候再显示另一个。

在state里还有一个属性叫作isLoading: false,。这个是影控制Loading视图的。在false的时候隐藏，在true的时候显示。

那么loading界面是什么样呢？

<View style={{alignItems: 'center', justifyContent: 'center', flex: 1, backgroundColor: 'white'}}>
    <ActivityIndicator animating={true}
      style={[styles.centering]}
      size="large"
      color="#cccccc"
    />
</View>

组合起来

在类DemoList里组合相关代码：

_renderView() {
    if (this.state.isLoading) {
      return (
        <UNActivityIndicator loadingType={LOADING_TYPE.Large} />
      );
    }

    return (
      <View style={styles.container}>
        <ListView
          dataSource={this.state.dataSource}
          renderRow={this._renderRow}
          renderSeparator={this._renderSeparator}
          automaticallyAdjustContentInsets={false}
          />
      </View>
    );
  }

在renderView的时候，先检查state.isLoading，若是须要loading视图，那么返回loading视图，其余的不返回。数据加载成功以后state.isLoading被设置为false，那么显示ListView。

填坑完毕

以上就是处理ListView和其中的Cell的一些常见问题的方法。