@cleartrip/ct-design-button

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

按钮组件是网络开发中用于创建交互元素的可再用用户界面元素,用户可以点击或点击来进行动作.

中文使用文档
文档目录14 节
  1. 安装
  2. 同伴依赖关系
  3. 使用量
  4. 基础
  5. 有变体
  6. 带有大小
  7. 带有图标
  8. 装入状态
  9. 道具
  10. 备选案文
  11. 大小
  12. 颜色
  13. 无障碍
  14. 移徙

按钮

按钮组件是网络开发中用于创建交互元素的可再用用户界面元素,用户可以点击或点击来进行动作.


安装

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

同伴依赖关系

# Required for all targets
npm install react

# Web only
npm install react-dom

# React Native only
npm install react-native

使用量

基础

import { Button, ButtonVariant, ButtonColor, ButtonSize } from '@cleartrip/ct-design-button';

function Example() {
  return <Button onClick={() => console.log('clicked')}>Click me</Button>;
}

有变体

<Button variant={ButtonVariant.CONTAINED} color={ButtonColor.PRIMARY}>
  Contained Button
</Button>

<Button variant={ButtonVariant.OUTLINE} color={ButtonColor.SECONDARY}>
  Outline Button
</Button>

<Button variant={ButtonVariant.BARE}>
  Bare Button
</Button>

带有大小

<Button size={ButtonSize.SMALL}>Small Button</Button>
<Button size={ButtonSize.MEDIUM}>Medium Button</Button>
<Button size={ButtonSize.LARGE}>Large Button</Button>

带有图标

<Button
  showLeftIcon={true}
  LeftIcon={<MyIcon />}
>
  Button with left icon
</Button>

<Button
  showRightIcon={true}
  RightIcon={<MyIcon />}
>
  Button with right icon
</Button>

装入状态

<Button loading={isLoading}>{isLoading ? 'Loading...' : 'Submit'}</Button>

道具

Prop类型默认需求说明
childrenReactNode—— 说对按钮内容
onClick() => void—— 说没有单击处理器功能
variantButtonVariantCONTAINED没有按钮的视觉样式
sizeButtonSizeMEDIUM没有按钮的大小
colorButtonColorPRIMARY没有按钮的颜色方案
disabledbooleanfalse没有是否禁用按钮
loadingbooleanfalse没有是否显示装入状态
isFullWidthbooleanfalse没有按钮是否取出全宽
minWidthstring50px没有按钮最小宽度
showLeftIconbooleanfalse没有是否显示左侧图标
LeftIconReactElement—— 说没有左侧图标元素
showRightIconbooleanfalse没有是否显示正确的图标
RightIconReactElement—— 说没有右图标元素

备选案文

  • CONTAINED — 以背景颜色填充的按钮
  • OUTLINE – 有边框的按钮, 无背景
  • BARE — 仅文本按钮,没有背景或边框

大小

  • SMALL – 紧缺空间的压缩按钮
  • MEDIUM —— 标准按钮大小( 默认)
  • LARGE - 需要强调的大按钮

颜色

  • PRIMARY ——主要品牌颜色
  • SECONDARY 二级配色方案
  • TERTIARY - 三级颜色方案
  • NEUTRAL 中性/灰色颜色方案
  • SUCCESS 绿色,用于确认/核准行动
  • DANGER 红色,用于破坏/拒绝行动

无障碍

  • 按钮包括适当的 ARIA 属性
  • 已禁用按钮无法聚焦
  • 正在装入按钮宣布屏幕阅读器状态
  • 确保所有变体的色彩对比度
  • 图标应有适当的备选案文或ARIA标签

移徙

如果从以前的版本迁移:

- import { Button } from 'yagami/core/components';
+ import { Button, ButtonVariant, ButtonColor, ButtonSize } from '@cleartrip/ct-design-button';

版本与发布记录

@cleartrip/ct-design-button 共发布 1,055 个版本,首次发布于 2023/10/25;过去 12 个月发布了 671 个版本。

版本发布日期距今
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今天
3.33.0-SNAPSHOT-hdp-revamp-v3.02026/11/124 天前
3.33.0-SNAPSHOT-hdp-revamp-v2.02026/11/124 天前
5.32.0-SNAPSHOT-biztrip-rn-sme-snapshot-11-11-26.02026/11/115 天前

其他发布通道:SNAPSHOT-ITINERARY-OTP-CAROUSEL → 2.1.1-SNAPSHOT-ITINERARY-OTP-CAROUSEL.0,SNAPSHOT-ITINERARY → 2.1.1-SNAPSHOT-ITINERARY.0,SNAPSHOT-ITINERARY-OUTSIDECLICK → 2.1.1-SNAPSHOT-ITINERARY-OUTSIDECLICK.0,SNAPSHOT-DRAWERV2 → 2.3.0-SNAPSHOT-DRAWERV2.0,SNAPSHOT-ITINERARYFIX → 2.3.0-SNAPSHOT-ITINERARYFIX.0,SNAPSHOT-3DCAROUSEL → 2.4.0-SNAPSHOT-3DCAROUSEL.0。

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

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

按钮组件是网络开发中用于创建交互元素的可再用用户界面元素,用户可以点击或点击来进行动作.

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

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

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

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

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

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

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

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

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

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

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