106k
New

输入 OTP

PreviousNext

具有复制粘贴功能的无障碍一次性密码组件。

Radix UIBase UI
Radix 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 属性定义 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 属性控制输入值。

Enter your one-time password.
"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 {

表单

Verify your login
Enter the verification code we sent to your email address: m@example.com.

I no longer have access to this email address.

Having trouble signing in? Contact support
import { Button } from "@/components/ui/button"
import {
  Card,

API 参考

更多信息请参阅 input-otp 文档。