109k
新建

OTP 输入框

上一页下一页

具有复制粘贴功能且符合无障碍标准的验证码输入组件。

Radix UIBase UI
Radix UI - shadcn/ui 组件库
1
2
3
4
5
6
import {
  InputOTP,
  InputOTPGroup,

关于

Input OTP 基于 input-otp 构建，由 @guilherme_rodz 开发。

安装

pnpm dlx shadcn@latest add input-otp

用法

import {
  InputOTP,
  InputOTPGroup,
  InputOTPSeparator,
  InputOTPSlot,
} from "@/components/ui/input-otp"
<InputOTP maxLength={6}>
  <InputOTPGroup>
    <InputOTPSlot index={0} />
    <InputOTPSlot index={1} />
    <InputOTPSlot index={2} />
  </InputOTPGroup>
  <InputOTPSeparator />
  <InputOTPGroup>
    <InputOTPSlot index={3} />
    <InputOTPSlot index={4} />
    <InputOTPSlot index={5} />
  </InputOTPGroup>
</InputOTP>

模式 (Pattern)

使用 pattern 属性为 OTP 输入定义自定义模式。

import { REGEXP_ONLY_DIGITS_AND_CHARS } from "input-otp"
 
;<InputOTP maxLength={6} pattern={REGEXP_ONLY_DIGITS_AND_CHARS}>
  ...
</InputOTP>
"use client"

import { Field, FieldLabel } from "@/components/ui/field"

示例

分隔符

使用 <InputOTPSeparator /> 组件在输入组之间添加分隔符。

import {
  InputOTP,
  InputOTPGroup,

禁用

使用 disabled 属性来禁用输入框。

1
2
3
4
5
6
import {
  InputOTP,
  InputOTPGroup,

受控组件

使用 value 和 onChange 属性来控制输入值。

输入您的验证码。
"use client"

import * as React from "react"

无效状态

在插槽上使用 aria-invalid 来显示错误状态。

0
0
0
0
0
0
"use client"

import * as React from "react"

四位数字

PIN 码的常用模式。使用 pattern={REGEXP_ONLY_DIGITS} 属性。

"use client"

import {

字母数字组合

使用 REGEXP_ONLY_DIGITS_AND_CHARS 以同时接受字母和数字。

"use client"

import {

表单

验证您的登录
输入我们发送到您电子邮箱的验证码 m@example.com.

我已无法访问此电子邮箱地址。

登录遇到问题？ 联系支持人员
import { Button } from "@/components/ui/button"
import {
  Card,

RTL (从右至左)

要在 shadcn/ui 中启用 RTL 支持，请参阅 RTL 配置指南。

1
2
3
4
5
6
"use client"

import * as React from "react"

API 参考

参阅 input-otp 文档以获取更多信息。