小弹出能提供悬浮的更多信息.
安装
npm install @cleartrip/ct-design-tooltip
# or
pnpm add @cleartrip/ct-design-tooltip
同伴依赖关系
# Required for all targets
npm install react
# Web only
npm install react-dom
# React Native only
npm install react-native
使用量
基础
import { Tooltip } from '@cleartrip/ct-design-tooltip';
function Example() {
return (
<Tooltip>
{/* Basic usage */}
</Tooltip>
);
}
道具
| Prop | 类型 | 默认 | 需求 | 说明 |
children | ReactElement | —— 说 | 对 | 工具提示中要显示的内容 . |
labelContainer | ReactNode | —— 说 | 对 | 工具提示标签的容器 . |
tooltipWidth | number | —— 说 | 没有 | 工具提示的可选宽度 . |
职位
TOP 顶端
RIGHT - 对
BOTTOM 下层
LEFT 左边
AUTO 自动
覆盖边界Radius
XS —— xs (韩语)
SM - 闪电
MD (单位:千美元)
LG - lg (英语)
XL (单位:千美元)
覆盖类型
ENTER - ENTER(电视)
LEAVE - 离开
无障碍
- 构成部分遵循无障碍最佳做法
- 确保在需要时提供适当的ARIA属性
- 用屏幕读取器测试以确保可用性
移徙
如果从上一版本迁移:
- import { Tooltip } from 'yagami/core/components';
+ import { Tooltip } from '@cleartrip/ct-design-tooltip';
关于 @cleartrip/ct-design-tooltip 的常见问题
@cleartrip/ct-design-tooltip 是什么?
工具提示组件
如何安装 @cleartrip/ct-design-tooltip?
在项目目录运行 npm install @cleartrip/ct-design-tooltip,或使用 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-tooltip 支持 TypeScript 吗?
支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。
@cleartrip/ct-design-tooltip 支持 ESM 还是 CommonJS?
同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。
@cleartrip/ct-design-tooltip 可以商用吗?
@cleartrip/ct-design-tooltip 使用 ISC 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。
@cleartrip/ct-design-tooltip 的下载量有多少?
根据 npm 官方下载统计,@cleartrip/ct-design-tooltip 在 2026/10/10 – 2026/11/08 这 30 天内被下载 30,434 次,日均约 1,014 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。
@cleartrip/ct-design-tooltip 还在维护吗?
最新版本 5.32.0 发布于 2026/11/16(今天);至今共发布 1094 个版本,其中过去 12 个月发布了 671 个;首次发布于 2023/11/06。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。