活动指标
活性指示器是一个显示加载状态的自旋组件. 它在网络上使用CSS动画,在React Introduct上使用本土平台回旋器.
安装
npm install @cleartrip/ct-design-activity-indicator
# or
pnpm add @cleartrip/ct-design-activity-indicator
同伴依赖关系
# Required for all targets
npm install react
# Web only
npm install react-dom
# React Native only
npm install react-native
使用量
基础
import { ActivityIndicator } from '@cleartrip/ct-design-activity-indicator';
function Example() {
return (
<ActivityIndicator />
);
}
带有自定义属性
<ActivityIndicator
size="large"
color="#007bff"
animating={true}
/>
有条件显示
<ActivityIndicator
animating={isLoading}
hidesWhenStopped={true}
size="small"
/>
样式覆盖
<ActivityIndicator
styleConfig={{
root: [{ backgroundColor: '#f0f0f0', padding: 20 }],
spinner: [{ borderWidth: 3 }],
}}
/>
道具
| Prop | 类型 | 默认 | 需求 | 说明 |
|---|---|---|---|---|
animating | boolean | true | 没有 | 旋转器是否应该动画化. |
color | string | —— 说 | 没有 | 旋者前相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相 回落到当前 |
hidesWhenStopped | boolean | true | 没有 | 指标是否应隐藏何时 animating 是虚假的. |
size | `"小"号 | 大个 | 编号` | 'small' |
styleConfig | ActivityIndicatorStyleConfigProps | —— 说 | 没有 | 计算样式后的可选样式覆盖 |
大小选项
'small'20px旋转器'large'36px旋转器number— 自定义像素大小
样式
这个 styleConfig 界面允许精细的样式定制 :
interface ActivityIndicatorStyleConfigProps {
root?: Styles[] | Styles[];
spinner?: Styles[] | Styles[];
}
槽数
| 槽 | 说明 |
|---|---|
root | Root 包装元件( 中央容器) 使用的样式 |
spinner | 适用于旋转元素本身的样式 |
平台差异
网页
- 用 CSS 动画
@keyframes - 以 CSS 为主的自定义颜色和大小旋转器
原生反应
- 使用平台的本地活动指示器
- 继承特定平台的样式和行为
无障碍
- 旋转器在不动画时会自动隐藏在屏幕阅读器中
- 考虑添加
aria-label或者说aria-describedby酌情改为母要素 - 与合适的装入状态和公告一起使用,以便更好的UX
移徙
如果从 Yagami 或以前版本迁移:
- import { ActivityIndicator } from 'yagami/core/components';
+ import { ActivityIndicator } from '@cleartrip/ct-design-activity-indicator';