FileUpload

modelValue holds the selection, and its shape follows multiple: a single File (or null) on its own, an array of them once multiple is set. Bind it with v-model — the control also writes back when a file is removed from the list it renders, so the model and the list can't drift apart.

multiple lets more than one file be picked at a time, and switches modelValue from a single File to an array. Every selected file gets a row underneath the dropzone with its own remove button.

accept is the comma-separated list of types the picker offers, in the same syntax a native file input takes — MIME types like image/* or extensions like .pdf. It filters what the file dialog shows; treat it as a convenience rather than a guarantee, and still check the type on the server.

disabled switches off the whole control — no dialog on click, no drop target — for a form that's saving or a step that isn't reachable yet.

label is the headline inside the dropzone, or the button's text in the button variant. Say what should be dropped rather than restating the control (“Drop your invoice here” beats “Upload”).

description is the quieter second line under the label, and only the area variant renders it — the button trigger has no room for one. It's the natural place for the constraints, since accept itself is invisible until the dialog opens.

icon replaces the default upload glyph above the label. Matching it to what you're asking for — image for photos, document for paperwork — makes the dropzone readable before anyone gets to the text.

variant chooses between the full area dropzone and a compact button trigger. The button still accepts drops, but reads as one control in a row rather than a panel — reach for it where space is tight.

color is the accent the dropzone takes on while a file is dragged over it — the rest of the time the control stays neutral. Drag a file onto the two below to see the difference; the colour is the only feedback that the drop will land.

size sets how large the drop zone renders, from a compact row up to a full panel.