Spin 加载中
用于页面和区块的加载中状态。
何时使用
页面局部处于等待异步数据或正在渲染过程时,合适的加载动效会有效缓解用户的焦虑。
代码演示
基本用法
一个简单的 loading 状态。
import React from 'react';
import ReactDOM from 'react-dom';
import { Spin } from 'choerodon-ui';
ReactDOM.render(<Spin />, document.getElementById('container'));
各种大小
小的用于文本加载,默认用于卡片容器级加载,大的用于页面级加载。
import React from 'react';
import ReactDOM from 'react-dom';
import { Spin } from 'choerodon-ui';
ReactDOM.render(
<div>
<Spin size="small" />
<Spin />
<Spin size="large" />
</div>,
document.getElementById('container'));
容器
放入一个容器中。
import React from 'react';
import ReactDOM from 'react-dom';
import { Spin } from 'choerodon-ui';
ReactDOM.render(
<div className="example">
<Spin />
</div>,
document.getElementById('container'));
卡片加载中
可以直接把内容内嵌到 Spin
中,将现有容器变为加载状态。
import React from 'react';
import ReactDOM from 'react-dom';
import { Spin, Switch, Alert } from 'choerodon-ui';
class Card extends React.Component {
state = { loading: false }
toggle = (value) => {
this.setState({ loading: value });
}
render() {
return (
<div>
<Spin spinning={this.state.loading}>
<Alert
message="Alert message title"
description="Further details about the context of this alert."
type="info"
/>
</Spin>
<div style={{ marginTop: 16 }}>
Loading state:<Switch checked={this.state.loading} onChange={this.toggle} />
</div>
</div>
);
}
}
ReactDOM.render(<Card />, document.getElementById('container'));
自定义描述文案
自定义描述文案。
import React from 'react';
import ReactDOM from 'react-dom';
import { Spin, Alert } from 'choerodon-ui';
ReactDOM.render(
<Spin tip="Loading...">
<Alert
message="Alert message title"
description="Further details about the context of this alert."
type="info"
/>
</Spin>,
document.getElementById('container'));
延迟
延迟显示 loading 效果。当 spinning 状态在 delay
时间内结束,则不显示 loading 状态。
import React from 'react';
import ReactDOM from 'react-dom';
import { Spin, Alert, Switch } from 'choerodon-ui';
class Card extends React.Component {
state = { loading: false }
toggle = (value) => {
this.setState({ loading: value });
}
render() {
const container = (
<Alert
message="Alert message title"
description="Further details about the context of this alert."
type="info"
/>
);
return (
<div>
<Spin spinning={this.state.loading} delay={500}>{container}</Spin>
<div style={{ marginTop: 16 }}>
Loading state:<Switch checked={this.state.loading} onChange={this.toggle} />
</div>
</div>
);
}
}
ReactDOM.render(<Card />, document.getElementById('container'));
自定义指示符
使用自定义指示符。
import React from 'react';
import ReactDOM from 'react-dom';
import { Spin } from 'choerodon-ui';
const c7nIcon = (
<span className="custom-spin-dot">
<i />
<i />
<i />
<i />
</span>
);
ReactDOM.render((
<div>
<Spin indicator={c7nIcon} size="small" />
<Spin indicator={c7nIcon} />
<Spin indicator={c7nIcon} size="large" />
</div>
), document.getElementById('container'));
API
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
delay | 延迟显示加载效果的时间(防止闪烁) | number (毫秒) | - |
indicator | 加载指示符 | ReactElement | - |
size | 组件大小,可选值为 small default large | string | ‘default’ |
spinning | 是否旋转 | boolean | true |
tip | 当作为包裹元素时,可以自定义描述文案 | string | - |
wrapperClassName | 包装器的类属性 | string | - |
当前内容版权归 Choerodon UI 或其关联方所有,如需对内容或内容相关联开源项目进行关注与资助,请访问 Choerodon UI .