# @cleartrip/ct-design-components 中文文档

规范地址：https://npmcn.com/package/%40cleartrip/ct-design-components/

版本：5\.32\.0
npm 元数据更新时间：2026-11-16T13:02:47.521Z
中文译文更新时间：2026-11-16T13:06:12.595Z
软件包许可：ISC

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cleartrip/ct-design-components
原文对照：https://npmcn.com/package/%40cleartrip/ct-design-components/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：114 kB，333 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：69 个
- peer 依赖：react \>=16\.8\.0，react-dom \>=16\.8\.0，react-native \>=0\.68\.0
- 首次发布：2023-10-25T15:48:31.745Z
- 最新版本发布：2026-11-16T13:02:47.237Z
- 近 30 天下载量：19119（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：1210（近 12 个月 667 个）

## 中文简介

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

## 安装

```sh
npm install @cleartrip/ct-design-components
```

也可以使用：`pnpm add @cleartrip/ct-design-components`、`yarn add @cleartrip/ct-design-components`、`bun add @cleartrip/ct-design-components`

## README

# @ cleartrip/ct-design- 组件

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

[![Version](https://img.shields.io/npm/v/@cleartrip/ct-design-components.svg)](https://www.npmjs.com/package/@cleartrip/ct-design-components) [![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)

## 概览

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

## 安装

```bash
# 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`(中文(简体) )
-   **事件处理**: 鼠标事件、点击处理器和布局更改调用
-   **无障碍**: 重点管理和衡量能力
-   **样式**: 自定义样式配置及设计系统集成

#### 基本用途

```tsx
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>
  );
}
```

#### 快速反馈

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

#### 高级使用参考文献

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

### 集装箱参考方法

| 方法 | 说明 |
| --- | --- |
| `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` - 身份证

[参见完整组件列表](https://design.cleartrip.com/components)

## 浏览器支持

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

## 模块格式

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

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

## 发展

```bash
# Build the package
pnpm build-package

# Watch for changes during development
pnpm watch-package

# Clean build
pnpm build-package:clean
```

## 捐款

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

## 许可证

公务员制度委员会

## 更改日志

见 [变动情况](https://npmcn.com/package/%40cleartrip/ct-design-components/CHANGELOG.md) 用于版本历史和更新.

* * *

**清航设计系统** | [文档](https://design.cleartrip.com/) | [构成部分库](https://design.cleartrip.com/components) | [GitHub 图像](https://github.com/cleartrip/ct-design-system)

## 常见问题

### @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 和提交记录判断。

