Hover Card
从 Base Hover Card 协议投影出的 Shadcn Hover Card。
本页常规演示显式采用 Shadcn Rhea 外观,示例代码保持一致;这不修改公共组件的兼容默认值,也不代表全部浏览器、原生宿主和视觉验收已完成。Surface/Text 等中性原子仍保留各自公开语义,外观主题由消费组合提供。
Base Hover Card 持有 open。Root 接受受控 open 或非受控 defaultOpen,以及 openDelay 与 closeDelay。Trigger 的 hover/focus 和 Content 的 hover 只提交请求,不能绕过这个 owner。Content 另有 side、align 和下表的数值偏移。Arrow 与 forceMount 不是这个 surface 的属性。
演示在 150ms 后打开 @proto-ui,300ms 后关闭。Content 为 side="bottom"、align="center"。
正在加载交互示例… 正文和源码已可阅读,交互控件就绪后会显示在这里。
npx @proto.ui/cli@latest add wc shadcn-hover-card
把 wc 换成 react、vue 或 vue2,即可生成对应宿主的 facade。
传入 open 进入受控模式。延时必须是有限数且不小于 0,否则回落到默认值。
| 属性 | 类型 | 默认值 |
|---|---|---|
open | boolean undefined | 非受控 |
defaultOpen | boolean | false |
disabled | boolean | false |
openDelay | number | 700 |
closeDelay | number | 300 |
side | 'top' 'right' 'bottom' 'left' | bottom |
align | 'start' 'center' 'end' | center |
sideOffset | number | 4 |
alignOffset | number | 0 |
avoidCollisions | boolean | true |
collisionPadding | number | 0 |
side 到 collisionPadding 属于 Content。Trigger 只增加 disabled,默认 false。Root 暴露 open、openHoverCard、close、toggle 和 openChange。