Keel v0.5.1 English GitHub

Input Group

在线示例:这是真实的 Keel 程序编译成 WebAssembly,可以直接操作。首次加载约 10 MB。全屏打开
示例代码Go · 可复制

这是上方组件库展示案例的完整源码。examples/components/input_group.go

在脚手架项目中复用组件构造和 Render 写法;示例的 registerSection 与共享辅助函数由组件库提供。

package main

import (
	"fmt"
	"github.com/dyike/keel/ui/core"
	"github.com/dyike/keel/ui/el"
	"github.com/dyike/keel/ui/kit"
	"github.com/dyike/keel/ui/theme"
	"unicode/utf8"
)

func init() {
	registerSection("input_group", "inputs", func() core.Widget {
		query := kit.Input("").Placeholder(demoText("Customer or order number", "客户或订单号")).Clearable()
		status := demoText("Waiting for query", "等待查询")
		group := kit.InputGroup(demoText("Find orders", "查询订单"), query).Prefix(kit.Icon(kit.IconSearch)).Suffix(kit.Button(demoText("Search", "查询"), func() { status = demoText("Query: ", "查询:") + query.Value() }))
		amount := kit.InputGroup(demoText("Amount", "金额"), kit.Input("").Filter("0123456789.")).Prefix(el.ViewFunc(func(*el.Context) el.Element { return el.Text("¥") })).Suffix(el.ViewFunc(func(*el.Context) el.Element { return el.Text("CNY") }))
		message := kit.TextArea("").Rows(3).Placeholder(demoText("Enter order notes…", "输入订单备注…"))
		composer := kit.InputGroup(demoText("Order notes", "订单备注"), message).
			Addon("heading", kit.InputGroupBlockStart, el.ViewFunc(func(*el.Context) el.Element {
				return el.Text(demoText("Notes are saved with the order", "备注将随订单保存"))
			})).
			Addon("footer", kit.InputGroupBlockEnd, el.ViewFunc(func(cx *el.Context) el.Element {
				return el.Div().WFull().Row().Items(el.Center).Gap(theme.SpaceMd).Child(
					el.Text(fmt.Sprintf(demoText("%d characters", "%d 字"), utf8.RuneCountInString(message.Value()))).Grow(),
					kit.Button(demoText("Save notes", "保存备注"), func() { status = demoText("Saved: ", "已保存:") + message.Value() }).Size(28).Render(cx))
			}))
		return el.Root(el.ViewFunc(func(cx *el.Context) el.Element {
			return el.Div().P(24).W(el.Dp(440)).MaxW(el.Full).Gap(14).Child(group.Render(cx), el.Text(status), amount.Render(cx), composer.Render(cx))
		}))
	})
}

把文本框、图标、单位或操作按钮组合到同一个边框中。

query := kit.Input("").Placeholder("客户或订单号").Clearable()
search := kit.InputGroup("查询订单", query).
    Prefix(kit.Icon(kit.IconSearch)).
    Suffix(kit.Button("查询", func() { lookup(query.Value()) }))

Input 实例负责文字、过滤、只读和回调,Input Group 负责边框、标签和前后附加内容。传入的 Input 只通过该组渲染,不能同时在别处渲染。附加内容宽度由自身决定;为长按钮和窄容器预留足够空间。

  • Prefix(el.View) / Suffix(el.View) 放置附加内容,传 nil 移除。动态增删附加内容保留输入焦点和文字。
  • Value / SetValue / OnChange 使用内部 Input 的状态;程序赋值不触发回调。格式、密码、清空和提交配置仍放在 Input 上。
  • SetDisabled 禁用输入及所有附加操作,恢复后保留内容;输入自身的禁用状态也会禁用整组。只读输入仍允许使用附加按钮。
  • SetError / Error / FocusID 可接入 Form。组标签同时作为输入的可访问名称;点击可见标签聚焦编辑器。空标签时接受 Form 字段名。
  • Tab 依次访问编辑器和可聚焦附加操作,文字编辑快捷键与 Input 相同。

Agent:外层是 group,内部编辑器为带字段名称的 textbox;附加按钮保留自己的名称、角色和禁用状态。

验证:go run ./examples/components -section input_group;加 -theme dark 验证深色。

Addon(id, alignment, view) 可以在四个位置添加任意数量的附加内容:

alignment 位置
InputGroupInlineStart 编辑器左侧,在 Prefix 之后
InputGroupInlineEnd 编辑器右侧,在 Suffix 之前
InputGroupBlockStart 整个输入行上方
InputGroupBlockEnd 整个输入行下方

同一位置按添加顺序排列。ID 必须非空且保持稳定;同 ID 替换内容和位置,传 nil 删除。上下区域各占一行,可在 View 内用 Row/Wrap 组合计数、工具栏、按钮或菜单。文字、图标及空白处点击聚焦输入;交互控件保留自己的点击和焦点行为。

message := kit.TextArea("").Rows(3)
composer := kit.InputGroup("备注", message).
    Addon("heading", kit.InputGroupBlockStart,
        el.ViewFunc(func(*el.Context) el.Element { return el.Text("填写订单备注") })).
    Addon("send", kit.InputGroupBlockEnd,
        kit.Button("保存", func() { save(message.Value()) }).Size(28))

附加按钮直接使用 kit.Button,可配置 Variant、Size、Icon、Name、Loading 和禁用状态;紧凑按钮可设 .Variant(kit.ButtonGhost).Size(24)。图标按钮需 Name。菜单、Popover 和 Tooltip 也可以作为附加 View 组合,沿用各自接口。

TextArea 与单行输入共用这些位置;上下面板随内容增高,文本行数由内部 TextArea 控制。Rows 设置最小高度;要随内容增高并设上限,用 TextArea 的 AutoGrow(minRows, maxRows),见 Input。输入和附加内容外只有一层字段边框,聚焦框覆盖整组。只读允许附加动作,输入禁用、组禁用和祖先禁用则禁用全部附加操作。