更新记录

1.0.4（2026-05-26） 下载此版本

• uni-badge-view 修复类名拼写错误
• uni-nav-bar 纠正类名拼写错误

1.0.3（2026-05-15） 下载此版本

• uni-collapse 支持 content-wrap-class 定义内层容器样式

1.0.2（2026-05-12） 下载此版本

• uni-badge-view 更新文档
• uni-index-bar 更新文档
• uni-number-box 移除无用依赖
• uni-rate 修复 starClass 和 starActiveClass 设置不生效的问题

平台兼容性

uni-app x(5.08)

项目介绍

uni-ui x，是DCloud为 uni-app x 提供的扩展组件库。开源库地址

uni-ui x 是全新设计的，与为uni-app做的uni-ui不同。

uni-ui x 是伴随着HBuilderX 5.08发版的。5.07版本上有部分组件在部分平台有兼容性问题，详见组件详情的兼容性表格。再往前的HBuilderX版本未测试。

特点

• 性能 uni-ui x 非常注重性能，在DOM层级控制、包体积、代码执行时间方面精益求精。

它了解 uni-app x 蒸汽模式的最佳实践，尽可能利用模板和样式的预编译特性来提升性能。当然它也支持非蒸汽模式。

• 合理的抽象

一个组件的抽象能力非常重要，如何在自定义性、易用性、性能之间尽可能三全其美。

很多组件为了满足使用者的需求，封装的属性越来越多，但组件使用者仍然在抱怨自定义性不足。

尤其是组件把样式封装在组件属性上，造成用户需要自定义样式时无限封装属性，并且这些属性的控制无法使用css变量。

uni-ui x 提供了完全的样式自定义能力，所有的样式定义都可以通过class设置，组件属性只控制功能逻辑。

• 组件的根节点样式，可以在使用组件时的组件class或style上设置。
• 组件的子节点样式，可以通过externalClass设置样式。子组件开放自己的样式出来，外部可通过externalClass进行子组件的样式自定义。

组件使用者完全可以通过css自己控制所有样式。无需修改组件源码。加上css变量加持，灵活度远高于其他组件库。

使用者可以通过css变量完全自定义自己的主题，而不会被组件属性上不能写css变量困扰。

• 为AI设计

uni-ui x 优先代码而不是二进制文件。目前没有引入字体文件。这处于性能考虑，也出于AI友好度考虑。

以箭头为例，uni-ui x 中使用一个view配置左下边框并transform旋转来实现，这种设计性能比字体更好，且AI可以方便的理解这段代码的UI表现，可以在代码层面调整样式。

如果是字体图片，AI很难理解、生成、修改。

再举一个例子，uni-tab下沉midbutton，涉及一个贝塞尔曲线，此时没有使用图片，而是使用svg，同样是为了方便AI理解和修改。

• 中性

uni-ui x的风格是中性的，和uni内置组件、小程序内置组件一样，重视是开发者可以自定义成各种风格，而不是为开发者提供某套风格。

开发者可以通过自定义css，形成自己的风格，或者交给AI完成类似工作。

• 没有写死的颜色和文字

• 没有写死的文字，不影响国际化。

• 没有写死的颜色，不影响自定义主题。

uni-ui x 已支持的组件列表

uni-ui的升级建议@uniuiupgrade

为uni-app提供的uni-ui，升级到uni-app x时无法直接对照升级，因为组件名称、用法都有变化。

但升级时，老版uni-ui组件在uni-app x下同等功能的新组件是什么，这里说明下功能映射关系：

标记为无的，大多比较简单，对于AI而言直接写相关UI比下载学习一个组件更合适。

交流群

有关 uni-ui-x 组件的任何意见或建议，欢迎通过 uni-ui-x im 交流群 沟通交流。