Keel v0.5.1 English GitHub

OtpInput

在线示例:这是真实的 Keel 程序编译成 WebAssembly,可以直接操作。首次加载约 10 MB。全屏打开
示例代码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× 的数字边界和整段粘贴有回归测试。