File Upload

Preview

<esa-file-upload label="Upload a document"></esa-file-upload>

States

Allow multiple files with multiple + accept, cap each file with max-size-mb, or disable the zone entirely.

<esa-file-upload label="Upload images" multiple accept="image/*"></esa-file-upload>
<esa-file-upload label="Max 2 MB" max-size-mb="2"></esa-file-upload>
<esa-file-upload label="Upload disabled" disabled></esa-file-upload>

API

Events

Accessibility

• The drop zone is keyboard-focusable; Enter or Space opens the native file picker.
• Drag-over highlights the zone; drop adds the dragged files.
• Oversized files are rejected with an inline error message rather than failing silently.
• Form-associated via ElementInternals — selected files are set as a FormData payload (default name files) so they submit with the enclosing form.

Theming surface

Every public token this component reads, extracted from its source at build time. The Resolves to column walks each token's real lineage — component → semantic → primitive → raw value — so you can see exactly where re-pointing it lands. A spoke re-skins by overriding these in its theme-<slug>.css; component internals are never edited. No hook for what you need? File it with /request-lego.