FileInput Props

Name	Type	Default	Description
v-model	File | File[] | null	null	The selected file. An array when isMultiple is set.
label	string	—	Required accessible name.
accept	string	—	HTML accept list, such as .pdf,.docx or image/*.
isMultiple	boolean	false	Allow more than one file.
maxSize	number	—	Maximum size of one file, in bytes.
maxFiles	number	—	Maximum number of files when isMultiple is set.
mode	'input' | 'dropzone'	'input'	Compact field, or a dashed drop target.
placeholder	string	Choose file	Text shown when nothing is selected. Follows the locale.
size	'sm' | 'md' | 'lg'	'md'	Field height. 28, 32, or 36px.
status	FieldStatusInput	—	Error, warning, or success. A rejected file supplies an error when this is omitted.
statusVariant	'attached' | 'detached' | 'tooltip'	'attached'	Where the status message sits.
isDisabled	boolean	false	Blocks the picker and drops.
disabledMessage	string	—	Explains why the field is disabled. With isDisabled, the message shows in a tooltip on hover or keyboard focus and the trigger stays focusable with aria-disabled; the picker still cannot open.
labelTooltip	string	—	Hint shown from the info icon at the end of the label.
isRequired	boolean	false	Marks the field required.
isLoading	boolean	false	Shows a spinner, for an upload in progress.
description	string	—	Help text under the label.
width	number | string	—	Width of the whole field. Numbers are pixels.
changeAction	(files) => void | Promise<void>	—	Called after a selection and after a clear. A rejection emits actionError. A spinner shows while it is pending.
clearLabel	string	—	Accessible name of the clear button. It includes the field label by default. The tooltip only says “Clear”.
containerClass	string | object | array	—	Class for the field container. Has no effect, and warns in development, inside InputGroup and in a horizontal-labels FormLayout.
containerStyle	StyleValue	—	Inline style for the field container.
controlClass	string | object | array	—	Class for the file field box. A class written on the component lands here too, with no warning.
controlStyle	StyleValue	—	Inline style for the file field box. A style written on the component lands here too.

Events

Name	Payload	Description
update:modelValue	File | File[] | null	Emitted when the selection changes.
change	File | File[] | null	Emitted with the same value, before changeAction.
actionError	unknown, File | File[] | null	Emitted when changeAction rejects.