FileButton

FileButtonは、ユーザーがファイルを選択するために使用されるボタンのコンポーネントです。

使い方

import { FileButton } from "@yamada-ui/react"
<FileButton />

バリアントを変更する

サイズを変更する

カラースキームを変更する

複数選択を許容する

複数選択を許容する場合は、multipletrueに設定します。

拡張子を指定する

拡張子を指定する場合は、acceptに文字列(タイプ)を設定します。

無効にする

無効にする場合は、disabledtrueに設定します。

Please select a file to upload.

読み取り専用にする

読み取り専用にする場合は、readOnlytrueに設定します。

Please select a file to upload.

無効な入力にする

無効な入力にする場合は、invalidtrueに設定します。

Please select a file to upload.

ボーダーの色を変更する場合は、errorBorderColorに値を設定します。

リセットする

値をリセットする場合は、resetRefrefを設定します。設定されたrefにコールバック関数が付与されるので、それを実行します。

files: 0

Props

アクセシビリティ

FileButtonは、アクセシビリティに関してWAI-ARIA - Button Patternに従います。

FileButtonにアイコンのみを使用する場合は、FileButtonaria-labelを設定します。

<FileButton
  as={IconButton}
  aria-label="Upload file"
  icon={<PlusIcon fontSize="2xl" />}
/>

キーボード操作

キー説明状態
Enter, Spaceフォーカスされたボタンをアクティブにし、ファイルダイアログを開きます。-

ARIAロールと属性

コンポーネントロールと属性使い方
FileButtonaria-labelledbyFileButtonField.Root内にあり、Field.Rootlabelが設定されている場合は、そのidを設定します。
aria-disableddisabledまたはreadOnlyが設定されている場合は"true"を設定します。

類似のコンポーネント

Dropzone

Dropzoneは、ファイルをドラッグアンドドロップでアップロードするために使用されるコンポーネントです。

Toggle

Toggleは、オンまたはオフの2つの状態を持つコンポーネントです。

FileInput

FileInputは、ユーザーがファイルを選択するために使用されるコンポーネントです。

CloseButton

CloseButtonは、基本的にコンポーネントの閉じる機能をトリガーするために使用するコンポーネントです。

Button

Buttonは、フォームの送信、モーダルの開閉など、ユーザーが操作できるインタラクティブなコンポーネントです。

使用しているコンポーネント・フック