更新记录

3.8.121(2026-09-07) 下载此版本

fix: 修复 up-button 真机首次点击后失效

默认 throttleTime 为 0 时直接同步执行点击回调,不再依赖异步 setTimeout 释放全局节流锁,避免真机定时器未释放时后续点击被拦截。新增零延迟连续调用回归校验。

3.8.120(2026-09-07) 下载此版本

fix(types): 组件类型可直接从包名导入,模板提示补齐 u-/u-- 前缀

本版仅完善 TypeScript 类型与 IDE 模板提示,不改变组件运行时行为和 API。

  • uview-plus 包入口重新导出 126 个公开组件类型,Props、Slots、Ref 可直接从包名导入,不再依赖 uview-plus/types/comps/* 内部路径
  • Ref 类型统一按 typeof 导出,避免将源文件中的 const 声明当作类型使用时报 TS2749
  • GlobalComponents 同时登记 up-u-u-- 三种 easycom 前缀,模板中的 u-buttonu--button 写法也能获得组件类型提示
  • 保留一份组件清单,通过模板字面量键改写生成三种前缀,避免清单重复维护
  • 新增 verify:types-barrel-exports 回归校验,防止入口类型导出与模板组件登记清单漂移

3.8.119(2026-09-05) 下载此版本

fix: 修复 datetime-picker format 兼容性与 tabbar 边框切页丢失

本版修复两个独立问题,均不涉及组件 API 变更。

fix: datetime-picker format 兼容库自身的 yyyy-mm-dd 写法,字符串绑定值不再退回 minDate (#537)

库内置的日期格式化工具 timeFormat 支持 yyyy-mm-dd 写法(全小写),但 u-datetime-picker 的 format 解析只识别 YYYY-MM-DD(全大写),导致用户按文档示例传入小写 format 时,传入的字符串绑定值无法被正确解析,组件退回到 minDate 而非用户期望的日期。

  • format 解析逻辑补充小写月日模式 mm / dd,与库自身的 timeFormat 对齐
  • 保持对原有大写 MM / DD 的兼容
  • 新增 verify:datetime-picker-format 回归校验

fix: tabbar 顶部边框改为组件内联绘制,修复切换页面后边框丢失 (#873)

u-tabbar 的顶部边框原先靠模板上的全局工具类 u-border-top 绘制,组件自身 scoped 样式表没有任何 border 声明。该类只存在于宿主项目的全局样式表,而小程序自定义组件有样式隔离,能否命中取决于宿主引入全局样式的方式,于是出现同一个 tabbar 在首页有边框、切到另一个 tab 页边框消失。

  • 改为在 tabbarStyle 里内联 borderTopWidth/Style/Color,边框跟着组件走
  • 去掉 borderColor 上用来压全局类 !important 的 hack(nvue/weex 无法解析)
  • 让 borderColor 为空时的主题边框色回退真正生效
  • 新增 verify:tabbar-border 回归校验
查看更多

平台兼容性

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>

版权信息

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.