组件表单

Field表单字段

查看源码components/field.go

垂直字段#

生产 Field 返回控件槽，预览填入生产 Input。

单独打开

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

用法
email := tree.ID(page, "email")
field := components.BeginField(canvas, theme, bounds).For(email)
control := field.Paint("Work email", "Used only for release notifications.", "")
components.PaintInput(canvas, theme, control, components.InputSnapshot{
    ID: email, Label: "Work email", Value: value,
})

响应式方向#

窄窗口垂直，宽窗口切换为水平布局。

单独打开

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

用法
email := tree.ID(page, "email")
field := components.BeginField(canvas, theme, bounds).For(email).
    Orientation(components.FieldResponsive)
control := field.Paint("Work email", "Used only for release notifications.", "")
components.PaintInput(canvas, theme, control, components.InputSnapshot{
    ID: email, Label: "Work email", Value: value,
})

错误状态#

必填、无效元数据与无效输入保持一致。

单独打开

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

用法
email := tree.ID(page, "email")
invalid := !strings.Contains(value, "@")
field := components.BeginField(canvas, theme, bounds).For(email).Required()
errorText := ""
if invalid {
    field = field.Invalid()
    errorText = "Enter a valid work email."
}
control := field.Paint("Work email", "Used only for release notifications.", errorText)
components.PaintInput(canvas, theme, control, components.InputSnapshot{
    ID: email, Label: "Work email", Value: value, Invalid: invalid,
})

安装

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

仓库命令
go run ./cmd/viva add --out ./components/local field

源码组件用法#

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

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

验证边界#

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

键盘操作

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