提示框
一个基于 React Aria 的浅色表面工具提示 - 它在悬停和聚焦时打开,翻转以保持在屏幕上,将插入符号指向其触发器,并在进出时从 0.9 开始模糊 + 缩放。将鼠标悬停在下面的任意按钮上。
职位
工具提示可以位于其触发器的任何一侧 - 设置 placement 支撑 Tooltip 到 top (默认), bottom, left 或 right。插入符号和模糊变换会旋转以匹配,如果屏幕上没有空间,React Aria 会自动翻转到另一侧。将鼠标悬停在下面的按钮上。
每个工具提示都以相同的方式打开,无论哪一侧:您将鼠标悬停或键盘聚焦 TooltipTrigger。触发器的第一个孩子是您指向的东西(这里是我们的 Button,包裹在 Focusable 所以一个简单的 <button> 成为有效的触发器),并且 Tooltip 旁边是弹出的内容。所以左侧的工具提示就是 placement="left" - 交互没有任何变化:
<TooltipTrigger delay={0}> <Focusable> <Button variant="secondary">Top</Button> </Focusable> <Tooltip placement="top">Top</Tooltip></TooltipTrigger>CLI 将组件源(及其内部依赖项)复制到您的项目中并安装任何所需的 npm 包。
npx boardui@latest add tooltip使用共享 UI 包或自定义导入别名? 配置您的安装路径 在运行 CLI 之前。复制粘贴示例使用默认导入。
尺寸
工具提示有 2 种尺寸: sm (12px 标题 1,默认值 - 由贡献热图使用)和 md (14px 主体 1,具有更宽敞的填充)。通过改变来切换 size 支撑在 Tooltip - 比较 小 和 中 在上面的预览中触发。
<Tooltip size="sm">12 contributions on April 26</Tooltip>目录
工具提示是建立在 React Aria,因此触发器的单个子组件必须是可聚焦组件(react-aria Button,或任何使用 useFocusable)。悬停和键盘焦点都可以打开它, Escape 关闭它,触发器得到 aria-describedby 自动连接到工具提示。我们将讨论以下主题:
- 基本工具提示
- 放置和插入符
- 箭头和偏移属性
- 打开/关闭延迟
- 模糊和缩放过渡
对于实际使用,请将方块悬停在 ContributionsCard - 每个细胞都是一个 TooltipTrigger 显示其日期和计数。