1.0.6 • Published 7 years ago
troila-mobie-web-utils v1.0.6
ws-web-utils
Can only be used internally for the project
Install
$ npm install --save ws-web-utilsAPI
stateHoc([options])(Component)
stateHoc是一个高阶组件,用于处理业务组件的等待、请求、异常处理显示等...
[options] (Object)
Loading(Class/Func): loading状态下的显示组件Failure(Class/Func): failure状态下的显示组件Error(Class/Func): error状态下的显示组件NullData(Class/Func): nullData状态下的显示组件detail(Boolean): 如果 true ,则会通过hocDetailKey来获得key值用来处理渲染判断hocDetailKey(Function): 要求返回一个string类型的值,这个值是props.fetchStatus的渲染键名fetchStatus(String or Object):default模式下要求是string类型,遵循fetchStatus渲染规则(如下)。detail模式下要求是object类型,取object[key]来用于判断渲染,遵循fetchStatus渲染规则(如下)hocNullDataFunc(Function): 默认null,如果设置,则需要返回一个boolean值,用于判断是否显示NullData组件
Component
子组件下的成员方法
hocComponentDidMount(Function): 如果存在,会在高级组件的render后像componentDidMount一样的生命周期执行,常用语fetch请求等
Examples
import {stateHoc,fetchStatus} from 'ws-web-utils'
import { connect } from "react-redux";
//默认模式
@connect(()=>({
fetchStatus: fetchStatus.s
}))
@stateHoc()
class HourseDetail extends Component{
hocComponentDidMount() {
//todo more
}
render(){
return <div>success</div>
}
}
//detail模式
@connect(()=>({
fetchStatus: {
'1': fetchStatus.s
}
}))
@stateHoc({
detail: true
})
class HourseDetail extends Component{
hocDetailKey(){
return '1'
}
hocComponentDidMount() {
//todo fetch
}
render(){
return <div>success</div>
}
}fetchStatus (Object)
lloadingffailureeerrorssuccess
Examples
import {fetchStatus} from 'ws-web-utils'
console.log(fetchStatus)
/*
{
l: 'loading',
f: 'failuer',
e: 'error',
s: 'success',
}
*/fetchStatus渲染规则
fetchStatus.lrender LoadingfetchStatus.frender FailurefetchStatus.erender ErrorfetchStatus.srender 包裹的组件
废旧文档 (忽略以下)
stateHoc API (props , params)
options Config
| Param | Default | Type | Description |
|---|---|---|---|
| Loading | Loading | Class/Func | 等待状态 |
| Failure | Failure | Class/Func | 失败状态 |
| Error | Error | Class/Func | 错误状态 |
| detail | false | Boolean | 使用场景是多个state |
| keyFunc | undefined | Func | detail==true时有效,捆绑key生效 |
| key | undefined | String | detail==true时有效,取值唯一标识 |
| height | undefined | Number | LoadingView的height props |
Props Config
| Prop | Default | Type | Description |
|---|---|---|---|
| fetchStatus | undefined | String | 详见内部FetchStatus |
| orther props | ...this.props | Object | ... |