更新记录

1.0.0（2026-07-27） 下载此版本

• 首次发布
• 支持图片/视频/任意文件选择上传
• 支持 Android 原生文件选择器（多选）
• 支持上传进度条显示
• 支持文件格式 & 大小校验
• 支持上传取消
• 支持自定义上传 Header
• 零外部依赖

平台兼容性

uni-app(3.0.0)

其他

MOA Uploader - 原生文件上传组件

基于 uni-app 的原生文件上传组件，支持图片/视频/任意文件选择、上传进度条、格式 & 大小校验。

平台兼容

安装

通过 uni_modules 导入，或手动将 nevada-uploader 复制到项目 uni_modules 目录下。

用法

组件安装后自动注册，模板中直接使用 <moa-uploader> 即可：

<template>
  <moa-uploader
    ref="uploader"
    file-type="all"
    :max-count="5"
    :max-size="50"
    upload-url="https://your-api.com/upload"
    :upload-header="{ Authorization: 'Bearer xxx' }"
    btn-text="+ 上传文件"
    :uploaded-count="0"
    @upload-start="onStart"
    @upload-success="onSuccess"
    @upload-fail="onFail"
    @upload-complete="onComplete"
  />
</template>

<script>
export default {
  methods: {
    onStart({ file }) {
      console.log('开始上传:', file.name)
    },
    onSuccess({ file, responseData }) {
      console.log('上传成功:', responseData)
    },
    onFail({ file, error }) {
      console.error('上传失败:', error)
    },
    onComplete({ file }) {
      console.log('上传完成:', file.name)
    }
  }
}
</script>

Props

Events

方法（通过 ref 调用）

上传响应格式

组件期望服务端返回 JSON 格式：

{
  "success": true,
  "message": "上传成功",
  "data": { "url": "..." }
}

success 为 true 时视为上传成功，否则视为失败，message 会作为提示文案。

依赖

零外部依赖，仅使用 uni-app 内置 API（uni.uploadFile、uni.chooseImage、uni.showActionSheet）。