在使用React和React-router实现单页面应用时,会有这样一个场景:从列表页面点击某项条目进入详情页,然后回退至列表页面时,列表页面会重新刷新,不仅数据重新获取了,滚动条也回到了顶部。用户要继续查看剩余数据的话,需要重新滑动到之前点击的那个条目,如果列表做了分页的话就更麻烦了,这对于用户体验来说是非常不好的。
所以我们希望能做到,从二级页面回退至列表页面时,列表页面能保留之前的状态(数据和滚动条位置)。
那么怎么实现呢?下面分享一下React通过redux来缓存列表数据以及滑动位置,以达到保留列表页面状态的方法。
关于redux以及react-redux的使用,这里就不做讲解了,可以参考我之前写的 React-redux的原理以及使用 。当然网络上有很多讲解得更清晰的文章,读者可以自行搜索。
下面直接进入正题,介绍实现需求的步骤吧
1、安装redux以及react-redux
cnpm install redux react-redux -dev –save
2、编写操作列表页面相关数据的action
/**
* Created by RaoMeng on 2018/12/10
* Desc: 列表数据缓存
*/
import {CLEAR_LIST_STATE, LIST_STATE} from "../constants/actionTypes";
import store from '../store/store'
/**
* 保存列表状态
* @param data
* @returns {Function}
*/
export const saveListState = (data) => {
return () => {
store.dispatch({
type: LIST_STATE,
...data
})
}
}
/**
* 清除列表状态
* @returns {Function}
*/
export const clearListState = () => {
return () => {
store.dispatch({
type: CLEAR_LIST_STATE
})
}
}
这里实现了两个actionType,一个是保存列表状态,一个是清除列表状态。
保存列表状态就是为了达到回退时不刷新页面的需求;
清除列表状态则是因为:从菜单页面进入列表页面时,是要求重新加载页面数据的,假如不清除redux中的缓存数据,页面就会读取缓存数据而不会重新请求网络数据,所以这个action也是很有必要的。
3、实现配合action操作state的reducer
import {CLEAR_LIST_STATE, LIST_STATE} from "../constants/actionTypes";
const initListState = {
scrollTop: 0,//列表滑动位置
listData: [],//列表数据
pageIndex: 1,//当前分页页码
itemIndex: -1,//点击的条目index
}
const redListState = (state = initListState, action) => {
if (action === undefined) {
return state
}
switch (action.type) {
case LIST_STATE:
//更新列表状态
return {
...state,
...action
}
case CLEAR_LIST_STATE:
//清空列表状态
return initListState
default:
return state
}
}
export default redListState
/**
* Created by RaoMeng on 2018/12/10
* Desc: 数据处理中心
*/
import {combineReducers} from 'redux'
import redUserInfo from './redUserInfo'
import redListState from './redListState'
import redClassData from './redClassData'
const reducers = combineReducers({redUserInfo, redListState, redClassData})
export default reducers
这里解释下为什么要记录分页页码以及点击的条目index。
记录分页页码只是在列表数据做了分页的情况下需要。是为了回退到列表页面后,用户继续上拉加载数据时页码是正确的。
记录点击的条目index则是为了能在详情页更新所点击的条目数据。比如说一个会议签到列表,用户点击某条数据进入详情页后,点击签到按钮,这时我们要根据itemIndex来调用action的saveListState()()方法更新缓存中相应的数据,将该条数据的状态改为已签到。这样回退至列表页面时,该条数据的展示才会正确。
4、创建store
import {createStore} from 'redux'
import reducers from '../reducers/index'
import {persistStore, persistReducer} from 'redux-persist';
import storage from 'redux-persist/lib/storage';
import autoMergeLevel2 from 'redux-persist/lib/stateReconciler/autoMergeLevel2';
const persistConfig = {
key: 'root',
storage: storage,
stateReconciler: autoMergeLevel2 // 查看 'Merge Process' 部分的具体情况
};
const myPersistReducer = persistReducer(persistConfig, reducers)
const store = createStore(myPersistReducer)
export const persistor = persistStore(store)
export default store
这里用到了redux-persist来实现redux数据的持久化存储,我在 React通过redux-persist持久化数据存储 有做简单讲解。
5、在点击条目的回调事件中调用saveListState方法保存列表状态
<父布局
ref={el => {
this.container = el
}}
> </父布局>
onItemClick = index => {
console.log('scrollTop', ReactDOM.findDOMNode(this.container).scrollTop)
saveListState({
scrollTop: ReactDOM.findDOMNode(this.container).scrollTop,
listData: this.state.meetingSignList,
pageIndex: mPageIndex,
itemIndex: index,
})()
const {meetingSignList} = this.state
this.props.history.push('/meet-detail/' + meetingSignList[index].meetId)
}
通过ReactDOM.findDOMNode(this.container).scrollTop来获取父布局的滑动距离
6、在页面的componentDidMount方法中获取redux数据
首先通过react-redux的connect方法将state中的数据绑定到页面的props中,方便访问
let mapStateToProps = (state) => ({
listState: {...state.redListState}
})
let mapDispatchToProps = (dispatch) => ({})
export default connect(mapStateToProps, mapDispatchToProps)(MeetingSignIn)
这样,在页面中就可以通过this.props.listState来访问redux中缓存的列表数据了
然后,在componentDidMount中获取缓存的列表数据,如果有缓存数据,则加载,如果没有则重新请求
componentDidMount() {
document.title = '会议管理'
console.log('listState', this.props.listState)
if (this.props.listState && !isObjEmpty(this.props.listState.listData)) {
this.setState({
meetingSignList: this.props.listState.listData,
isLoading: false,
}, () => {
ReactDOM.findDOMNode(this.container).scrollTop = this.props.listState.scrollTop
})
mPageIndex = this.props.listState.pageIndex
} else {
Toast.loading('数据加载中...', 0)
mPageIndex = 0
this.loadMeetList()
}
}
这样就实现了React通过redux缓存列表数据以及滑动位置,回退时恢复页面状态的需求。