组件/ImageUploader 图片上传
通用组件

ImageUploader 图片上传

用于图片选择、预览、删除。

该页面由 AI 迁移生成,请谨慎使用

内容已迁移完成,但仍建议结合源码和人工评审结果使用。

ImageUploader 图片上传

用于图片选择、预览、删除。

import { ref } from 'vue' const files = ref([])

基础用法

ImageUploader

示例即将加载...
<template>
  <TxImageUploader v-model="files" />
</template>

API(Lite)

属性名类型默认值说明
modelValue当前图片列表
multiple是否允许一次选择多个文件
accept原生文件输入 accept 属性
disabled禁用选择和移除
max最大图片数量

Events

属性名类型默认值说明
update:modelValue-图片列表更新
change-图片列表变化
remove-移除图片后触发

交互契约

  • 当前组件通过点击添加按钮打开原生文件选择器;不提供拖拽上传入口。
  • 新选择的文件会生成 object URL 作为预览,并在移除或组件卸载时释放。
  • max 会限制新增文件数量;超过上限的文件会被忽略。
  • disabled 会同时禁用添加按钮、文件输入与移除按钮。