列表显示数据，基本什么应用都是必须。笔者写作的时候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的一些常见问题的方法。
