跳至正文

Hover card

悬停时打开、展示预览内容的卡片。

浏览器
Chrome 114+Firefox 125+Safari 17+
层级
1
压缩后大小
1.92 kB
强制布局预算
0 ms
axe 预算
0
支持 SSR
是
公开契约
测试环境

交互示例

Hover Card

Closed

UIify

Native-first React components with accessible semantics and optional styles.

Open-source · React 19 · Server compatible

Open

@uiify
UIify

Native-first React components with accessible semantics and optional styles.

Open-source · React 19 · Server compatible

API

HoverCard.Root

属性类型默认值说明
openboolean—受控打开状态。
defaultOpenbooleanfalse非受控的初始打开状态。
onOpenChangePopoverChangeHandler—使用下一个打开状态及变更原因详情调用。
openDelaynumber700卡片打开前,指针必须停留在触发器上的毫秒数。
closeDelaynumber300指针离开后到卡片关闭前的毫秒数,便于将指针移到卡片上。
idstring—锚点和内容的基础id;省略时自动生成。
childrenReactNode—Trigger和Content组成部分。

HoverCard.Trigger

属性类型默认值说明
classNamestring—应用于触发器元素的类名。
childrenReactNode—触发器元素的内容。
asElementType"button"使用其他元素或组件替代默认标签渲染。
renderReactElement | ((props, state) => ReactElement)—替换渲染元素,同时保留行为和无障碍连接关系。

HoverCard.Content

属性类型默认值说明
side"top" | "right" | "bottom" | "left""bottom"卡片锚定于触发器的哪一侧。
align"start" | "center" | "end""center"卡片沿所选侧边的对齐方式。
classNamestring—应用于卡片容器的类名。
childrenReactNode—卡片内容。
asElementType"div"使用其他元素或组件替代默认标签渲染。
renderReactElement | ((props, state) => ReactElement)—替换渲染元素,同时保留行为和无障碍连接关系。

键盘

按键操作
Tab将焦点移入或移出控件
Enter / Space获得焦点时激活(按钮类控件)

无障碍

尽可能使用语义化HTML。可在交互示例中检查渲染的标记;仅在原生元素无法满足需求时添加ARIA。

样式钩子

data-disabled
本页由机器翻译,尚未经人工审核。