@cloud-ru/ds-tooltip

中文文档
1.0.19发布于 2026/11/11Apache-2.0TypeScriptESM + CJS近 30 天下载 2.2万

\\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \.

中文使用文档
文档目录11 节
  1. Установка
  2. 工具提示
  3. Когда
  4. Анатомия
  5. Примеры
  6. 道具
  7. 问题工具
  8. Когда
  9. Анатомия
  10. Примеры
  11. 道具

工具提示

@cloud-ru/ds-tooltip \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \.

Пакет @cloud-ru/ds-tooltip 说吧

  • 工具提示 ——универсальная. {\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}##### ######### #### ###################################################################################################################################################################################################################.
  • 问题工具 {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你觉得呢.

Установка

pnpm add @cloud-ru/ds-tooltip
import { Tooltip, QuestionTooltip } from '@cloud-ru/ds-tooltip'

工具提示

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++.

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}弹出... Принимает children (сам:триггер也 tip (содержимое.

Когда

  • ================================================================================================ ============================================================================================================= (====== (=========================================.
  • {\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}你觉得怎么样? {\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}你觉得怎么样.
  • {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢.

Когда не нужен:длинного也. 过瘾 过瘾 过瘾 过瘾.

Анатомия

大小

xs {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}我.., s {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你觉得呢.

Примеры

1. 国家

重心+焦点 + + + + +

import { Tooltip } from '@cloud-ru/ds-tooltip';

export function Basic() {
  return (
    <Tooltip tip='Сохранить изменения'>
      <button type='button'>Сохранить</button>
    </Tooltip>
  );
}

2. 点击触发

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢

import { Tooltip } from '@cloud-ru/ds-tooltip';

export function ClickTrigger() {
  return (
    <Tooltip tip='Открывается по клику и остаётся видимой' trigger='click'>
      <button type='button'>Подробнее</button>
    </Tooltip>
  );
}

道具

工具提示

Prop类型默认说明
childrenChildrenFunction—— 说Триггер (подробнее)
classNamestring—— 说
closeOnPopstateboolean—— 说{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢
data-test-idstring—— 说
disableMaxWidthbooleanfalse{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢
disableSpanWrapperboolean—— 说Отключает isValidElement {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你觉得呢
{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢 position: absolute
{\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}♪############################# #######################################################################################################################################################################################################, forwardRef- компоненты
{\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你觉得呢 withInnerRefSupport из @cloud-ru/ds-utils{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢 <span> —— 说
{\fn黑体\fs20\shad2\2ah82\3ah20\4ah33\fscx95\3ch592001\be1}#####################################################################################################################################################################################################################################.
fallbackPlacementsPlacement—— 说{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢.
hoverDelayClosenumber0{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢
hoverDelayOpennumber0{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢
offsetnumber0[永久失效連結] (中文(简体) ).
onOpenChange((isOpen: boolean) => void)—— 说Колбек. 打开.
openboolean—— 说{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢.
placement"bottom" | "bottom-end" | "bottom-start" | "left" | "left-end" | "left-start" | "right" | "right-end" | "right-start" | "top" | "top-end" | "top-start"top(原始内容存档于2019-09-29) (中文(中国大陆) ).
tipReactNode—— 说Содержимое (текст)
trigger"click" | "clickAndFocusVisible" | "focus" | "focusVisible" | "hover" | "hoverAndFocus" | "hoverAndFocusVisible"hoverAndFocusVisible说吧
- 说吧 click - открывать по
- 说吧 hover - открывать по
- 说吧 focusVisible - 重点可见
- 说吧 focus - открывать по
- 说吧 hoverAndFocusVisible -=ytet -伊甸园字幕组=- 翻译:
- 说吧 hoverAndFocus - открывать ховеру и
- 说吧 clickAndFocusVisible -=ytet -伊甸园字幕组=- 翻译:
triggerClassNamestring—— 说CSS - класс триггера
triggerRefForwardedRef<HTMLElement | ReferenceType | null>—— 说参考文献:

问题工具

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢.

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得怎么样? Использует Tooltip * 触发按钮 * aria-label。 。 。 .

Когда

  • {\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}你觉得怎么样.
  • {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得怎样.
  • В.

Анатомия

大小

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢 xs - для плотных форм, s - дефолт с секций.

Примеры

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢

i- i- label 启动标签

import { QuestionTooltip } from '@cloud-ru/ds-tooltip';

export function Question() {
  return (
    <label style={{ display: 'inline-flex', gap: 8, alignItems: 'center' }}>
      <span>API-ключ</span>
      <input type='text' name='api-key' placeholder='sk_...' />
      <QuestionTooltip tip='Строка из 32 символов. Хранится зашифрованной, видна только владельцу.' />
    </label>
  );
}

道具

问题工具

Prop类型默认说明
childrenChildrenFunction—— 说Триггер (подробнее)
classNamestring—— 说
closeOnPopstateboolean—— 说{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢
data-test-idstring—— 说
disableMaxWidthbooleanfalse{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢
disableSpanWrapperboolean—— 说Отключает isValidElement {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你觉得呢
{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢 position: absolute
{\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}♪############################# #######################################################################################################################################################################################################, forwardRef- компоненты
{\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你觉得呢 withInnerRefSupport из @cloud-ru/ds-utils{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢 <span> —— 说
{\fn黑体\fs20\shad2\2ah82\3ah20\4ah33\fscx95\3ch592001\be1}#####################################################################################################################################################################################################################################.
fallbackPlacementsPlacement—— 说{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢.
hoverDelayClosenumber—— 说{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢
hoverDelayOpennumber—— 说{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢
offsetnumber0[永久失效連結] (中文(简体) ).
onOpenChange((isOpen: boolean) => void)—— 说Колбек. 打开.
openboolean—— 说{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢.
placement"bottom" | "bottom-end" | "bottom-start" | "left" | "left-end" | "left-start" | "right" | "right-end" | "right-start" | "top" | "top-end" | "top-start"top(原始内容存档于2019-09-29) (中文(中国大陆) ).
size"s" | "xs"xsРазмер
tabIndexnumber0标签索引
tipReactNode—— 说Содержимое (текст)
tooltipClassnamestring—— 说CSS - класс подсказки
trigger"click" | "clickAndFocusVisible" | "focus" | "focusVisible" | "hover" | "hoverAndFocus" | "hoverAndFocusVisible"hover说吧
- 说吧 click - открывать по
- 说吧 hover - открывать по
- 说吧 focusVisible - 重点可见
- 说吧 focus - открывать по
- 说吧 hoverAndFocusVisible -=ytet -伊甸园字幕组=- 翻译:
- 说吧 hoverAndFocus - открывать ховеру и
- 说吧 clickAndFocusVisible -=ytet -伊甸园字幕组=- 翻译:
triggerClassNamestring—— 说CSS - класс триггера
triggerLabelstringПодсказка{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢
triggerRefForwardedRef<HTMLElement | ReferenceType | null>—— 说参考文献:
  • Size =: "s" | "xs"

版本与发布记录

@cloud-ru/ds-tooltip 共发布 71 个版本,首次发布于 2026/08/18;过去 12 个月发布了 71 个版本。

版本发布日期距今
1.0.19latest2026/11/11今天
1.0.19-preview-e8fe6b56.0preview2026/11/11今天
1.0.19-preview-c0e895ed.02026/11/11今天
1.0.19-preview-90b10112.02026/11/11今天
1.0.19-preview-fd7dd437.02026/11/101 天前
1.0.19-preview-9a75a2a9.02026/11/101 天前

关于 @cloud-ru/ds-tooltip 的常见问题

@cloud-ru/ds-tooltip 是什么?

\\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \.

如何安装 @cloud-ru/ds-tooltip?

在项目目录运行 npm install @cloud-ru/ds-tooltip,或使用 pnpm add / yarn add / bun add。

@cloud-ru/ds-tooltip 支持 TypeScript 吗?

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

@cloud-ru/ds-tooltip 支持 ESM 还是 CommonJS?

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

@cloud-ru/ds-tooltip 可以商用吗?

@cloud-ru/ds-tooltip 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@cloud-ru/ds-tooltip 的下载量有多少?

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

@cloud-ru/ds-tooltip 还在维护吗?

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