Hover Card悬停卡片

查看源码components/hover_card.go

个人资料#

生产 HoverCard 根据锚点和视口放置预览。

启用 JavaScript 后可运行预览；源码和安装命令仍可直接查看。

trigger := f.Button(anchorID, "@viva-framework").Outline().Width(180)
if canvas.Hovered() == anchorID {
    card := components.BeginHoverCard(canvas, theme, viewport, trigger.Rect(), components.HoverCardOptions{
        Layer: 1, Side: components.HoverCardBottom, BodyHeight: 24,
    })
    layout := card.Begin("Viva Framework", "Go-first, GPU-native desktop UI.")
    canvas.Label("Native • Retained", layout.Body, labelStyle)
    card.End()
}

侧边放置#

右侧放置在窄视口会自动限制到边缘。

启用 JavaScript 后可运行预览；源码和安装命令仍可直接查看。

trigger := f.Button(anchorID, "@viva-framework").Outline().Width(180)
card := components.BeginHoverCard(canvas, theme, viewport, trigger.Rect(), components.HoverCardOptions{
    Layer: 1, Side: components.HoverCardRight, Align: components.HoverCardAlignCenter,
    ContentSize: ui.Size{Width: min(280, size.Width-32)}, BodyHeight: 24,
})
layout := card.Begin("Viva Framework", "Placed right and clamped to the viewport.")
canvas.Label("@viva-framework", layout.Body, labelStyle)
card.End()

禁用触发器#

禁用声明不绘制预览表面。

启用 JavaScript 后可运行预览；源码和安装命令仍可直接查看。

trigger := f.Button(anchorID, "@viva-framework").Outline().Width(180)
card := components.BeginHoverCard(canvas, theme, viewport, trigger.Rect(),
    components.HoverCardOptions{Layer: 1, Side: components.HoverCardBottom}).Disabled()
card.Paint("Viva Framework", "A disabled trigger shows no preview.")

安装

将组件源码复制到自己的项目，直接修改。

go run ./cmd/viva add --out ./components/local hover-card

源码组件用法#

此预览直接调用生产 Go 组件。稳定 ID、值与打开状态仍由应用持有；组件只负责绘制并声明交互语义。

标题旁的源码链接列出了全部选项与视觉决策。
请使用原生命令验证系统文本、焦点、无障碍与平台集成。
浏览器预览验证共享布局和场景行为，不代表原生性能。

验证边界#

示例覆盖当前 API 的代表性状态，但不表示每个桌面后端都已完成真机验证。

键盘操作

Tab 在控件间移动；Ctrl/⌘ K 搜索组件。进入预览后，键盘事件由 Go 运行时处理。