更新记录

3.8.136（2026-10-27） 下载此版本

fix: 修复 u-goods-sku 关闭笔误与 u-icon App 本地字体在 npm 安装/正式 APK 下的问题

本次更新修复 u-goods-sku 关闭弹窗的笔误，并解决 App 端本地图标字体在 npm 安装方式与云打包正式 APK 上显示异常的问题（对应 issue #1069）。

  • u-goods-sku：close() 中 this.false = true 为无效赋值（误建 false 属性、弹窗从未真正关闭），改为 this.show = false 真正关闭弹窗；并将 popup 的 close/closed 事件经模板透传给父组件，避免 ref.close() 触发 popup 的 show watcher 补发导致父组件重复收到 close 事件
  • u-icon（App 本地字体）：构建插件 transform 原仅按 uni_modules/uview-plus/... 绝对路径严格匹配，npm 安装到 node_modules/uview-plus/... 时永远不命中、App 远程 @font-face 不被剥离；改为按包内相对路径后缀匹配，同时覆盖 uni_modules / node_modules / pnpm 真实路径
  • u-icon（App-Vue）：原在 App-Vue 路径预先 plus.io.convertLocalFileSystemURL 转换 _www 字体路径，导致云打包正式 APK 图标不显示；App-Vue 改用原始 _www/static/app-plus/uview-plus/upicon.ttf 路径、交由 view 层转换一次，自定义基座与正式 APK 均可正常显示（App-NVue 仍保持原转换逻辑）

3.8.135（2026-10-27） 下载此版本

feat: 新增 u-lottie 动画组件，u-upload 新增 mediaType 并修复 chooseMedia 平台判断

本次更新新增 Lottie 动画组件 u-lottie，覆盖 H5/App-Vue、微信小程序与鸿蒙多端渲染；同时为 u-upload 补上 mediaType 属性，并修复 chooseMedia 按平台硬编码导致的兼容性问题。

  • 新增 u-lottie 组件：支持 filePath 传入动画 JSON 地址（http(s)，H5 / App-Vue 额外支持本地静态路径），或 animationData 直接传入 Lottie JSON 对象（优先级高于 filePath）；可配置 contentModel 内容填充模式（ScaleToFill / AspectFill / Center）、loop 循环播放、autoplay 数据与引擎就绪后自动播放
  • u-lottie 跨端渲染：H5 / App-Vue 基于 lottie-web SVG 渲染器，H5 端引擎按需加载、加载失败自动清理；微信小程序基于 lottie-miniprogram 画布渲染；鸿蒙通过 harmony-canvas-adapter 画布适配，并修复同步渲染未提交绘制的问题
  • u-lottie 实例方法：reload / playAnimation / pauseAnimation / resumeAnimation / cancelAnimation；statechange 事件统一回报 ready / play / pause / resume / stop / complete / error 状态（微信小程序从 event.detail 读取）
  • u-upload：新增 mediaType 属性（默认 ['image', 'video']），accept 为 media 时透传给 chooseMedia 控制可选文件类型（image / video / mix）
  • u-upload：chooseMedia 不再做平台编译判断，改为运行时检测接口是否存在，不存在时自动回退到 chooseImage，修复部分平台 accept="media" 直接报错的问题
  • 新增 componentsD/lottie 示例页

3.8.134（2026-10-23） 下载此版本

fix: 修复 up-cropper 小程序端底部操作栏透出页面与导出参数失效

本次更新修复 u-cropper 的三个问题：iOS 上底部操作栏与页面浮动元素重叠、quality 参数完全失效，以及小数质量被悄悄改回 0.9。

  • u-cropper：修复 iOS 上底部操作栏与页面浮动按钮/标签重叠的问题。画布高度减掉了底部安全区，而操作栏仍是 50px 贴在屏幕最底，两者之间露出一条约安全区高度的页面背景，页面上浮动的元素会从这条缝里透出来；安卓 safeAreaInsets.bottom 为 0，所以只有苹果机能看到。现在操作栏高度改为 50px + 安全区并用 padding-bottom 让出，与画布严丝合缝，按钮也完整位于 home 指示条上方
  • u-cropper：新增 fileType 属性（默认 png，可选 png/jpg）。原先 5 处导出都把 fileType 硬编码为 png，PNG 是无损格式、没有质量档位，quality 形同虚设；只有 jpg 才会按 quality 压缩，chooseImage 的 params 也可覆盖
  • u-cropper：修复 quality 归一化使用 parseInt 导致 parseInt(0.5) 为 0、被 || 0.9 改回 0.9 的问题，改用 parseFloat 并夹取到 0-1，number 与数字字符串都认
  • u-cropper：safeAreaInsets 取值增加兜底，个别端取不到时不再算出 NaN 把布局顶飞
  • 升级说明：fileType 默认仍为 png，输出格式与升级前一致，不需要改代码；需要压缩体积时显式传 fileType="jpg" 并配合 quality
  • 回归验证：新增 scripts/verify-cropper-export-and-safe-area.mjs，直接加载组件脚本真实调用 computed 与方法，锁住操作栏安全区样式、fileType 透传与 quality 归一化
查看更多

平台兼容性

uni-app(4.66)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
- √ √ √ √ √ √ √ √
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
√ √ √ - - - √ √ - - - -

其他

多语言 暗黑模式 宽屏模式 蒸汽模式
√ × × ×

logo

uview-plus 3.0

多平台快速开发的UI框架

说明

【文档有广告，不喜勿入谢谢】

uview-plus，是uni-app全面兼容vue3/nvue/鸿蒙/uni-app-x(已经发布https://ext.dcloud.net.cn/plugin?name=uview-ultra)的uni-app生态框架，全面的组件和便捷的工具会让您信手拈来，如鱼得水。uview-plus是基于uView2.x移植的支持vue3的版本，感谢uView。

版本

uview-plus v3 (uni-app版本)

  1. 保持选项式API，尽可能兼容原有uview2各种API，比如mixins，方便大家升级更容易；
  2. 新手友好，保持原汁原味js，二次开发方便，未使用typescript重写，但带有独立的类型申明包；

uview-ultra v4 (uni-app-x版本)

  1. 尽可能保持原有组件的API一致，方便大家升级；
  2. 使用uts + 组合式API架构级全新重构，但仍然保持源码的简易，不封装过于复杂，便于修改。

可视化设计

uview-plus现已推出免费可视化设计，可以方便的进行页面可视化设计，导出源码即可使用。极大提高前端页面开发效率；如产品经理设计师直接使用更可作为高保真高可用原型制作工具，让设计稿即代码，无需传统的设计稿开发还原步骤。

文档

官方文档：https://uview-plus.jiangruyi.com 备用文档：https://uiadmin.net/uview-plus

预览

您可以通过微信扫码，查看最佳的演示效果。

H5 微信小程序 安卓 鸿蒙Next（已上架）


链接

关于PR

我们非常乐意接受各位的优质PR，但在此之前我希望您了解uview-plus是一个需要兼容多个平台的（小程序、h5、ios app、android app）包括nvue页面、vue页面。 所以希望在您修复bug并提交之前尽可能的去这些平台测试一下兼容性。最好能携带测试截图以方便审核。非常感谢！

安装

uni-app插件市场链接 —— https://ext.dcloud.net.cn/plugin?name=uview-plus

请通过官网安装文档了解更详细的内容

快速上手

请通过快速上手了解更详细的内容

使用方法

配置easycom规则后，自动按需引入，无需import组件，直接引用即可。

<template>
    <u-button text="按钮"></u-button>
</template>

AI 编码助手

包内 skills/ 目录提供了给 AI 编码助手用的 uview-plus 使用说明（Agent Skills 的 SKILL.md 格式），包含组件与图标清单、easycom 接入、uni.$u 工具库和多端常见坑，让 AI 少猜少写错。

Claude Code 等工具把它拷到项目的 .claude/skills/ 下即可生效：

mkdir -p .claude/skills
cp -r node_modules/uview-plus/skills/uview-plus .claude/skills/

其他工具的接法与 uni_modules 装法见 skills/README.md。

版权信息

uview-plus遵循MIT开源协议，意味着您无需支付任何费用，也无需授权，即可将uview-plus应用到您的产品中。

Root 组件基于上游项目 uni-ku/root 二次开发，已按 MIT 要求保留其原始授权文件：libs/root/LICENSE。

隐私、权限声明

1. 本插件需要申请的系统权限列表：

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明：

无

3. 本插件是否包含广告，如包含需详细说明广告表达方式、展示频率：

请注意本插件开发文档包含弹窗广告每日展示一次，源码纯净无广告。

许可协议

MIT License

Copyright (c) 2024 https://uiadmin.net/uview-plus

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

评论列表 撰写评论 向官方投诉
加载更多...