ガイドライン
Input File
インプットファイルはユーザーがファイルをアップロードために使用するコンポーネントです。
Anatomy: 解剖図
| Item | Name | Description | Component | Optional |
|---|---|---|---|---|
| 1 | Container | コンテナ要素 | — | |
| 2 | Value | ユーザーからの入力を受けるエディタブルな要素 | — | |
| 3 | Trigger | アクションを実行するためのトリガー要素 | Icon Button | — |
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
- padding Vertical: 4px
- padding Horizontal: 4px
md
- Vertical Resizing: Hug
- Horizontal Resizing: Fixed
- Container Height: 40px
- padding Vertical: 4px
- padding Horizontal: 4px
lg
- Vertical Resizing: Hug
- Horizontal Resizing: Fixed
- Container Height: 48px
- padding Vertical: 4px
- padding Horizontal: 4px
Field
- Vertical Resizing: Hug
- Horizontal Resizing: Fill
- padding Horizontal: 8px
Usage: 使い方
Input Fileを使用する際はFormコンポーネントの用法に従ってください。
Change log: 変更履歴
| Date | Changes |
|---|---|
| 2025/7/3 | Metricsをアップデート |
| 2025/5/12 | ドキュメントを公開 |
