v0.21

d-otp

単一のネイティブ入力でSMS自動入力、ペースト時の自動サニタイズ、キーボード編集、分割スロットグループを実現するフォーム関連のワンタイムパスワード入力コンポーネントです。

1<d-otp length="6" separator="3" name="code"></d-otp>
2<d-otp length="4" mask name="pin"></d-otp>
3<d-otp length="6" pattern="alphanumeric" uppercase separator="2"></d-otp>

属性とプロパティ(d-otp)

属性 プロパティ 型 デフォルト値 フォーム 説明
length length number 6 いいえ スロット総数(1から16)
value value string "" はい フォーム送信時に反映されるサニタイズ済みOTP文字列
name name string "" いいえ フォーム送信時のフィールド名
pattern pattern string "digits" いいえ 許可文字プリセット("digits"、"alphanumeric"、"alpha")または正規表現
separator separator string "" いいえ グループ区切り間隔("3"等)またはカンマ区切りの分割位置("2,4"等)
mask mask boolean false いいえ PIN入力向けに文字をドット表示にマスクする
disabled disabled boolean false いいえ 入力を無効化しフォーム送信から除外する
invalid invalid boolean false いいえ 全スロットにエラーボーダー状態を適用
autofocus autofocus boolean false いいえ マウント時に自動フォーカスする
uppercase uppercase boolean false いいえ 入力英字を大文字に変換して検証する

プログラム用api(d-otp)

1const otp = select('d-otp');
2
3otp.focus();
4otp.error('invalid verification code');
5otp.clearError();
6otp.clear();

イベント(d-otp)

イベント 詳細 バブリング 説明
input string(value) はい サニタイズ済みOTP値が変更されたときに送出
change string(value) はい OTP値が更新されたときに送出
complete string(value) はい 全スロットが入力完了したときに一度送出

動作仕様(d-otp)