使用建议
分格验证码 / OTP 输入组件:N 个受控单字符输入格,逐格填入、自动跳格、整串粘贴自动分发,支持数字/混合/RegExp/函数四种字符校验。
Accessibility
ARIA role:group
- root role=group + aria-label(i18n)或 aria-labelledby
- 每格 aria-label 位次「第 N 位,共 M 位」
- 每格 autoComplete=one-time-code(OTP 系统级填充,超越 Semi)
- inputMode 随 format(number→numeric);maxlength=1
- status=error → 各格 aria-invalid;disabled → aria-disabled + 原生 disabled
- RTL:←→ 语义镜像;组合态(isComposing)不写入
设计变量
| 变量 | 默认值 | 用法 |
|---|---|---|
--cd-pincode-cell-font-size | var(--cd-font-size-header-6) | 单格字符字号(略大于正文,居中显示单字符) |