React Native 自定義下拉刷新上拉加載的列表的示例
在移動端開發(fā)中列表頁是非常常見的頁面,在React Native中我們一般使用FlatList或SectionList組件實現(xiàn)這些列表視圖。通常列表頁都會有大量的數(shù)據(jù)需要加載顯示,這時候就用到了分頁加載,因此對于列表組件來說,實現(xiàn)下拉刷新和上拉加載在很多情況下是必不可少的。
本篇文章基于FlatList封裝一個支持下拉刷新和上拉加載的RefreshListView,對原始的FlatList進行封裝之后,再調(diào)用上拉和下拉刷新就十分方便了。
下拉刷新的實現(xiàn)十分簡單,這里我們沿用FlatList本身的屬性來實現(xiàn)
onRefresh— 設置此選項后,則會在列表頭部添加一個標準的RefreshControl控件,以便實現(xiàn)“下拉刷新”的功能。同時你需要正確設置refreshing屬性。
refreshing—— bool值,用來控制刷新控件的顯示與隱藏。刷新完成后設為false。
通過這兩個屬性設置我們就可以實現(xiàn)FlatList頭部的刷新操作,控件使用默認的樣式,Android和iOS沿用各自系統(tǒng)的組件來顯示。
重點在于上拉加載更多,React Native的列表組件中沒有這個功能,需要我們自己實現(xiàn)。 對于上拉加載,通常我們有幾種狀態(tài),這里我創(chuàng)建一個RefreshState.js文件存放上拉加載的狀態(tài):
export default { Idle: 'Idle', // 初始狀態(tài),無刷新的情況 CanLoadMore: 'CanLoadMore', // 可以加載更多,表示列表還有數(shù)據(jù)可以繼續(xù)加載 Refreshing: 'Refreshing', // 正在刷新中 NoMoreData: 'NoMoreData', // 沒有更多數(shù)據(jù)了 Failure: 'Failure' // 刷新失敗 }
然后根據(jù)這幾種狀態(tài)來封裝一個RefreshFooter組件,使其根據(jù)不同狀態(tài)顯示不同內(nèi)容,廢話不多說上代碼:
import React, {Component} from 'react'; import {View, Text, ActivityIndicator, StyleSheet, TouchableOpacity} from 'react-native'; import RefreshState from './RefreshState'; import PropTypes from 'prop-types'; export default class RefreshFooter extends Component { static propTypes = { onLoadMore: PropTypes.func, // 加載更多數(shù)據(jù)的方法 onRetryLoading: PropTypes.func, // 重新加載的方法 }; static defaultProps = { footerRefreshingText: "努力加載中", footerLoadMoreText: "上拉加載更多", footerFailureText: "點擊重新加載", footerNoMoreDataText: "已全部加載完畢" }; render() { let {state} = this.props; let footer = null; switch (state) { case RefreshState.Idle: // Idle情況下為null,不顯示尾部組件 break; case RefreshState.Refreshing: // 顯示一個loading視圖 footer = <View style={styles.loadingView}> <ActivityIndicator size="small"/> <Text style={styles.refreshingText}>{this.props.footerRefreshingText}</Text> </View>; break; case RefreshState.CanLoadMore: // 顯示上拉加載更多的文字 footer = <View style={styles.loadingView}> <Text style={styles.footerText}>{this.props.footerLoadMoreText}</Text> </View>; break; case RefreshState.NoMoreData: // 顯示沒有更多數(shù)據(jù)的文字,內(nèi)容可以自己修改 footer = <View style={styles.loadingView}> <Text style={styles.footerText}>{this.props.footerNoMoreDataText}</Text> </View>; break; case RefreshState.Failure: // 加載失敗的情況使用TouchableOpacity做一個可點擊的組件,外部調(diào)用onRetryLoading重新加載數(shù)據(jù) footer = <TouchableOpacity style={styles.loadingView} onPress={()=>{ this.props.onRetryLoading && this.props.onRetryLoading(); }}> <Text style={styles.footerText}>{this.props.footerFailureText}</Text> </TouchableOpacity>; break; } return footer; } } const styles = StyleSheet.create({ loadingView: { flexDirection: 'row', justifyContent: 'center', alignItems: 'center', padding: 15, }, refreshingText: { fontSize: 12, color: "#666666", paddingLeft: 10, }, footerText: { fontSize: 12, color: "#666666" } });
注意,propTypes是我們給RefreshFooter組件定義的給外部調(diào)用的方法,方法類型需要使用PropTypes來指定,需要安裝facebook的prop-types依賴庫,最好使用 yarn add prop-types 安裝,不容易出錯。這里用作運行時的類型檢查,可以點擊這里 詳細了解。
defaultProps中我們定義了幾種不同狀態(tài)下默認的文本內(nèi)容,可以在外部傳值進行修改。
接下來就要來實現(xiàn)這個RefreshListView了。首先應該明確的是,這個RefreshListView要有頭部刷新和尾部刷新的調(diào)用方法,具體調(diào)用數(shù)據(jù)的方法應該在外部實現(xiàn)。先跟RefreshFooter一樣定義兩個方法:
static propTypes = { onHeaderRefresh: PropTypes.func, // 下拉刷新的方法,供外部調(diào)用 onFooterRefresh: PropTypes.func, // 上拉加載的方法,供外部調(diào)用 };
上面說到頭部的下拉刷新使用FlatList自帶特性實現(xiàn),我們需要定義一個bool值isHeaderRefreshing來作為refreshing屬性的值,控制頭部顯示與否。同時定義一個isFooterRefreshing來判斷尾部組件的刷新狀態(tài)。定義footerState用來設定當前尾部組件的state,作為RefreshFooter的值。
constructor(props) { super(props); this.state = { isHeaderRefreshing: false, // 頭部是否正在刷新 isFooterRefreshing: false, // 尾部是否正在刷新 footerState: RefreshState.Idle, // 尾部當前的狀態(tài),默認為Idle,不顯示控件 } }
render函數(shù)如下:
render() { return ( <FlatList {...this.props} onRefresh={()=>{ this.beginHeaderRefresh() }} refreshing={this.state.isHeaderRefreshing} onEndReached={() => { this.beginFooterRefresh() }} onEndReachedThreshold={0.1} // 這里取值0.1(0~1之間不包括0和1),可以根據(jù)實際情況調(diào)整,取值盡量小 ListFooterComponent={this._renderFooter} /> ) } _renderFooter = () => { return ( <RefreshFooter state={this.state.footerState} onRetryLoading={()=>{ this.beginFooterRefresh() }} /> ) };
可以看到上面的代碼中有beginHeaderRefresh和beginFooterRefresh兩個方法,這兩個方法就是用來調(diào)用刷新的,但是在刷新之前還有一些邏輯情況需要判斷。比如頭部和尾部不能夠同時刷新,不然數(shù)據(jù)處理結(jié)果可能受到影響,正在刷新時要防止重復的刷新操作,這些都是要考慮的。這里我在代碼中詳細注釋了:
/// 開始下拉刷新 beginHeaderRefresh() { if (this.shouldStartHeaderRefreshing()) { this.startHeaderRefreshing(); } } /// 開始上拉加載更多 beginFooterRefresh() { if (this.shouldStartFooterRefreshing()) { this.startFooterRefreshing(); } } /*** * 當前是否可以進行下拉刷新 * @returns {boolean} * * 如果列表尾部正在執(zhí)行上拉加載,就返回false * 如果列表頭部已經(jīng)在刷新中了,就返回false */ shouldStartHeaderRefreshing() { if (this.state.footerState === RefreshState.refreshing || this.state.isHeaderRefreshing || this.state.isFooterRefreshing) { return false; } return true; } /*** * 當前是否可以進行上拉加載更多 * @returns {boolean} * * 如果底部已經(jīng)在刷新,返回false * 如果底部狀態(tài)是沒有更多數(shù)據(jù)了,返回false * 如果頭部在刷新,則返回false * 如果列表數(shù)據(jù)為空,則返回false(初始狀態(tài)下列表是空的,這時候肯定不需要上拉加載更多,而應該執(zhí)行下拉刷新) */ shouldStartFooterRefreshing() { if (this.state.footerState === RefreshState.refreshing || this.state.footerState === RefreshState.NoMoreData || this.props.data.length === 0 || this.state.isHeaderRefreshing || this.state.isFooterRefreshing) { return false; } return true; }
其中startHeaderRefreshing和startFooterRefreshing的邏輯如下:
/// 下拉刷新,設置完刷新狀態(tài)后再調(diào)用刷新方法,使頁面上可以顯示出加載中的UI,注意這里setState寫法 startHeaderRefreshing() { this.setState( { isHeaderRefreshing: true }, () => { this.props.onHeaderRefresh && this.props.onHeaderRefresh(); } ); } /// 上拉加載更多,將底部刷新狀態(tài)改為正在刷新,然后調(diào)用刷新方法,頁面上可以顯示出加載中的UI,注意這里setState寫法 startFooterRefreshing() { this.setState( { footerState: RefreshState.Refreshing, isFooterRefreshing: true }, () => { this.props.onFooterRefresh && this.props.onFooterRefresh(); } ); }
在刷新之前,我們需要將頭部或尾部的組件顯示出來,然后再調(diào)用外部的數(shù)據(jù)接口方法。這里setState這樣寫的好處是state中的值更新完成后才會調(diào)用箭頭函數(shù)中的方法,是有嚴格順序的,如果把 this.props.onFooterRefresh && this.props.onFooterRefresh() 寫在setState外部,在UI上我們可能看不到頭部的loading或者尾部的努力加載中,接口方法就已經(jīng)調(diào)用完畢了。
最后,在刷新結(jié)束后我們還需要調(diào)用停止刷新的方法,使頭部或尾部組件不再顯示,否則一直是加載中還可能讓人以為是bug。下面看看停止刷新的方法:
/** * 根據(jù)尾部組件狀態(tài)來停止刷新 * @param footerState * * 如果刷新完成,當前列表數(shù)據(jù)源是空的,就不顯示尾部組件了。 * 這里這樣做是因為通常列表無數(shù)據(jù)時,我們會顯示一個空白頁,如果再顯示尾部組件如"沒有更多數(shù)據(jù)了"就顯得很多余 */ endRefreshing(footerState: RefreshState) { let footerRefreshState = footerState; if (this.props.data.length === 0) { footerRefreshState = RefreshState.Idle; } this.setState({ footerState: footerRefreshState, isHeaderRefreshing: false, isFooterRefreshing: false }) }
這里傳入一個尾部組件狀態(tài)的參數(shù)是為了更新尾部組件的樣式。同時對數(shù)據(jù)源data進行一個判斷,如果為空說明當前沒有數(shù)據(jù),可以顯示空白頁面,那么尾部組件也沒必要顯示了。
以下是我使用RefreshListView實現(xiàn)的豆瓣電影頁面分頁加載的效果圖:
以上就是本文的全部內(nèi)容,希望對大家的學習有所幫助,也希望大家多多支持腳本之家。
相關文章
React onBlur回調(diào)中使用document.activeElement返回body完美解決方案
這篇文章主要介紹了React onBlur回調(diào)中使用document.activeElement返回body完美解決方案,本文給大家介紹的非常詳細,對大家的學習或工作具有一定的參考借鑒價值,需要的朋友可以參考下2023-04-04react中實現(xiàn)修改input的defaultValue
這篇文章主要介紹了react中實現(xiàn)修改input的defaultValue方式,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教2023-05-05react-draggable實現(xiàn)拖拽功能實例詳解
這篇文章主要給大家介紹了關于react-draggable實現(xiàn)拖拽功能的相關資料,React-Draggable一個使元素可拖動的簡單組件,文中通過代碼示例介紹的非常詳細,需要的朋友可以參考下2023-08-08使用VScode 插件debugger for chrome 調(diào)試react源碼的方法
這篇文章主要介紹了使用VScode 插件debugger for chrome 調(diào)試react源碼,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧2019-09-09React實現(xiàn)歌詞滾動效果(跟隨音樂播放時間滾動)
這篇文章主要為大家詳細介紹了React實現(xiàn)歌詞滾動效果(跟隨音樂播放使勁按滾動),文中示例代碼介紹的非常詳細,具有一定的參考價值,感興趣的小伙伴們可以參考一下2024-02-02