Skip to content

上传文件 (File Input)

v-file-input 组件是一个特殊的表单,它为选择文件,展示选中文件,展示上传进度提供了简洁的界面,旨在取代浏览器默认的文件上传组件。

使用

v-file-input 组件的是由 v-text-field 为基础的容器组件。

API

组件描述
v-file-input主要组件

示例

属性

接受文件格式

v-file-input 组件可以根据你的需求设定为接受某几种特定的文件类型。更多的信息,请参考 accept 属性 的文档。

文件显示为纸片 (Chip)

选择的文件可以显示成 chip 组件,当设定了 chipsmultiple 时,每个纸片元素都会展示出来(和文件计数相反)。

计数器

show-size 属性和 counter 属性一同启用时,会下输入框下方显示文件总数和大小。

间距 (Density)

您可以使用 density 属性降低文件输入框的高度。

多选 (Multiple)

启用 multiple 属性可以使 v-file-input 同时包含多个文件。

前置图标

v-file-input 有一个默认的前置图标——prepend-icon。这个值既可以设定在组件上,也可以全局调整。要全局调整这个图标,请参考自定义图标页面. 。

显示文件大小

可以通过配置 show-size 属性来显示上传文件的大小。显示的大小可以是 1024(默认是 true 时)或者 1000

验证

与其他输入类似,您可以使用 rules 属性来创建您自己的自定义验证参数。

插槽

选择的文件

你可以通过 selection 插槽,来自定义选择的文件的样式。例子中使用了 chips ,但实际上你可以使用任何组件或者标签。

杂项

复杂选择文件插槽

选择文件插槽的灵活性允许你构建复杂的用例。例子中,前两个选择的文件以纸片形式展示,其余的文件以一个提示表示。