アップロード制限

概要

管理者はコンポーネントプロパティでファイルタイプとサイズによるアップロード制限を直接設定できます — コードは不要です。

ファイルタイプ制限

2つのプロパティでどのファイルタイプを受け入れるかを制御します：

Allowed File Extensions

許可される拡張子のホワイトリスト（例：pdf,docx,xlsx）。設定すると、これらのタイプのみアップロードできます。空欄にするとすべてのタイプを許可します。

Excluded File Extensions

ブロックする拡張子のブラックリスト（例：exe,bat,sh）。これらのタイプはアップロード時に拒否されます。空欄にすると除外なしです。

両方を同時に使用する場合

両方が設定されている場合、組み合わせフィルターとして動作します：

1. 許可リストが最初にチェックされます — ファイルの拡張子が許可リストにない場合、ブロックされます。
2. 除外リストが次にチェックされます — ファイルが許可チェックを通過しても、除外リストにある場合はブロックされます。

ファイルが受け入れられるには、許可リストに含まれかつ除外リストに含まれていない必要があります。

ヒント

ほとんどの場合、2つのうち1つだけで十分です。少数の既知のタイプに制限するにはAllowedを使用します。特定のタイプをブロックしてその他はすべて許可するにはExcludedを使用します。

ファイルサイズ制限

**Max File Size (MB)**プロパティで最大アップロードサイズを制限します。0に設定すると制限なしです。

ユーザーが制限を超えるファイルをアップロードしようとすると、アップロードはブロックされ、ファイル名と設定された制限値を含むエラートーストが表示されます。

ユーザーフィードバック

アップロードがブロックされた場合、コンポーネントは明確なフィードバックを提供します：

• 単一ファイルがブロックされた場合 — ファイル名とブロックされた理由（不正なタイプまたはサイズ超過）を説明するトーストメッセージ。
• 複数ファイルがブロックされた場合 — ブロックされたすべてのファイルと理由をリストするトースト。
• 混合アップロード — 一部のファイルが成功し、他がブロックされた場合、成功と警告の両方のトーストが表示されます。