@cleartrip/ct-design-stepper

中文文档
5.13.0发布于 2026/11/16ISCTypeScriptESM + CJS近 30 天下载 1.2万

步进组件

中文使用文档
文档目录11 节
  1. 安装
  2. 同伴依赖关系
  3. 使用量
  4. 作为进度跟踪器
  5. 作为静态列表
  6. 有分步骤
  7. 道具
  8. ISTEPERStep 系统
  9. 步态
  10. 阶梯级
  11. 无障碍

步进

一个垂直的阶梯,使一个阶梯列表具有可选的分阶级别. 它可以起到进度跟踪器的作用,完成的步子会带出一个勾子,而即将到来的步子会变哑;也可以起静态的步子列表来解释一行.


安装

npm install @cleartrip/ct-design-stepper
# or
pnpm add @cleartrip/ct-design-stepper

同伴依赖关系

# Required for all targets
npm install react

# Web only
npm install react-dom

# React Native only
npm install react-native

使用量

作为进度跟踪器

activeStep 标记焦点的步骤 workflowStep 使完成.

import { Stepper } from '@cleartrip/ct-design-stepper';

function Example() {
  return (
    <Stepper
      steps={[{ label: 'Request booking' }, { label: 'Approval' }, { label: 'Book' }]}
      activeStep={1}
      workflowStep={1}
    />
  );
}

作为静态列表

isStatic 使每个步骤都具有同样的中性,而忽略了进度指数,因为这些步骤解释了一种流动而不是跟踪.

<Stepper
  isStatic
  steps={[
    { label: 'Request booking', subtitle: 'Pick a hotel and raise a request' },
    { label: 'Approval', subtitle: 'Your approver reviews the request' },
    { label: 'Book', subtitle: 'Complete the booking once approved' },
  ]}
/>

有分步骤

子步骤只在目前活动的步骤下扩展.

<Stepper
  steps={[
    { label: 'Traveller details' },
    {
      label: 'Payment',
      hasChildren: true,
      subSteps: [{ label: 'Select mode' }, { label: 'Confirm' }],
    },
  ]}
  activeStep={1}
  workflowStep={1}
  activeSubStep={0}
  workflowSubStep={0}
/>

道具

Prop类型默认需求说明
stepsIStepperStep[][]对步骤,从上到下.
activeStepnumber0没有焦点步骤索引.
activeSubStepnumber0没有主动步骤内焦点分步索引.
workflowStepnumber0没有在本索引完成前的步骤.
workflowSubStepnumber0没有在本索引完成之前的分步骤.
isStaticbooleanfalse没有渲染出每一步中和并忽略了进度指数.
styleConfigIStepperStyleConfig{}没有Root、行、图标、标签和垂直行的样式覆盖.

ISTEPERStep 系统

外地类型需求说明
labelstring对台阶标签.
subtitlestring没有标签下的副线.
hasChildrenboolean没有当活动时步骤是否扩展为子步骤 .
subStepsIStepperSubStep[]没有分步骤,只在步骤活动时才被提供.
onClick() => void没有在按下步骤的图标或标签时被放出.

步态

  • DONE 完成:有滴答的绿色圆形
  • CURRENT 重点:突出标签的圆形
  • PENDING — 即将到来: 圆形和标签
  • NEUTRAL ——无进展关系,被使用 isStatic

阶梯级

  • OUTER - 一个顶级步骤
  • INNER ——分步骤

无障碍

  • 构成部分遵循无障碍最佳做法
  • 确保在需要时提供适当的ARIA属性
  • 用屏幕读取器测试以确保可用性

版本与发布记录

@cleartrip/ct-design-stepper 共发布 780 个版本,首次发布于 2023/11/06;过去 12 个月发布了 365 个版本。

版本发布日期距今
5.13.0latest2026/11/16今天
5.13.0-SNAPSHOT-5.32.0-SNAPSHOT-bs-height-check-161120161537.02026/11/16今天
5.13.0-SNAPSHOT-bs-height-check-151120162243.02026/11/16今天
3.33.0-SNAPSHOT-hdp-revamp-v3.02026/11/124 天前
3.33.0-SNAPSHOT-hdp-revamp-v2.02026/11/124 天前
5.13.0-SNAPSHOT-biztrip-rn-sme-snapshot-11-11-26.02026/11/115 天前

其他发布通道:SNAPSHOT-CAROUSEL → 2.1.1-SNAPSHOT-CAROUSEL.0,SNAPSHOT-ITINERARY-OTP-CAROUSEL → 2.2.0-SNAPSHOT-ITINERARY-OTP-CAROUSEL.2,SNAPSHOT-ITINERARY → 2.2.0-SNAPSHOT-ITINERARY.2,SNAPSHOT-ITINERARY-OUTSIDECLICK → 2.2.0-SNAPSHOT-ITINERARY-OUTSIDECLICK.2,SNAPSHOT-SPINNER → 2.1.1-SNAPSHOT-SPINNER.0,SNAPSHOT-DRAWERV2 → 2.3.0-SNAPSHOT-DRAWERV2.0。

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

@cleartrip/ct-design-stepper 是什么?

步进组件

如何安装 @cleartrip/ct-design-stepper?

在项目目录运行 npm install @cleartrip/ct-design-stepper,或使用 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-stepper 支持 TypeScript 吗?

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

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

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

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

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

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

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

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

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