更新记录

3.8.2（2026-04-17） 下载此版本

fix: 修复级联选择器仅回显未改动时确认返回空数组的问题

• 提取 getSelectedValues 方法统一处理选中值获取逻辑，消除重复代码
• 初始化时若 modelValue 为空则显式清空 confirmValues，避免状态残留
• 数据回显后同步更新 confirmValues，确保未手动修改直接确认时能正确返回默认值
• 优化 handleConfirm 逻辑，优先使用已同步的确认值，提升事件触发准确性

3.8.1（2026-04-16） 下载此版本

feat(select): 增强下拉框样式能力并补充 100% 宽度示例

• 新增 up-select 的边框样式能力与下拉面板宽度配置，便于构建接近 PC Select 的交互样式。
• 新增 border 属性：支持为触发区显示边框、圆角和内边距（默认关闭，保持兼容）
• 新增 optionsWidth 属性：支持 String/Number，允许 px/rpx/% 等宽度控制
• 优化下拉面板定位逻辑，保留溢出时左右对齐修正行为
• 更新 select 示例页：新增“边框与下拉宽度”示例，并改为 100% 宽度展示

3.8.0（2026-04-16） 下载此版本

feat: 新增暗黑模式支持完成全链路适配与主题能力统一

【架构设计】

1. 建立主题变量分层：新增核心令牌层 theme-vars-core（统一定义亮/暗主题语义变量），并通过 theme-vars 进行聚合输出。
2. 建立组件主题扩展层：为 navbar/notice-bar/subsection/switch/tag 等组件新增独立 theme-vars 文件，按组件边界管理主题差异，降低跨组件耦合。
3. 建立运行时主题层：新增 libs/theme/theme.js，结合全局 mixin 与入口注入实现主题状态读取、切换与分发，形成“变量定义 -> 运行时注入 -> 组件消费”的闭环。

【关键改动范围】

1. 基础设施：App.up.vue、common/mixin.js、pages.json、manifest.json、theme.json 及全局样式入口同步调整。
2. 组件库：大规模修复表单、导航、反馈、布局、展示类组件在暗黑模式下的背景、文字、边框、占位符、选中态对比度问题。
3. 示例页与模板页：对示例与业务模板页进行暗黑联调，减少页面级重复 pageStyle 覆盖，统一回归到主题变量驱动。

【兼容性与收益】

1. 保持组件 API 行为不变，主要为样式与主题渲染层升级。
2. 统一暗黑适配策略，减少页面散落样式补丁，后续新增组件可按统一主题规范快速接入。
3. 提升微信小程序/H5 场景下暗色模式的一致性与可维护性。

平台兼容性

uni-app(4.66)

其他

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应用到您的产品中。