@cleartrip/ct-design-components

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

Cleartrip 设计系统的核心组件集, 并带有跨平台的 React and React 原生支持

中文使用文档
文档目录19 节
  1. 概览
  2. 安装
  3. 构成部分
  4. 集装箱
  5. API 参考
  6. 集装箱道具
  7. 集装箱参考方法
  8. 相关软件包
  9. 核心组成部分
  10. 窗体组件
  11. 导航
  12. 反馈
  13. 数据显示
  14. 浏览器支持
  15. 模块格式
  16. 发展
  17. 捐款
  18. 许可证
  19. 更改日志

@ cleartrip/ct-design- 组件

Cleartrip 设计系统的核心组件收藏

Version License: ISC

概览

@cleartrip/ct-design-components 是Cleartrip Design系统中的一款基础软件包,为React和React Independent应用程序提供基本的UI组件并有跨平台支持. 这个软件包侧重于核心布局和容器组件,具有诸如随机反馈支持等高级特性.

安装

# npm
npm install @cleartrip/ct-design-components

# yarn  
yarn add @cleartrip/ct-design-components

# pnpm
pnpm add @cleartrip/ct-design-components

构成部分

集装箱

具有多功能的集装箱部分,作为基础布局要素,支持随机反馈、事件处理和灵活造型.

特征

  • 跨平台: 在回放和回放上无缝工作
  • 快速反馈: 以自定义的强度构建随机反馈支持
  • 弹性渲染: 支持多种 HTML 语义元素(main, (中文(简体) ), section, (中文(简体) ), article, (中文(简体) ), div, (中文(简体) ), p(中文(简体) )
  • 事件处理: 鼠标事件、点击处理器和布局更改调用
  • 无障碍: 重点管理和衡量能力
  • 样式: 自定义样式配置及设计系统集成

基本用途

import { Container } from '@cleartrip/ct-design-components';

function App() {
  return (
    <Container
      as="main"
      onClick={(event) => console.log('Container clicked')}
      styleConfig={{
        root: [{ padding: '16px', backgroundColor: '#f5f5f5' }]
      }}
    >
      <h1>Welcome to Cleartrip</h1>
      <p>Your content goes here...</p>
    </Container>
  );
}

快速反馈

<Container
  hapticEnabled={true}
  hapticVariant="subtle"
  hapticRepeat={false}
  onClick={() => console.log('Haptic feedback triggered')}
>
  Interactive content with haptic feedback
</Container>

高级使用参考文献

import { Container, ContainerRef } from '@cleartrip/ct-design-components';
import { useRef } from 'react';

function MyComponent() {
  const containerRef = useRef<ContainerRef>(null);

  const handleFocus = () => {
    containerRef.current?.focus();
  };

  const measureContainer = () => {
    containerRef.current?.measure((x, y, width, height, pageX, pageY) => {
      console.log('Container dimensions:', { x, y, width, height, pageX, pageY });
    });
  };

  return (
    <Container
      ref={containerRef}
      onLayout={(event) => console.log('Layout changed:', event.layout)}
      onMouseEnter={() => console.log('Mouse entered')}
      onMouseLeave={() => console.log('Mouse left')}
    >
      Content with measurement and event handling
    </Container>
  );
}

API 参考

集装箱道具

Prop类型默认说明
idstring- 说吧HTML id 属性
childrenReact.ReactNode- 说吧儿童要素
as'main' | 'section' | 'article' | 'div' | 'p''div'要渲染的 HTML 元素类型
showScrollIndicatorboolean- 说吧显示滚动指标( 反应原生)
onClick(event: unknown) => void- 说吧单击事件处理器
onLayout(event: LayoutEvent) => void- 说吧版式更改处理器( React Introduction)
onMouseEnterMouseEventHandler<HTMLElement>- 说吧鼠标输入处理器
onMouseLeaveMouseEventHandler<HTMLElement>- 说吧鼠标离开处理器
onTransitionEnd() => void- 说吧过渡端处理器
styleConfig{ root?: Styles[] }- 说吧自定义样式配置
hapticEnabledbooleanfalse启用随机反馈
hapticVariant'subtle' | 'loud''subtle'快速反馈强度
hapticRepeatbooleanfalse重复随机反馈

集装箱参考方法

方法说明
focus()聚焦容器元素
getBoundingRectWithCallback(callback?)用回调连接到矩形
measure(callback)测量容器尺寸和位置
getElementRef()获取基本元素参考

Cleartrip设计系统包括60+专用组件包:

核心组成部分

  • @cleartrip/ct-design-button - 按钮组件
  • @cleartrip/ct-design-typography - 文字和打字
  • @cleartrip/ct-design-card - 卡片布局
  • @cleartrip/ct-design-box - 布局容器

窗体组件

  • @cleartrip/ct-design-field - 表格字段
  • @cleartrip/ct-design-checkbox - 复选框
  • @cleartrip/ct-design-radio - 无线电按钮
  • @cleartrip/ct-design-dropdown - 下放菜单

导航

  • @cleartrip/ct-design-nav-tabs - 导航标签
  • @cleartrip/ct-design-breadcrumb - 面包屑导航

反馈

  • @cleartrip/ct-design-toast - 敬酒通知
  • @cleartrip/ct-design-modal - 模块对话框
  • @cleartrip/ct-design-tooltip - 工具提示
  • @cleartrip/ct-design-spinner - 装入指标

数据显示

  • @cleartrip/ct-design-accordion - 可折叠的内容
  • @cleartrip/ct-design-carousel - 内容旋转木马
  • @cleartrip/ct-design-rating - 明星收视率
  • @cleartrip/ct-design-badge - 身份证

参见完整组件列表

浏览器支持

  • 反应: 16.8.0或以上
  • 反应 DOM: 16.8.0或以上
  • 原生反应: 0.68.0或更高(可选择的同伴依赖)

模块格式

此软件包支持多个模块格式 :

  • ES 模块数字 : dist/ct-design-components.esm.js
  • 常见JS数字 : dist/ct-design-components.cjs.js
  • 浏览器: 优化浏览器构建可用
  • 类型脚本: 包含全部类型脚本定义

发展

# Build the package
pnpm build-package

# Watch for changes during development
pnpm watch-package

# Clean build
pnpm build-package:clean

捐款

这个包是Cleartrip设计系统的一部分. 关于捐款准则,请参见主要储存库文件.

许可证

公务员制度委员会

更改日志

见 变动情况 用于版本历史和更新.


清航设计系统 | 文档 | 构成部分库 | GitHub 图像

版本与发布记录

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

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

其他发布通道:SNAPSHOT-CAROUSEL → 2.2.0-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-components 的常见问题

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

Cleartrip 设计系统的核心组件集, 并带有跨平台的 React and React 原生支持

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

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

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

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

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

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

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

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

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

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

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