Tooltip
Brutalist Tooltip 公开四个 Base Tooltip 投影入口:Group 继承同域 delay defaults、warm-window 与 active Tooltip 协调;Root 负责受控或非受控 open state;Trigger 负责 hover/focus 路由和无障碍描述关联;Content 负责 presence、锚定 portal 定位、Escape dismissal 与 role="tooltip"。
Group、Root 与 Trigger 是当前编目的 draft 透明投影,具有明确的 Brutalist package identity,且不新增第二套 props、state、timing、events、accessibility 或 visual owner。只有 Content 增加方形高对比 surface。上方交互示例通过一个真实 Group 组合两个非受控 sibling Tooltip,并可在 Web Components、React 与 Vue 之间切换。Content 通过 renderer-owned portal 保持挂载时,将文档 host 从 Light 切换到 Dark 会通过 --pui-foreground 与 --pui-background 重绘同一个 surface。
在 Button 上使用 Tooltip
Section titled “在 Button 上使用 Tooltip”可聚焦命令与 Tooltip 应共用一个 subject。将 draft authored hook useTooltipTrigger() 与命令行为组合,适配生成的原型,再把该组件直接放在 Tooltip Root 内与 Content 并列。不要用独立 Trigger 包裹另一个可聚焦 Button,否则会产生两个 Tab 停靠点。
import { definePrototype } from '@proto.ui/core';import { asButton, type ButtonProps, type ButtonExposes } from '@proto.ui/prototypes-base/button';import { useTooltipTrigger } from '@proto.ui/prototypes-base/tooltip';
export const tooltipButton = definePrototype<ButtonProps, ButtonExposes>({ name: 'app-tooltip-button', setup() { asButton(); useTooltipTrigger(); },});Button 保留 role、name、click signal、disabled state 与唯一焦点 owner;Tooltip 只追加 hover/focus intent 与自有 aria-describedby 关联。禁用 Tooltip Root 只关闭 Tooltip,命令仍可操作;禁用命令则同时抑制两者。useTooltipTrigger 没有 options,也不新增 outward exposes,要求同一 subject 已有焦点能力。独立 asTooltipTrigger 保留原焦点行为与 exposes。
复用已有样式原型时,可在 definePrototype 中保留该原型的静态 modules 声明,调用其 setup(def),再调用 useTooltipTrigger(),最后返回之前保存的 render function。这保留 family Button 呈现并只创建一个宿主;与下方独立 Trigger demo 的 passive action-body 样式工作分别追踪。
Tooltip 是工作区源码,没有公开的 proto-ui add 目标。传入 open 进入受控模式。
| 属性 | 类型 | 默认值 |
|---|---|---|
defaultOpen | boolean | false |
disabled | boolean | false |
openDelay | number | undefined |
closeDelay | number | undefined |
这些属性属于 Root。Trigger 的 disabled 默认 false。Content 接受 Transition 属性,side 默认 top,align 默认 center,sideOffset 默认 4,alignOffset 与 collisionPadding 默认 0,avoidCollisions 默认 true。Group 的 openDelay 默认 700,closeDelay 默认 100,skipDelay 默认 300。