@cleartrip/ct-design-activity-indicator

中文文档
5.32.0发布于 2026/11/16ISCTypeScriptESM + CJS近 30 天下载 8318

活动指示器组件——网络上CSS自旋器和本地平台自旋器上React Introduct,通过Ct-design-style-manager悬钩来作风格.

中文使用文档
文档目录16 节
  1. 安装
  2. 同伴依赖关系
  3. 使用量
  4. 基础
  5. 带有自定义属性
  6. 有条件显示
  7. 样式覆盖
  8. 道具
  9. 大小选项
  10. 样式
  11. 槽数
  12. 平台差异
  13. 网页
  14. 原生反应
  15. 无障碍
  16. 移徙

活动指标

活性指示器是一个显示加载状态的自旋组件. 它在网络上使用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类型默认需求说明
animatingbooleantrue没有旋转器是否应该动画化.
colorstring—— 说没有旋者前相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相 回落到当前
hidesWhenStoppedbooleantrue没有指标是否应隐藏何时 animating 是虚假的.
size`"小"号大个编号`'small'
styleConfigActivityIndicatorStyleConfigProps—— 说没有计算样式后的可选样式覆盖

大小选项

  • 'small' 20px旋转器
  • 'large' 36px旋转器
  • number — 自定义像素大小

样式

这个 styleConfig 界面允许精细的样式定制 :

interface ActivityIndicatorStyleConfigProps {
  root?: Styles[] | Styles[];
  spinner?: Styles[] | Styles[];
}

槽数

槽说明
rootRoot 包装元件( 中央容器) 使用的样式
spinner适用于旋转元素本身的样式

平台差异

网页

  • 用 CSS 动画 @keyframes
  • 以 CSS 为主的自定义颜色和大小旋转器

原生反应

  • 使用平台的本地活动指示器
  • 继承特定平台的样式和行为

无障碍

  • 旋转器在不动画时会自动隐藏在屏幕阅读器中
  • 考虑添加 aria-label 或者说 aria-describedby 酌情改为母要素
  • 与合适的装入状态和公告一起使用,以便更好的UX

移徙

如果从 Yagami 或以前版本迁移:

- import { ActivityIndicator } from 'yagami/core/components';
+ import { ActivityIndicator } from '@cleartrip/ct-design-activity-indicator';

版本与发布记录

@cleartrip/ct-design-activity-indicator 共发布 317 个版本,首次发布于 2026/04/29;过去 12 个月发布了 317 个版本。

版本发布日期距今
5.32.0latest2026/11/16今天
5.32.0-SNAPSHOT-5.32.0-SNAPSHOT-bs-height-check-161120161537.02026/11/16今天
5.32.0-SNAPSHOT-bs-height-check-151120162243.02026/11/16今天
5.32.0-SNAPSHOT-biztrip-rn-sme-snapshot-11-11-26.02026/11/115 天前
5.32.0-SNAPSHOT-native-main.22026/11/115 天前
5.32.0-SNAPSHOT-native-main.02026/11/0313 天前

其他发布通道:SNAPSHOT-test → 4.0.0-SNAPSHOT-test.0,SNAPSHOT-rnfinaltest → 4.0.0-SNAPSHOT-rnfinaltest.0,SNAPSHOT-rnfinaltest2 → 4.0.0-SNAPSHOT-rnfinaltest2.0,SNAPSHOT-rnfinaltest3 → 4.0.0-SNAPSHOT-rnfinaltest3.0,SNAPSHOT-rnfinaltest4 → 4.0.0-SNAPSHOT-rnfinaltest4.0,SNAPSHOT-rnfinaltest5 → 4.0.0-SNAPSHOT-rnfinaltest5.0。

关于 @cleartrip/ct-design-activity-indicator 的常见问题

@cleartrip/ct-design-activity-indicator 是什么?

活动指示器组件——网络上CSS自旋器和本地平台自旋器上React Introduct,通过Ct-design-style-manager悬钩来作风格.

如何安装 @cleartrip/ct-design-activity-indicator?

在项目目录运行 npm install @cleartrip/ct-design-activity-indicator,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>=16.8.0)、react-dom(>=16.8.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@cleartrip/ct-design-activity-indicator 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@cleartrip/ct-design-activity-indicator 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@cleartrip/ct-design-activity-indicator 可以商用吗?

@cleartrip/ct-design-activity-indicator 使用 ISC 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@cleartrip/ct-design-activity-indicator 的下载量有多少?

根据 npm 官方下载统计,@cleartrip/ct-design-activity-indicator 在 2026/10/10 – 2026/11/08 这 30 天内被下载 8,318 次,日均约 277 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@cleartrip/ct-design-activity-indicator 还在维护吗?

最新版本 5.32.0 发布于 2026/11/16(今天);至今共发布 317 个版本,其中过去 12 个月发布了 317 个;首次发布于 2026/04/29。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。