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 组件方式开发的
只支持移动触摸设备
功能点
使用说明
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 | 在 onLoadMore 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 样式来实现)
或参考 demo3 中的实现方式在组件内容通过获取的 loaderState 与 STATS 不同状态对比来现实
License
MIT