Vue 3 中自定义文件选择按钮组件通过隐藏原生 input、ref 触发点击、v-model 双向绑定(支持单文件 File 或多文件 File[])、文件名显示与预览实现;需重置 input.value 防重复触发,图片预览注意 revokeObjectURL。

封装基础结构与事件绑定
使用 ref 获取原生 input 元素,通过 click() 主动触发文件选择;用 v-model 或 emit 向外同步选中的文件(FileList 或 File 数组)。
- 模板中隐藏原生 input(
display: none),只暴露自定义按钮 - 点击按钮时调用
inputRef.click() - 监听
@change事件获取event.target.files - 支持
multiple、accept等原生属性透传
支持 v-model 双向绑定
按 Vue 3 推荐方式,使用 defineModel()(需 Vue ≥ 3.4)或传统 modelValue + update:modelValue 事件实现双向绑定:
- 单文件模式:绑定一个
File对象(如头像上传) - 多文件模式:绑定
File[]数组(如附件批量上传) - 清空时设为
null或空数组,并重置input.value = ''防止重复选相同文件不触发 change
增强体验:文件名显示与预览
组件内部可维护 fileName 或 fileNames 计算属性,用于显示已选文件信息:
- 单文件:显示文件名 + 大小(如
avatar.jpg (124 KB)) - 多文件:显示数量(如
3 个文件)或截取前两个文件名 - 图片类文件可生成
URL.createObjectURL(file)供预览(注意后续需revokeObjectURL释放内存)
完整示例代码(TableSelector 风格兼容写法)
命名为 FileSelector.vue,使用 script setup:
立即学习“前端免费学习笔记(深入)”;
<template>
<div class="file-selector">
<el-button size="small" @click="triggerInput">{{ buttonText }}</el-button>
<input
ref="inputRef"
type="file"
:multiple="multiple"
:accept="accept"
@change="onFileChange"
style="display: none"
/>
<div v-if="fileName" class="file-info">{{ fileName }}</div>
</div>
</template>
<script setup>
import { ref, defineEmits, defineProps, computed } from 'vue'
const props = defineProps({
modelValue: { default: () => null },
multiple: { type: Boolean, default: false },
accept: { type: String, default: '' },
buttonText: { type: String, default: '选择文件' }
})
const emit = defineEmits(['update:modelValue', 'change'])
const inputRef = ref(null)
const fileName = computed(() => {
const files = props.modelValue
if (!files) return ''
if (Array.isArray(files)) {
return `${files.length} 个文件`
}
return `${files.name} (${(files.size / 1024).toFixed(1)} KB)`
})
const triggerInput = () => {
inputRef.value?.click()
}
const onFileChange = (e) => {
const files = e.target.files
if (!files.length) return
const value = props.multiple ? Array.from(files) : files[0]
emit('update:modelValue', value)
emit('change', value)
}
</script>
不复杂但容易忽略


















