介绍
uvx-ui 是面向 uni-app x 的跨端 UI 组件库,使用 UTS 与 UVue 编写。App 端编译为原生界面,同一套组件代码可运行在 Android、iOS、HarmonyOS、Web 和微信小程序。
核心特性
- 原生渲染:App 端不依赖 WebView,保留 uni-app x 的原生渲染能力。
- UTS 强类型:组件属性、事件和公开方法均使用明确类型,在编译阶段暴露问题。
- Vapor 优先:以 Vue Vapor 模式为主要运行方式,并通过条件编译兼容非 Vapor 工程。
- 跨端组件:当前源码包含 98 个组件,覆盖基础、表单、数据、反馈、布局与导航等常见场景。
- 主题适配:内置亮色、暗色主题及响应式主题状态,支持运行时切换。
- 国际化:内置简体中文、繁体中文和英文语言包,允许业务项目覆盖同名词条。
- easycom:完成
pages.json映射后,组件可直接在模板中使用,无需逐个导入和注册。
各组件的最低 HBuilderX 版本和平台差异可能不同,请以对应组件文档中的兼容性表格为准。
从哪里开始
首次接入建议按以下顺序阅读:
- 安装:从 DCloud 插件市场安装组件库,并配置全局样式和语言包。
- 快速上手:创建第一个使用 uvx-ui 的 UVue 页面。
- 配置:设置字号、弹层基础层级和语言。
- 主题与样式:使用亮暗主题和自定义品牌色。
- 注意事项:了解 uni-app x 的跨平台开发约束。
需要查找具体组件时,前往组件总览。
与 uv-ui 的关系
uvx-ui 延续了 uv-ui 的组件体系和设计经验,但并不是将原有 Vue 组件直接搬到 uni-app x。组件已按 UTS 强类型、UVue 原生渲染和 uni-app x 平台能力重新实现,使用时应以本站文档为准。
名称中的 uv 延续自 uv-ui,x 代表 uni-app x。
开源协议
uvx-ui 使用 MIT 协议,可免费用于个人或商业项目。使用组件库时仍需遵守目标平台、第三方服务及相关法律法规的要求。
