FileInput 属性

名称	类型	默认值	说明
v-model	File | File[] | null	null	选中的文件。打开 isMultiple 时为数组。
label	string	—	必填。无障碍名称。
accept	string	—	HTML accept 列表，例如 .pdf,.docx 或 image/*。
isMultiple	boolean	false	是否允许多个文件。
maxSize	number	—	单个文件的最大字节数。
maxFiles	number	—	多选时的文件数量上限。
mode	'input' | 'dropzone'	'input'	紧凑输入框，或虚线拖放区。
placeholder	string	选择文件	未选择时的文字，跟随语言。
size	'sm' | 'md' | 'lg'	'md'	高度，分别是 28、32、36px。
status	FieldStatusInput	—	错误、警告或成功。未传时，被拒绝的文件会自己产生错误。
statusVariant	'attached' | 'detached' | 'tooltip'	'attached'	状态消息的位置。
isDisabled	boolean	false	禁止打开选择器，也不接受拖放。
disabledMessage	string	—	禁用原因。和 isDisabled 一起用时，悬停或键盘聚焦会显示这段提示，触发按钮仍可聚焦（带 aria-disabled），但打不开文件选择框。
labelTooltip	string	—	标签末尾信息图标里的说明。
isRequired	boolean	false	标记为必填。
isLoading	boolean	false	显示加载指示，用于上传过程。
description	string	—	标签下方的说明。
width	number | string	—	整个字段的宽度。数字按像素处理。
changeAction	(files) => void | Promise<void>	—	选中和清除之后调用。失败时发出 actionError，等待期间显示加载指示。
clearLabel	string	—	清除按钮的读屏名称，默认带字段名。提示只说「清除」。
containerClass	string | object | array	—	加到字段外壳的 class。在 InputGroup 和横向标签的 FormLayout 里没有外壳，此时不生效，开发环境会警告。
containerStyle	StyleValue	—	加到字段外壳的行内样式。
controlClass	string | object | array	—	加到文件框本体的 class。直接写在组件上的 class 也落在本体，不会警告。
controlStyle	StyleValue	—	加到文件框本体的行内样式。直接写在组件上的 style 也落在本体。

事件

名称	参数	说明
update:modelValue	File | File[] | null	选择变化时触发。
change	File | File[] | null	携带同一个值。发生在 changeAction 之前。
actionError	unknown, File | File[] | null	changeAction 抛错时触发。