Textarea多行输入

查看源码components/textarea.go

项目说明#

真实多行值、标签与辅助提示；长行按宽度软换行，上下键按视觉行移动并保持列，Home/End 到行首行尾，点击与拖选按视觉行定位。

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

f.Textarea(components.TextareaSnapshot{
    ID: tree.ID(page, "description"), Label: "Project description", Hint: "Supports multiple lines",
    Value: value, DisplayValue: value,
}).Height(142)

随内容增高#

相当于 shadcn 的 field-sizing-content：高度随文本行数增长，超过上限后在框内滚动并跟随插入点。

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

width := min(size.Width-48, float32(540))
height := min(layout.ContentHeight(canvas, theme, value, width, false), float32(5)*20+16)
f.Textarea(components.TextareaSnapshot{
    ID: tree.ID(page, "notes"), Label: "Project description", Value: value,
    DisplayValue: value, Layout: layout,
}).Height(height)

选择与输入法#

确定性展示选择区、插入点与组合文本下划线。

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

value := "Select this text\nComposition text"
f.Textarea(components.TextareaSnapshot{
    ID: tree.ID(page, "selection"), Value: value, DisplayValue: value,
    ReadOnly: true, Focused: true, ShowCaret: true, Caret: 16,
    SelectionStart: 0, SelectionEnd: 6,
    CompositionStart: 17, CompositionEnd: len(value),
}).Height(142)

校验与禁用#

错误、只读与禁用状态并列展示。

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

f.Row().Gap(12).Children(func() {
    f.Textarea(components.TextareaSnapshot{
        ID: tree.ID(page, "invalid"), Label: "Invalid field", Invalid: true, ReadOnly: true,
        Value: "Too short", DisplayValue: "Too short",
    }).Grow(1).Basis(0).Height(104)
    f.Textarea(components.TextareaSnapshot{
        ID: tree.ID(page, "read-only"), Label: "Read-only field", ReadOnly: true,
        Value: "Generated by the system\nNot editable", DisplayValue: "Generated by the system\nNot editable",
    }).Grow(1).Basis(0).Height(104)
})
f.Textarea(components.TextareaSnapshot{
    ID: tree.ID(page, "disabled"), Label: "Disabled field", Disabled: true,
    Placeholder: "Currently unavailable",
}).Height(72)

安装

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

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

源码组件用法#

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

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

验证边界#

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

键盘操作

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