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(由 Input 组件按 validateStatus 自动下发);disabled → aria-disabled + 原生 disabled
  • RTL:←→ 语义镜像;组合态(isComposing)不写入
  • 无 Home/End 支持(严格对齐 Semi handleKeyDownOnSingleInput,Semi 未实现)

设计变量

变量
默认值
用法
--cd-pincode-cell-font-size var(--cd-font-size-header-6) 单格字符字号(略大于正文,居中显示单字符)
显示第 1 条-第 1 条,共 1 条
  • 1