react-native-page-listview
对ListView/FlatList的封装,可以很方便的分页加载网络数据,还支持自定义下拉刷新View和上拉加载更多的View.兼容高版本FlatList和低版本ListVIew.组件会根据你使用的react-native的版本自动选择(高版本使用FlatList,低版本使用ListView)
github地址: https://github.com/geek-prince/react-native-page-listview
npm地址: https://www.npmjs.com/package/react-native-page-listview
安装
npm install react-native-page-listview --save
如何使用
下面说明中的'组件'指的就是当前这个'react-native-page-listview'组件.
首先导入组件
import PageListView from 'react-native-page-listview';
1.不分页,不从网络获取数据(用于本地数组数据的展示)
这时你只需要给组件传递一个数组
let arr=[你要在ListView上展示的数据数组]
在render方法中使用该组件
renderRow
方法中需要你指定每一行数据的展示View,与ListView/FlatList
的renderRow/renderItem
方法相同
renderRow(rowData,index){
return(你的View展示 );
}
refresh
方法中指定需要展示数据的数组
refresh=(callBack)=>{
callBack(arr);
}
2.不分页,从网络获取数据(用于网络数组数据不多,后端接口没有用分页时)
这时与上面使用方法一致,只需要更改一下refresh
方法
refresh=(callBack)=>{
fetch(url)
.then((response)=>response.json())
.then((responseData)=>{
//根据接口返回结果得到数据数组
let arr=responseData.result;
callBack(arr);
});
}
以上这两种方式渲染结果如下(没有下拉刷新和上拉更多):
3.从网络获取数据并分页,不自定义上拉刷新,下拉加载更多View(用于数据较多,需要分页请求数据时)
这时你需要给组件一下几个属性pageLen
,renderRow
,refresh
,loadMore
.
pageLen
指定你每次调用后端分页接口可以获得多少条数据.
renderRow
使用方法和上面相同,渲染每一行的展示.
refresh
方法会在你组件一开始加载和你下拉刷新时调用,所以你在这个方法中需要将你从后端分页接口的第一页请求返回的数据通过回调传给组件.
refresh=(callBack)=>{
fetch(分页接口url+'?page=1')
.then((response)=>response.json())
.then((responseData)=>{
//根据接口返回结果得到数据数组
let arr=responseData.result;
callBack(arr);
});
}
loadMore
方法会在你下拉加载更多时调用,这时除了callBack
还会传给你另一个参数page
表示即将要加载的分页数据是第几页,这时你只需要根据page
把相应第几页的数组数据通过回调传给组件就行.
loadMore=(page,callback)=>{
fetch(分页接口url+'?page='+page)
.then((response)=>response.json())
.then((responseData)=>{
//根据接口返回结果得到数据数组
let arr=responseData.result;
callBack(arr);
});
};
这种情况下显示的渲染效果为:
4.从网络获取数据并分页,并且自定义下拉刷新,上拉加载更多View
渲染下拉刷新View使用renderRefreshView
,且此时需要给定它的高度renderRefreshViewH
,渲染加载更多View使用renderLoadMore
,渲染没有更多数据的View使用renderNoMore
.
renderRefreshView=()=>{
return(
//你对渲染下拉刷新View的代码
);
};
renderLoadMore=()=>{
return(
//你对渲染加载更多View的代码
);
};
renderNoMore=()=>{
return(
//你对渲染没有更多数据时View的代码
);
};
这种情况下显示的渲染效果为:
拓展
如果你想实现更好看更绚丽的下拉刷新效果,可以像下面这样使用renderRefreshView
.
pullState
会根据你下拉的状态给你返回相应的字符串:
-
''
: 没有下拉动作时的状态 -
'pulling'
: 正在下拉并且还没有拉到指定位置时的状态 -
'pullOk'
: 正在下拉并且拉到指定位置时并且没有松手的状态 -
'pullRelease'
: 下拉到指定位置后并且松手后的状态
renderRefreshView=(pullState)=>{
switch (pullState){
case 'pullOk':
return
//下拉刷新,下拉到指定的位置时,你渲染的View
;
break;
case 'pullRelease':
return
//下拉刷新,下拉到指定的位置后,并且你松手后,你渲染的View
;
break;
case '':
case 'pulling':
default:
return
//下拉刷新,你正在下拉时还没有拉到指定位置时(或者默认情况下),你渲染的View
;
break;
}
};
这种情况下显示的渲染效果为:
有时候我们不一定会直接渲染从后端取回来的数据,需要对数据进行一些处理,这时可以在组件中加入dealWithDataArrCallBack
属性来对数组数据进行一些处理.下面是把从后端取回来的数组进行顺序的颠倒.
{return arr.reverse()}}
/>
另外,FlatList
中有个属性为ItemSeparatorComponent
是设置每一行View之间分割的View的,自己觉得不错就写到组件里了,兼容ListView
.
属性一览表:
props | 作用 |
---|---|
renderRow | 处理"渲染FlatList/ListView的每一行"的方法 |
refresh | 处理"下拉刷新"或"一开始加载数据"的方法 |
loadMore | 处理"加载更多"的方法 |
pageLen | 每个分页的数据数 |
dealWithDataArrCallBack | 如果需要在用当前后端返回的数组数据进行处理的话,传入回调函数 |
renderLoadMore | 还有数据可以从后端取得时候渲染底部View的方法 |
renderNoMore | 没有数据(数据已经从后端全部加载完)是渲染底部View的方法 |
renderRefreshView | 渲染下拉刷新的View样式 |
renderRefreshViewH | 渲染下拉刷新的View样式的高度 |
ItemSeparatorComponent | 渲染每行View之间的分割线View |
height | 指定组件宽高,不指定时组件flex:1自适应宽高 |
width | 指定组件宽高,不指定时组件flex:1自适应宽高 |
FlatList/ListView自身的属性 | 是基于FlatList/ListView,所以可以直接使用他们自身的属性 |
注意:如果屏幕下方有绝对定位的View时,这时组件自适应宽高,下面的一部分内容会被遮挡,这时一个很好的解决方法是在组件下方渲染一个与绝对定位等高的透明View来解决(
如果大家觉得我的组件好用的话,帮到你的话,欢迎大家Star,Fork,如果有什么问题的话也可以在github中想我提出,谢谢大家的支持.