Skip to content

InputPassword

概要

PasswordInput は compound component 型のパスワード入力コンポーネントです。パスワードの表示/非表示トグル、強度メーター、制御/非制御モードに対応しています。

サブコンポーネント: Root / Input / VisibilityTrigger / Label / StrengthMeter

Usage

基本(Input + VisibilityTrigger)

Label + defaultVisible

制御モード(controlled)

StrengthMeter(パスワード強度メーター)

variant / size バリエーション

API Reference

PasswordInput.Root

Propデフォルト説明
valuestring制御モード: パスワードの現在値
defaultValuestring""非制御モード: 初期値
onValueChange(value: string) => void値変更コールバック
oninput(value: string) => voidForm 連携用の入力イベント
onblur() => voidForm 連携用のブラーイベント
visibleboolean制御モード: パスワードの表示状態
defaultVisiblebooleanfalse非制御モード: 初期表示状態
onVisibleChange(visible: boolean) => void表示状態変更コールバック
disabledbooleanfalse無効化
readOnlybooleanfalse読み取り専用
namestringフォーム用の name 属性
size"xs" | "sm" | "md" | "lg""md"サイズ
variant"outline" | "filled" | "flushed""outline"外観バリエーション
widthstringコンテナの幅(CSS値)

PasswordInput.Input

Prop説明
placeholderstringプレースホルダーテキスト

PasswordInput.VisibilityTrigger

表示/非表示を切り替えるトグルボタン。children を渡すとカスタムアイコンに置き換え可能。

PasswordInput.Label

入力フィールドのラベル。

PasswordInput.StrengthMeter

Prop説明
valuenumberパスワード強度(0〜4)。0=空、1=弱い、2=やや弱い、3=普通、4=強い

キーボード操作

なし(標準のテキスト入力操作に準ずる)。

アクセシビリティ

  • VisibilityTrigger は aria-label でパスワードの表示/非表示状態を通知
  • Input は autocomplete="current-password" を設定
  • disabled / readOnly 状態が正しく伝達される

Mithril UI Kit Documentation