本文へ移動
uiify

File upload

ドロップ領域とファイル一覧。

ブラウザー
Chrome 123+Firefox 121+Safari 17.5+
ティア
1
圧縮後のサイズ
2.27 kB
強制レイアウトの上限
0 ms
axe の上限
0
SSR 対応
はい
公開された契約
テストハーネス

プレイグラウンド

File upload

Attachments

Drop files here, or choose files above.

    Up to 3 files · 5 MB each

    API

    FileUpload.Root

    Prop型既定値説明
    childrenReactNode—ファイルアップロードのパーツ。hidden input、trigger、dropzone、list。
    valuereadonly File[]—現在のファイル。コンポーネントを制御します。
    defaultValuereadonly File[][]非制御コンポーネントの初期ファイル。
    onValueChange(files: File[]) => void—選択が変わるたび、受け入れたファイルで呼び出します。
    onReject(rejections: FileRejection[]) => void—検証に失敗したファイルとその理由で呼び出します。
    acceptstring[][]受け入れるファイル形式。拡張子またはMIMEタイプで指定します。
    maxFilesnumber—同時に保持できるファイルの最大数。
    maxSizenumber—受け入れるファイルサイズの上限(バイト)。
    minSizenumber—受け入れるファイルサイズの下限(バイト)。
    multiplebooleanfalseピッカーで複数のファイルを選択できるようにします。
    disabledbooleanfalseピッカー、ドロップ領域、削除ボタンを無効にします。

    FileUpload.HiddenInput

    Prop型既定値説明
    classNamestring—ネイティブのファイル入力に適用するクラス。

    FileUpload.Trigger

    Prop型既定値説明
    childrenReactNode—ファイルピッカーを開くコントロールの内容。
    classNamestring—トリガー要素に適用するクラス。
    renderReactElement | ((props, state) => ReactElement)—動作とアクセシビリティの接続を維持したまま、描画する要素を置き換えます。

    FileUpload.Dropzone

    Prop型既定値説明
    childrenReactNode—ドロップ先の内容。
    classNamestring—ドロップ領域の要素に適用するクラス。
    renderReactElement | ((props, state) => ReactElement)—動作とアクセシビリティの接続を維持したまま、描画する要素を置き換えます。

    FileUpload.List

    Prop型既定値説明
    childrenReactNode | ((files: readonly File[]) => ReactNode)—最新のリストから受け入れ済みファイルを描画します。制御値の変更や外部からのリセットを即座に反映します。
    classNamestring—リスト要素に適用するクラス。

    FileUpload.Item

    Prop型既定値説明
    childrenReactNode—名前やサイズなど、ファイルを説明する内容。
    classNamestring—項目要素に適用するクラス。
    index*number—この項目が表すファイルの位置。
    renderReactElement | ((props, state) => ReactElement)—動作とアクセシビリティの接続を維持したまま、描画する要素を置き換えます。

    FileUpload.ItemRemove

    Prop型既定値説明
    classNamestring—削除ボタンに適用するクラス。
    index*number—このボタンが削除するファイルの位置。

    FileRejection

    Prop型既定値説明
    file*File—受け入れられなかったファイル。
    reason*"accept" | "max-size" | "max-files"—ファイルが満たさなかったルール。

    キーボード

    キー操作
    Enter / SpaceTriggerからファイルピッカーを開く、またはフォーカス中のファイルを削除
    Tabピッカーのトリガーとファイル削除コントロール間を移動

    アクセシビリティ

    HiddenInputにアクセシブルなラベルを付けてください。Listは受け入れたファイルを受け取り、名前、サイズ、ラベル付きの削除ボタンを描画します。Rootは制御値、累積のmaxFiles、maxSize、acceptによる検証に対応し、onRejectが拒否したファイルを通知します。無効なルートはピッカー、ドロップ、削除操作をブロックします。ファイル処理にはハイドレーションが必要です。

    スタイリングのフック

    data-uiify-file-uploaddata-partdata-disableddata-state
    このページは機械翻訳によるもので、レビューは未実施です。