---
url: /components/otp-input.md
---
# OtpInput 验证码输入框

方框式验证码输入（OTP）：逐位输入自动前进、退格自动回退、粘贴整段验证码自动分配到各位；接入 Form 表单契约，`type=number` 时移动端唤起数字键盘且首框启用 `one-time-code` 自动填充。

## 基础用法

输入满 `length` 位时触发 `complete`，携带完整验证码；下方以 `@complete` 展示真实结果。

## 粘贴与键盘

在**任意方框**上粘贴整段验证码（如短信里的 `836274`），会从该位起逐位分配并自动聚焦末位；方向键在方框间移动，空框上退格回退并清除前一位。

## 掩码与错误态

`masked` 将已填位显示为 ●；`status` 设为 `error` 进入红色边框错误态（Form 校验失败场景）。

## 表单校验

与 EbForm 联动：`prop` 挂接校验规则，`change` 时机触发校验，失败自动进错误态。

## API