上传文件 (File Input)
v-file-input
组件是一个特殊的表单,它为选择文件,展示选中文件,展示上传进度提供了简洁的界面,旨在取代浏览器默认的文件上传组件。
使用
v-file-input
组件的是由 v-text-field 为基础的容器组件。
API
组件 | 描述 |
---|---|
v-file-input | 主要组件 |
示例
属性
接受文件格式
v-file-input
组件可以根据你的需求设定为接受某几种特定的文件类型。更多的信息,请参考 accept 属性 的文档。
文件显示为纸片 (Chip)
选择的文件可以显示成 chip 组件,当设定了 chips 和 multiple 时,每个纸片元素都会展示出来(和文件计数相反)。
计数器
当 show-size 属性和 counter 属性一同启用时,会下输入框下方显示文件总数和大小。
间距 (Density)
您可以使用 density 属性降低文件输入框的高度。
多选 (Multiple)
启用 multiple 属性可以使 v-file-input
同时包含多个文件。
前置图标
v-file-input
有一个默认的前置图标——prepend-icon。这个值既可以设定在组件上,也可以全局调整。要全局调整这个图标,请参考自定义图标页面. 。
显示文件大小
可以通过配置 show-size 属性来显示上传文件的大小。显示的大小可以是 1024(默认是 true 时)或者 1000。
验证
与其他输入类似,您可以使用 rules 属性来创建您自己的自定义验证参数。
插槽
选择的文件
你可以通过 selection
插槽,来自定义选择的文件的样式。例子中使用了 chips ,但实际上你可以使用任何组件或者标签。
杂项
复杂选择文件插槽
选择文件插槽的灵活性允许你构建复杂的用例。例子中,前两个选择的文件以纸片形式展示,其余的文件以一个提示表示。