Skip to content

PinInput 组件

PIN 码输入组件,多个单字符输入框组成,自动聚焦切换,适用于验证码、PIN 码输入场景。

引入

tsx
import { PinInput } from 'kra-ui';

基本用法

tsx
const [pin, setPin] = useState('');

<PinInput
  length={4}
  value={pin}
  onChange={setPin}
  onComplete={(value) => console.log('完成:', value)}
/>

// 6 位掩码模式
<PinInput length={6} mask value={pin} onChange={setPin} />

// 不同尺寸
<PinInput size="sm" value={pin} onChange={setPin} />
<PinInput size="lg" value={pin} onChange={setPin} />

Props

属性类型默认值说明
lengthnumber4PIN 码位数
valuestring''当前值
onChange(value: string) => void-值变更回调
onComplete(value: string) => void-所有位数输入完成时触发
maskbooleanfalse是否掩码显示
size'sm' | 'md' | 'lg''md'尺寸
isDisabledbooleanfalse是否禁用
...BoxProps--继承 Box 属性