Components File upload

File upload

Styled drop-zone wrapper around a native file input. Posts as part of the surrounding form; supports drag-and-drop; validates max size client-side. Native chrome stays out of sight, consistent across browsers.

<koala-file-upload>

Canonical

Drag a file onto the zone, or click to open the native picker. The label updates with the chosen filename; oversize files reject with an inline error.

Variants

Single (image)

accept="image/*"

Multiple

multiple

Props

Attribute	Values	Notes
name	String	Required. Form-field name on the hidden input.
accept	MIME list	Same syntax as the native attribute. Optional.
multiple	Boolean	Allow selecting more than one file.
max-size-mb	int	Client-side cap. Server should still enforce it.
label	String	Drop-zone prompt. Defaults to "Drop a file or click to browse".
id	String	Optional. Defaults to a sanitised version of `name`.