OtpInput
示例代码Go · 可复制
这是上方组件库展示案例的完整源码。examples/components/otp_input.go
在脚手架项目中复用组件构造和 Render 写法;示例的 registerSection 与共享辅助函数由组件库提供。
package main
import (
"github.com/dyike/keel/ui/core"
"github.com/dyike/keel/ui/el"
"github.com/dyike/keel/ui/kit"
"github.com/dyike/keel/ui/theme"
)
func init() {
registerSection("otp_input", "inputs", func() core.Widget {
msg := demoText("Enter a 6-digit code; pasting is supported", "输入 6 位验证码,可以直接粘贴")
code := kit.OtpInput(demoText("Verification code", "验证码"), 6)
code.OnComplete(func(s string) {
if s == "123456" {
msg = demoText("Verified", "验证通过")
} else {
code.SetError(demoText("Incorrect code; try 123456", "验证码错误,试试 123456"))
}
})
pin := kit.OtpInput(demoText("PIN · 4 digits", "密码 PIN · 4 位"), 4).Masked(true).Groups(1).Size(40)
pin.SetValue("1234")
grouped := kit.OtpInput(demoText("Groups · 3–2–2", "分组 Groups · 3–2–2"), 7).Groups(3).Size(56)
grouped.SetValue("1234567")
return el.Embed(el.ViewFunc(func(cx *el.Context) el.Element {
return el.Div().P(24).Gap(12).Items(el.Start).Child(code.Render(cx), el.Text(msg).TextColor(theme.Muted), pin.Render(cx), grouped.Render(cx))
}))
})
}
分格输入固定位数的验证码。
code := kit.OtpInput("验证码", 6).OnComplete(func(s string) { verify(s) })
- 只接受数字。输入后自动跳到下一格,Backspace 回到上一格,粘贴整串验证码会一次填满所有格子。
- 输入最后一位时调用
OnComplete;OnChange在每次编辑后调用。 - 实现方式:一个看不见的文本框盖在格子上面,焦点、编辑、粘贴都由它处理,格子只负责显示。因此读屏和 Agent 只看到一个文本框。
Value()/SetValue(丢弃非数字和多余的位数)、SetDisabled、SetError。
Masked(true) 遮住可见数字与语义值,Masked(false) 恢复显示;原始值仍通过 Value 和回调交给应用。Groups(n) 设置组数,限制到 1–位数,默认两组(单数字为一组),不能整除时前面的组多一位,例如 7 位分 3 组为 3–2–2。组间间距为格内间距的两倍。
Size(dp) 设置格高,默认 48dp;格宽、间距和字号按比例变化,忽略非正数和非有限数。修改布局或遮罩不改变值,不触发编辑回调。
Agent:角色 textbox,名字是标签;普通模式的 value 是已输入的数字,遮罩模式为等长圆点。
验证:go run ./examples/components -section otp_input,加 -theme dark 检查深色。
窄容器中各位等宽收缩,实际编辑区与可见格子的宽度一致。默认六位在 224dp 内容宽度下仍完整显示;1× / 2× 的数字边界和整段粘贴有回归测试。