---
url: /components/basic/FaInputOtp.md
---
# FaInputOTP 验证码输入

用于输入短信验证码、邮箱验证码等一次性密码的输入组件。

## 使用场景

* 短信验证码输入
* 邮箱验证码验证
* 双重身份验证（2FA）
* 登录保护验证
* 支付密码验证
* 敏感操作确认

## Props

| 属性 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `length` | `number` | `6` | 验证码位数 |
| `pattern` | `'only-chars' \| 'only-digits' \| 'only-digits-and-chars' \| string` | - | 输入内容匹配模式 |
| `separator` | `number[]` | `[]` | 分组长度，组与组之间显示分隔符 |

### Model

| 名称 | 类型 | 说明 |
|------|------|------|
| `modelValue` | `string` | 输入的验证码 |

## Events

| 事件名 | 参数 | 说明 |
|--------|------|------|
| `complete` | - | 验证码输入完成时触发 |

## 注意事项

1. **自动聚焦**：组件会自动聚焦到第一个输入框
2. **自动跳转**：输入数字后自动跳转到下一个输入框
3. **粘贴支持**：支持粘贴验证码，会自动分配到各个输入框
4. **退格支持**：按退格键自动删除并跳转到前一个输入框
5. **完成事件**：输入位数达到 `length` 时自动触发 `complete` 事件