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`。
```js
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>
);
}
希望这些对你们有用。
React Native填坑之旅 -- FlatList的更多相关文章
- React Native填坑之旅--与Native通信之iOS篇
终于开始新一篇的填坑之旅了.RN厉害的一个地方就是RN可以和Native组件通信.这个Native组件包括native的库和自定义视图,我们今天主要设计的内容是native库方面的只是.自定义视图的使 ...
- React Native填坑之旅--Flow篇(番外)
flow不是React Native必会的技能,但是作为正式的产品开发优势很有必要掌握的技能之一.所以,算是RN填坑之旅系列的番外篇. Flow是一个静态的检查类型检查工具,设计之初的目的就是为了可以 ...
- React Native填坑之旅--布局篇
代码在这里: https://github.com/future-challenger/petshop/tree/master/client/petshop/src/controller 回头看看RN ...
- React Native填坑之旅--组件生命周期
这次我们来填React Native生命周期的坑.这一点非常重要,需要有一个清晰的认识.如果你了解Android或者iOS的话,你会非常熟悉我们今天要说的的内容. 基本上一个React Native的 ...
- React Native填坑之旅--重新认识RN
如同黑夜里的一道光一样,就这么知道了F8. F8是每年一次Facebook每年一次的开发者大会.每次大会都会release相应的APP,iOS.Android都有.之前都是用Native开发的,但是2 ...
- React Native填坑之旅--Navigation篇
React Native的导航有两种,一种是iOS和Android通用的叫做Navigator,一种是支持iOS的叫做NavigatorIOS.我们这里只讨论通用的Navigator.会了Naviga ...
- React Native填坑之旅--ListView篇
列表显示数据,基本什么应用都是必须.今天就来从浅到深的看看React Native的ListView怎么使用.笔者写作的时候RN版本是0.34. 最简单的 //@flow import React f ...
- React Native填坑之旅--动画
动画是提高用户体验不可缺少的一个元素.恰如其分的动画可以让用户更明确的感知当前的操作是什么. 无疑在使用React Native开发应用的时候也需要动画.这就需要知道RN都给我们提供了那些动画,和每个 ...
- React Native填坑之旅--Button篇
从React过来,发现React Native(以下简称RN)居然没有Button.隔壁的iOS是有UIButton的,隔壁的隔壁的Android里也是有的.没有Button,就没有点击效果啊.这还真 ...
随机推荐
- AMS常见问题
1.安装完AMS是否就可以实现直播点播了? 答:是的,ams运行后,就可以提供各种协议的直播输出地址,和点播地址:不过一般情况下客户还得需要另外的Web系统来配合使用,来完成对前台用户界面的友好化 ...
- Servlet--ServletException类,UnavailableException类
ServletException类 定义 public class ServletException extends Exception 当 Servlet 遇到问题时抛出的一个异常. 构造函数 pu ...
- 【转】globk通常的应用
1.重复性分析(glred) -单独的观测期 -联合的观测期 2.联合多期数据得到基于实验的平均位置 -联合单独观测的测站 3.联合平均位置估计速度或地震偏移和震后运动 卡尔曼滤波 1.等同于序贯最小 ...
- Git版本管理的简介与安装[一]
标签(linux): git 笔者Q:972581034 交流群:605799367.有任何疑问可与笔者或加群交流 git简介 很多人都知道,Linus在1991年创建了开源的Linux,从此,Lin ...
- 【转】GPS误差来源
一.与GPS卫星有关的误差 1.卫星时钟误差 即使卫星是非常的精密复杂,它可以计算出一些极微小的讯息信息,如原子钟(Cesium) 即是如此一个精准的装置,但是精准并不代表完美,因此仍会有一些微小的误 ...
- Sql Server的艺术(三) SQL聚合函数的应用
SQL提供的聚合函数有求和,最大值,最小值,平均值,计数函数等. 聚合函数及其功能: 函数名称 函数功能 SUM() 返回选取结果集中所有值的总和 MAX() 返回选取结果集中所有值的最大值 MIN( ...
- java中的二叉树排序问题
原创:转载请注明出处 目的:想用java实现二叉树排序算法 思想:利用java中面向对象的思想,即: Tree:类 树根Tree:root //static所属于每一个Tree 左节点Tree:lef ...
- Java源码分析系列之HttpServletRequest源码分析
从源码当中 我们可以 得知,HttpServletRequest其实 实际上 并 不是一个类,它只是一个标准,一个 接口而已,它的 父类是ServletRequest. 认证方式 public int ...
- HTTP/1.1与HTTP/1.0的区别[转]
原文链接:http://blog.csdn.net/forgotaboutgirl/article/details/6936982 下面主要从几个不同的方面介绍HTTP/1.0与HTTP/1.1之间的 ...
- python基础 列表 的使用
列表 首先定义一个列表 声明列表 列表名字=[值1,值2] list=[1,2,3,4,5] 这是一个列表,列表中有五个元素(1,2,3,4,5) 显示list列表 print list 输出 ...