更新记录

0.1.14（2026-08-18） 下载此版本

• 蒸汽模式兼容：lines CSS 声明迁移为 <text> 的 :max-lines 属性（官方蒸汽模式方案），消除 Vapor 运行时与 CSS 编译器警告

0.1.12（2026-08-17） 下载此版本

• 修复 Android 端选图/选视频/上传时的 ClassCastException 崩溃：不再把 SDK 结果对象（ChooseImageSuccess / ChooseVideoSuccess / UploadFileSuccess）强制转换到组件自定义 type，改用 SDK 全局类型直接取值、对象型文件走 UTSJSONObject getter（APP-ANDROID 根因修复，其余端行为不变）。

0.1.11（2026-08-14） 下载此版本

• 精简 readme：移除内部开发向内容（设计说明 / 实现细节 / 平台差异实现等），只保留安装、用法、API、主题等用户文档

平台兼容性

uni-app x(4.25)

其他

nax-upload

nax-ui 上传组件（uni-app x / uvue）。

提供文件列表预览、选择、删除与状态展示能力。实际上传由业务在 afterRead 中调用 uni.uploadFile 等完成。

依赖：

uni_modules/nax-icon
uni_modules/nax-ui-theme

easycom 自动生效。

推荐同时安装主题包

@import "@/uni_modules/nax-ui-theme/theme/default.css";

页面根节点加 class="nax-theme"。

基础用法

<template>
  <nax-upload
    :file-list="fileList"
    :max-count="6"
    name="photos"
    @after-read="onAfterRead"
    @delete="onDelete"
  ></nax-upload>
</template>

<script setup lang="uts">
  const fileList = ref([] as any[])

  function onAfterRead(e: UTSJSONObject) {
    const files = e.getArray('files')
    // 可在此调用 uni.uploadFile，并更新 fileList 的 status / url
    const next = [] as any[]
    var i = 0
    while (i < fileList.value.length) {
      next.push(fileList.value[i])
      i++
    }
    if (files != null) {
      var j = 0
      while (j < files.length) {
        next.push(files[j])
        j++
      }
    }
    fileList.value = next
  }

  function onDelete(e: UTSJSONObject) {
    // 组件已 emit update:fileList；也可自行处理
  }
</script>

fileList 项结构

Props

Events

Methods（组件 ref）

Slots

自动上传

开启 autoUpload 并配置 action 后，组件在 afterRead 之后自动调用 uni.uploadFile：

<nax-upload
  v-model:file-list="fileList"
  auto-upload
  action="https://example.com/upload"
  :header="header"
  :form-data="formData"
  name="file"
  @success="onSuccess"
  @fail="onFail"
></nax-upload>

const fileList = ref([] as any[])
const header = ref({ Authorization: 'Bearer xxx' } as UTSJSONObject)
const formData = ref({ biz: 'avatar' } as UTSJSONObject)

1. 必须绑定 v-model:file-list，才能回写 uploading/success/failed
2. name 也作为 uploadFile 文件字段名
3. 成功响应尝试解析 url / data.url / path / fileUrl
4. 失败项可调 ref：upload(index) / uploadAll() / reupload(index)

暗色主题

暗色主题时，请通过 custom-class 传入 nax-theme-dark；组件会在内部使用对应的深色背景、边框、图标和文字色，未传入时使用浅色样式。

主题

通过 CSS 变量覆盖：