CLI
手动安装
CLI 将组件源(及其内部依赖项)复制到您的项目中并安装任何所需的 npm 包。
npx boardui@latest add input-otp使用共享 UI 包或自定义导入别名? 配置您的安装路径 在运行 CLI 之前。复制粘贴示例使用默认导入。
控制值
该值是单个字符串,而不是字符数组。通行证 值 + onChange 来控制它,或者 defaultValue 让它不受控制。 onComplete 在最后一个框填满时触发,这通常是您提交的地方。
const [code, setCode] = useState("");
<InputOtp value={code} onChange={setCode} onComplete={(value) => verify(value)} aria-label="Verification code"/>长度、分组和状态
length 设置盒子的数量和 groupEvery 将它们分成多个运行,这使得长代码更容易读回。 isInvalid 使盒子在相同色调上出现红色边缘失败 输入框 用途。
{/* Four boxes instead of six */}<InputOtp length={4} aria-label="PIN" />
{/* Split into groups: 000 000 */}<InputOtp groupEvery={3} aria-label="Verification code" />
{/* States */}<InputOtp isInvalid aria-label="Verification code" /><InputOtp isDisabled defaultValue="1234" aria-label="Verification code" />粘贴和自动填充
粘贴到任何框中都会从该点开始分配数字,而不是删除除第一个字符之外的所有内容。相同的路径处理操作系统自动填充:iOS 和 Chrome 将整个代码传递到一个盒子中,因此每个盒子都携带 autoComplete="one-time-code" 并接受多个字符。非数字被全部剥离,并且方框使用 inputMode="numeric" 因此手机会显示一个没有旋转器和杂散字符的数字键盘 number 输入会带来。