Form表单

查看源码components/form.go

账户字段#

生产 FormFieldLayout 与生产 Input 组合。

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

username := tree.ID(page, "username")
field := components.PaintFormField(canvas, theme, bounds, components.FormFieldSnapshot{
    Label:       "Username",
    Description: "This name is visible to collaborators.",
    Required:    true,
    ControlID:   username,
})
components.PaintInput(canvas, theme, field.Control, components.InputSnapshot{
    ID: username, Label: field.Semantics.Label,
    Value: value, Hint: field.Semantics.AssistiveText(),
})

帮助消息#

字段说明和服务端消息由调用方显式传入。

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

username := tree.ID(page, "username")
field := components.PaintFormField(canvas, theme, bounds, components.FormFieldSnapshot{
    Label:       "Username",
    Description: "This name is visible to collaborators.",
    Message:     "Username is available.",
    Required:    true,
    ControlID:   username,
})
components.PaintInput(canvas, theme, field.Control, components.InputSnapshot{
    ID: username, Label: field.Semantics.Label,
    Value: value, Hint: field.Semantics.AssistiveText(),
})

验证错误#

错误覆盖普通消息并同步到控件语义。

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

username := tree.ID(page, "username")
snapshot := components.FormFieldSnapshot{
    Label: "Username", Required: true, ControlID: username,
    Description: "This name is visible to collaborators.",
}
if utf8.RuneCountInString(value) < 3 {
    snapshot.Invalid, snapshot.Error = true, "Use at least three characters."
}
layout := components.PaintFormField(canvas, theme, bounds, snapshot)
components.PaintInput(canvas, theme, layout.Control, components.InputSnapshot{
    ID: username, Label: layout.Semantics.Label, Value: value,
    Hint: layout.Semantics.AssistiveText(), Invalid: layout.Semantics.Invalid,
})

安装

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

go run ./cmd/viva add --out ./components/local form

源码组件用法#

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

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

验证边界#

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

键盘操作

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