验证码输入框

一次性代码字段:六个框,每个框一位数字。看起来像六个输入,但行为就像一个值 - 键入前进,退格键后退,箭头移动而不进行编辑,并且粘贴或自动填充的代码会在各个框中展开。

安装

您可以使用我们的 CLI 或手动添加此 OTP 输入:

已支持深色模式,此 组件 会自动使用 BoardUI 的语义设计变量。 设置主题切换.

CLI 将组件源(及其内部依赖项)复制到您的项目中并安装任何所需的 npm 包。

npx boardui@latest add input-otp

使用共享 UI 包或自定义导入别名? 配置您的安装路径 在运行 CLI 之前。复制粘贴示例使用默认导入。

控制值

该值是单个字符串,而不是字符数组。通行证 值 + onChange 来控制它,或者 defaultValue 让它不受控制。 onComplete 在最后一个框填满时触发,这通常是您提交的地方。

const [code, setCode] = useState(""); <InputOtp value={code} onChange={setCode} onComplete={(value) => verify(value)} aria-label="Verification code"/>

长度、分组和状态

length 设置盒子的数量和 groupEvery 将它们分成多个运行,这使得长代码更容易读回。 isInvalid 使盒子在相同色调上出现红色边缘失败 输入框 用途。

{/* Four boxes instead of six */}<InputOtp length={4} aria-label="PIN" /> {/* Split into groups: 000 000 */}<InputOtp groupEvery={3} aria-label="Verification code" /> {/* States */}<InputOtp isInvalid aria-label="Verification code" /><InputOtp isDisabled defaultValue="1234" aria-label="Verification code" />

粘贴和自动填充

粘贴到任何框中都会从该点开始分配数字,而不是删除除第一个字符之外的所有内容。相同的路径处理操作系统自动填充:iOS 和 Chrome 将整个代码传递到一个盒子中,因此每个盒子都携带 autoComplete="one-time-code" 并接受多个字符。非数字被全部剥离,并且方框使用 inputMode="numeric" 因此手机会显示一个没有旋转器和杂散字符的数字键盘 number 输入会带来。