本文へ移動
uiify

OTP input

1文字につき1枠を使うワンタイムコード入力。

ブラウザー
Chrome 123+Firefox 121+Safari 17.5+
ティア
2
圧縮後のサイズ
1.53 kB
強制レイアウトの上限
0 ms
axe の上限
0
SSR 対応
はい
公開された契約
テストハーネス

プレイグラウンド

OTP Input

デフォルト

API

OtpInput.Root

Prop型既定値説明
valuestring—現在のコード。フィールドを制御します。
defaultValuestring""非制御フィールドの初期コード。
onValueChange(value: string) => void—コードが変わるたび、そのコードで呼び出します。
onComplete(value: string) => void—コードが設定された長さに達すると呼び出します。
lengthnumber6コードの文字数。
type"numeric" | "alphanumeric""numeric"入力時や貼り付け時に残す文字。
maskbooleanfalse枠内の入力済み文字を隠します。
disabledbooleanfalse非表示入力を無効にし、data-disabled属性を設定します。
autoFocusbooleanfalseフィールドのマウント時に非表示入力へフォーカスします。
idstring—描画するルート要素に適用するID。
renderReactElement | ((props, state) => ReactElement)—動作とアクセシビリティの接続を維持したまま、描画する要素を置き換えます。

OtpInput.Slot

Prop型既定値説明
index*number—この枠に表示するコード内の位置。
renderReactElement | ((props, state) => ReactElement)—動作とアクセシビリティの接続を維持したまま、描画する要素を置き換えます。

OtpInput.HiddenInput

Prop型既定値説明
autoFocusboolean—ルートの設定を上書きし、マウント時にこの入力へフォーカスします。
renderReactElement | ((props, state) => ReactElement)—動作とアクセシビリティの接続を維持したまま、描画する要素を置き換えます。

キーボード

キー操作
Tabコントロールへ、またはコントロールからフォーカスを移動
Enter / Spaceフォーカス時に実行(ボタン型のコントロール)

アクセシビリティ

可能な限りセマンティックHTMLを使います。プレイグラウンドで描画されたマークアップを確認できます。ARIAはネイティブ要素だけでは足りない場合にのみ追加します。

スタイリングのフック

data-disabled
このページは機械翻訳によるもので、レビューは未実施です。