Aspect Ratio宽高比

查看源码components/aspect_ratio.go

16:9 预览#

通过生产布局函数计算媒体区域高度。

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

ratio := float32(16.0 / 9.0)
width := min(size.Width-48, float32(520))
height := components.AspectRatio(ui.Rect{Width: width}, ratio).Height
media := f.Slot().Size(width, height)
bounds := components.AspectRatio(media.Rect(), ratio)
canvas.Rounded(bounds, theme.Metrics.RadiusSurface, theme.Muted)

方形封面#

同一 API 使用 1:1 比例。

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

width := min(size.Width-48, float32(250))
height := components.AspectRatio(ui.Rect{Width: width}, 1).Height
media := f.Slot().Size(width, height)
bounds := components.AspectRatio(media.Rect(), 1)
canvas.Rounded(bounds, theme.Metrics.RadiusSurface, theme.Muted)

安装

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

go run ./cmd/viva add --out ./components/local aspect-ratio

源码组件用法#

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

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

验证边界#

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

键盘操作

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