react 下拉刷新上拉加载更多通用组件
作者:互联网
react 下拉刷新上拉加载更多通用组件
Mathilda91于 2017-03-17 00:01:53 发布1321 收藏 4 文章标签: javascript ui 版权react-pullLoad
React 版本的 pullLoad 下拉更新 上拉加载更多 组件
pullLoad 非 react 版本,支持 require.js 模块化调用
示例
demo1 document.body 作为容器
demo2 ReactPullLoad 根节点 DOM 作为容器
demo3 document.body 作为容器 且自定义刷新和加载更多 UI 组件
当前版本 1.0.0
简介
-
只依赖 react/react-dom
-
样式使用 less 编写
-
支持 body 或者组件根 DOM 固定高度作为外部容器 contianer(即可视区域大小)
-
触摸事件绑定在内容块 content(即高度为 auto 的DOM )
-
纯 React 组件方式开发的
-
支持自定义刷新和加载更多 UI 组件
-
支持代码动态调起刷新和加载更多(组件将展示刷新和加载更多样式)
-
只支持移动触摸设备
功能点
-
下拉距离大于阈值触发刷新动作
-
滚动到距底部距离小于阈值加载更多
-
支持自定义刷新和加载更多 UI 组件
使用说明
npm install --save react-pullload
- import ReactPullLoad,{ STATS } from 'react-pullload'
- export class App extends Component{
- constructor(){
- super();
- this.state ={
- hasMore: true,
- data: cData,
- action: STATS.init,
- index: loadMoreLimitNum //loading more test time limit
- }
- }
- handleAction = (action) => {
- console.info(action, this.state.action,action === this.state.action);
- //new action must do not equel to old action
- if(action === this.state.action){
- return false
- }
- if(action === STATS.refreshing){//刷新
- this.handRefreshing();
- } else if(action === STATS.loading){//加载更多
- this.handLoadMore();
- } else{
- //DO NOT modify below code
- this.setState({
- action: action
- })
- }
- }
- handRefreshing = () =>{
- if(STATS.refreshing === this.state.action){
- return false
- }
- setTimeout(()=>{
- //refreshing complete
- this.setState({
- data: cData,
- hasMore: true,
- action: STATS.refreshed,
- index: loadMoreLimitNum
- });
- }, 3000)
- this.setState({
- action: STATS.refreshing
- })
- }
- handLoadMore = () => {
- if(STATS.loading === this.state.action){
- return false
- }
- setTimeout(()=>{
- if(this.state.index === 0){
- this.setState({
- action: STATS.reset,
- hasMore: false
- });
- } else{
- this.setState({
- data: [...this.state.data, cData[0], cData[0]],
- action: STATS.reset,
- index: this.state.index - 1
- });
- }
- }, 3000)
- this.setState({
- action: STATS.loading
- })
- }
- render(){
- const {
- data,
- hasMore
- } = this.state
- const fixHeaderStyle = {
- position: "fixed",
- width: "100%",
- height: "50px",
- color: "#fff",
- lineHeight: "50px",
- backgroundColor: "#e24f37",
- left: 0,
- top: 0,
- textAlign: "center",
- zIndex: 1
- }
- return (
- <div>
- <div style={fixHeaderStyle}>
- fixed header
- </div>
- <ReactPullLoad
- downEnough={150}
- action={this.state.action}
- handleAction={this.handleAction}
- hasMore={hasMore}
- style={{paddingTop: 50}}
- distanceBottom={1000}>
- <ul className="test-ul">
- <button onClick={this.handRefreshing}>refreshing</button>
- <button onClick={this.handLoadMore}>loading more</button>
- {
- data.map( (str, index )=>{
- return <li key={index}><img src={str} alt=""/></li>
- })
- }
- </ul>
- </ReactPullLoad>
- </div>
- )
- }
- }
参数说明:
参数 | 说明 | 类型 | 默认值 | 备注 |
---|---|---|---|---|
action | 用于同步状态 | string | isRequired | |
handleAction | 用于处理状态 | func | isRequired | |
hasMore | 是否还有更多内容可加载 | bool | false | 在 onl oadMore reject() 之后设置 |
downEnough | 下拉距离是否满足要求 | num | 100 | |
distanceBottom | 距离底部距离触发加载更多 | num | 100 | |
isBlockContainer | 是否开启使用组件根 DOM 作为外部容器 contianer | bool | false | |
HeadNode | 自定义顶部刷新 UI 组件 | any | ReactPullLoad HeadNode | 必须是一个 React 组件 |
FooterNode | 自定义底部加载更多 UI 组件 | any | ReactPullLoad FooterNode | 必须是一个 React 组件 |
另外 ReactPullLoad 组件支持根属性扩展 例如: classNamestyle 等等
STATS list
属性 | 值 | 根节点 className | 说明 |
---|---|---|---|
init | '' | 组件初始状态 | |
pulling | 'pulling' | state-pulling | 下拉状态 |
enough | 'pulling enough' | state-pulling.enough | 下拉并且已经满足阈值 |
refreshing | 'refreshing' | state-refreshing | 刷新中(加载数据中) |
refreshed | 'refreshed' | state-refreshed | 完成刷新动作 |
reset | 'reset' | state-reset | 恢复默认状态 |
loading | 'loading' | state-loading | 加载中 |
init/reset -> pulling -> enough -> refreshing -> refreshed -> reset
init/reset -> pulling -> reset
init/reset -> loading -> reset
自定义刷新及加载组件
请参考默认刷新及加载组件源码(通过 css 根节点不同 className 设置对应 UI 样式来实现)
ReactPullLoad HeadNode
ReactPullLoad FooterNode
或参考 demo3 中的实现方式在组件内容通过获取的 loaderState 与 STATS 不同状态对比来现实
License
MIT
标签:reset,STATS,react,组件,state,上拉,action,加载 来源: https://www.cnblogs.com/sexintercourse/p/15916033.html