PinCode 设计文档

分格验证码 / OTP 输入组件:N 个受控单字符输入格,逐格填入、自动跳格、整串粘贴自动分发,支持数字/混合/RegExp/函数四种字符校验。

← API 文档

使用建议

分格验证码 / 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)单格字符字号(略大于正文,居中显示单字符)