ガイドライン
Input Number
インプットナンバーは増減する数値の形式でユーザーからの入力を取得するために使用するコンポーネントです。
Anatomy: 解剖図
| Item | Name | Description | Component | Optional |
|---|---|---|---|---|
| 1 | Container | HTML Input エレメント | — | |
| 2 | Value | ユーザーからの入力を受けるエディタブルな要素 | — | |
| 3 | Controller | 入力を実行するためのコントローラー要素 | — |
Options: 選択肢
Size
sm
通常よりも小さなサイズです。限られたスペースにフィールドを配置する場合かつ入力の重要性が低い場合に使用します。
md (default)
インプットナンバーのデフォルトのサイズです。ミディアムが最も使用されるサイズです。他のサイズのフィールドはミディアムを基準に重要度に応じて使用します。
lg
大きなインプットナンバーは入力の重要性を高めるため、使用は極力控えてください。
States: 状態
Enable
ユーザーが操作を行う前のデフォルトの状態。
Hover
ユーザーがフィールドにマウスオーバーしている状態。
Focus
フィールドが操作可能な状態。キャレットが表示され、編集が可能であることがユーザーに伝達されます。
Disabled
システムによってフィールドが非活性化されている状態。ユーザーによる操作は不能です。
Invalid
Enable
入力内容が特定のフォーマットに準拠していない場合の状態です。ユーザーが適切な入力を行うことで無効状態は解除されます。
Hover
ユーザーがフィールドにマウスオーバーしている場合かつ、入力内容が特定の条件やフォーマットに準拠していない場合の状態です。
Focus
フォーカスされている場合かつ、入力内容が特定の条件やフォーマットに準拠していない場合の状態です。
Disabled
システムによってフィールドが非活性化されている場合かつ、入力内容が特定の条件やフォーマットに準拠
していない場合の状態です。
Behaviors: 振る舞い
最小幅やコンテンツのオーバーフローに関しては、Input コンポーネントの振る舞いに準拠します。詳しくはInputをご覧ください。
コントローラー
インプットナンバーは値をフィールドへ直接入力することができる他、コントローラーを使用して値の加算と減算を実行できます。
Metrics: 寸法
sm
- Vertical Resizing: Hug
- Horizontal Resizing: Fixed
- Container Height: 32px
- Item Spacing: 8px
- padding left: 4px
md
- Vertical Resizing: Hug
- Horizontal Resizing: Fixed
- Container Height: 40px
- Item Spacing: 8px
- padding left: 4px
lg
- Vertical Resizing: Hug
- Horizontal Resizing: Fixed
- Container Height: 48px
- Item Spacing: 8px
- padding left: 4px
Field
- Vertical Resizing: Hug
- Horizontal Resizing: Fill
- Container Height: 48px
- padding Horizontal: 8px
Usage: 使い方
Input Numberを使用する際はFormコンポーネントの用法に従ってください。
Change log: 変更履歴
| Date | Changes |
|---|---|
| 2025/7/4 | Metricsをアップデート |
| 2025/01/31 | ドキュメントを公開 |
