更新记录

3.8.130(2026-10-08) 下载此版本

fix: 修复微信小程序 u-text 的 v-bind 编译报错

修复 3.8.128 引入的 u-text 小程序编译兼容性回归,恢复组件原有的属性继承行为。

  • u-text:移除原生 button 上不受小程序编译器支持的 v-bind="$attrs",修复 v-bind="" is not supported. 报错。
  • u-text:恢复根节点属性继承,避免普通文本的 id、data-* 等属性丢失;保留原有 data-index、open-type 属性与事件绑定。
  • 回归验证:新增真实微信小程序模板编译和 H5 属性继承测试,并通过微信小程序全量构建。
  • 升级说明:撤回 3.8.128 中任意 data- 属性向内部分享按钮的自动透传尝试;需要自定义分享数据时,请使用原生 button 显式绑定 data- 并设置 open-type="share"。

3.8.129(2026-10-08) 下载此版本

fix: 修复条码画布引用时序与微信小程序导航栏胶囊遮挡

本次更新修复条码组件获取画布引用的时序问题,并优化微信小程序导航栏右侧区域布局。

  • u-barcode:等待组件自身视图更新后再获取画布引用,避免画布引用尚未就绪。
  • u-navbar:微信小程序右侧插槽、图标和文字默认避让原生胶囊按钮,修复遮挡问题(#1058)。
  • u-navbar:新增 avoidCapsule 属性,默认 true,可设置为 false 保持原有右侧布局;同步全局默认配置与类型声明。

3.8.128(2026-10-03) 下载此版本

feat: 新增 u-video 视频播放器组件,并集中修复列表滚动、日历副标题、下拉菜单等 20+ 个问题

本次为大版本迭代:新增 u-video 视频播放器组件(含弹幕、进度条、自定义控制层),随包提供面向 AI 编码助手的 uview-plus skill,并集中修复了列表锚点滚动、日历副标题同步、select 面板、App 端字体加载等一批跨组件问题。

  • 新增 u-video:统一封装 video 播放能力,支持弹幕(danmaku)、自定义进度条与控制层、常见播放属性透传,覆盖 H5 / 小程序 / App
  • 随包提供 skills/uview-plus:面向 AI 编码助手的技能包,含 setup、components、api、icons、pitfalls 参考文档
  • u-list / u-list-item:新增 anchor 锚点滚动定位,修复 scrollIntoViewById 调用后不滚动的问题(#671、#721),并合并 anchor 定位实现
  • u-calendar:修复关闭再打开后副标题与月份内容不一致;优化大 monthNum 下的渲染性能
  • u-select:完善面板指示器、自适应宽度与多选回显逻辑
  • u-icon:字体加载失败后改由定时器重试,修复 u-search 输入后无法再次聚焦的问题(#844)
  • u-dropdown:修复 nvue 下菜单宽度被压缩的问题(#814)
  • u-collapse / u-collapse-item:修复展开后内容变高被裁切;value 为 null 时不再重置展开状态
  • u-cell:必填星号改用真实节点渲染,修复小程序与 nvue 下不显示
  • u-slider:修复 border-box 下的滑块错位;点击轨道时直接触发 change
  • u-textarea:回车默认换行并支持 confirmHold
  • u-text:透传 data-* 属性,修复分享回调拿不到数据的问题
  • u-upload:透传 H5 端视频真实的 File 对象
  • u-search:修复小程序端占位符颜色首屏不生效
  • u-cate-tab:优化大量图片场景的首屏渲染与滚动联动
  • u-tabs:去除 scroll-view 上无效的 flex 布局
  • u-picker:修复滚动过上级列后的 columnIndex 错位
  • u-datetime-picker:修复空值回填并让确认返回当前选中值
  • u-grid:兼容旧版 WebView 的网格布局
  • u-parse:支持 quill 的对齐 class
  • u-number-keyboard:修复 PC 浏览器退格键不触发;u-car-keyboard 支持警车车牌输入
  • 类型声明:补齐步进器、分页器与表单相关类型;补齐 u-video 与 icon 字体相关配置
  • 合入任务分支 task/71、task/82
查看更多

平台兼容性

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.