更新记录
1.0.31(2026-11-19)
Bug Fixes | Bug 修复
- ux-navbar: 修正导航栏高度单位的描述错误问题
Features | 新功能
- ux-button: 新增fontSize、bold、color、height四个可配置属性,支持自定义按钮文字样式和尺寸
- button: 新增按钮字号、文字色和自定义高度演示示例
平台兼容性
uni-app x(5.03)
| Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | √ |
其他
| 多语言 | 暗黑模式 | 宽屏模式 | 蒸汽模式 |
|---|---|---|---|
| √ | √ | √ | √ |
先确认版本:本插件是 UTS 版。
TS 版与 UTS 版各自独立发布,但组件、能力与缺陷修复同步迭代;两者只是语言不同、文件后缀不同(
.ts/.uts),装错了组件编译不过。
uView Pro X 是 uView Pro 在 uni-app x 生态下的版本(UTS 版)。组件统一使用 ux- 前缀,源码为强类型 UTS,App 端编译为 Kotlin / Swift 原生代码,一套代码原生运行于 App(Android / iOS / HarmonyOS)、H5、微信与支付宝小程序。
| App-Android | App-iOS | App-鸿蒙 | H5 | 微信小程序 | 支付宝小程序 |
|---|---|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
产品矩阵
uView Pro 家族覆盖 uni-app 与 uni-app x 双生态,按项目技术栈选型(本插件为 uView Pro X UTS 版):
| 产品 | 定位 | 技术栈 | 授权 | 入口 |
|---|---|---|---|---|
| uView Pro | 跨端 UI 框架:80+ 高质量组件、丰富工具库、开箱即用模板,内置多主题 / 暗黑 / 国际化,一键适配 H5 / App / 鸿蒙 / 小程序 | uni-app · Vue3 + TS | 开源 | 官网 · GitHub |
| uView Pro Starter | 基于 uView Pro 的快速启动模板,一套代码全面兼容 H5 / 小程序 / Android / iOS / 鸿蒙 | uni-app · Vue3 + TS | 开源 | 官网 · GitHub |
| uView Pro X · UTS 版(本插件) | uni-app x 组件库:UTS 强类型,App 端编译为 Kotlin / Swift 原生,内置多主题 / 暗黑 / 国际化 / 请求层 | uni-app x · UTS + UVUE | 付费 | 官网 · 插件市场 |
| uView Pro X · TS 版 | uni-app x 组件库:全量 TS 强类型,App 端编译为 Kotlin / Swift 原生,内置多主题 / 暗黑 / 国际化 / 请求层,需 HBuilderX 5.31+ | uni-app x · TS + UVUE | 付费 | 官网 · 插件市场 |
特性
- 80+ 高质量组件:覆盖基础 / 表单 / 数据 / 反馈 / 布局 / 导航 / 其他七大分类,移动端常见场景开箱即用。
- 原生渲染:App 端走 uni-app x 的蒸汽模式(vapor),直接驱动原生节点,不经过虚拟 DOM。
- 强类型:组件 Props / Events / Slots 均由 UTS 约束,配合
types/global.uts统一对外类型,错误在编译期暴露。 - 样式隔离:采用
styleIsolation策略 2.0,组件样式与业务样式互不污染。 - 多主题与暗黑模式:内置官方蓝主题,支持自定义多主题、亮色 / 暗黑 / 跟随系统切换,选择自动持久化,App 端原生背景联动。
- 国际化:内置中文 / 英文 / 法文语言包,支持合并扩展自定义语言包,运行时切换并持久化。
- 零三方运行时依赖:工具函数与 hooks 统一挂在
$u上,不引入额外运行时库。 - 内置请求层:
httpaxios 实例模型(双向拦截器 / 派生实例 / 上传下载进度)+useRequest页面三态,同样零三方依赖。 - easycom 开箱即用:
ux-*前缀组件自动注册,无需手动 import 与局部注册。
演示与体验
![]() |
![]() |
![]() |
![]() |
| H5 (浏览器扫码) |
微信小程序 (微信扫码) |
支付宝小程序 (支付宝扫码) |
APP(安卓) (浏览器扫码) |
安装
前置条件:HBuilderX 5.03+(用 UTS 语言策略编译的 uni-app x 项目)。本插件只服务 UTS 项目;TypeScript 项目请装另一个插件 uView Pro X · TS 版,装错了组件编译不过。
在 DCloud 插件市场 打开本插件,点击「下载插件并导入 HBuilderX」;也可在 HBuilderX 的插件市场面板搜索 uview-pro-x-uts 安装。
导入后组件库位于项目的 uni_modules/uview-pro-x/ 目录,easycom 规则随包生效。
快速上手
1. 配置 easycom(pages.json)
{
"easycom": {
"autoscan": true,
"custom": {
"^ux-(.*)": "@/uni_modules/uview-pro-x/components/ux-$1/ux-$1.uvue"
}
}
}
配置完成后,ux- 开头的组件无需手动 import,直接写标签即可使用。
2. 注册插件(main.uts)
注册插件后即可使用国际化、多主题等能力;全部参数可选,不传则使用默认值。
import App from './App.uvue'
// 必须使用命名导入:加密版入口不转发 default
import { uViewProX, zhCN, enUS } from '@/uni_modules/uview-pro-x'
import { createSSRApp } from 'vue'
export function createApp() {
const app = createSSRApp(App)
app.use(uViewProX, {
// 国际化:注册语言包并指定默认语言
locale: {
locales: [zhCN, enUS],
defaultLocale: 'zh-CN'
}
})
return { app }
}
3. 引入主题样式(uni.scss)
源码版:在项目 uni.scss 中直接引入组件库主题文件。
@import '@/uni_modules/uview-pro-x/theme.scss';
普通授权版(加密):插件包内无法 @import,需把 theme.scss 中的 $u-* 变量块复制到项目 uni.scss 末尾。完整变量块见快速开始。
4. 开始使用
<template>
<view class="page">
<ux-input v-model="siteUrl" placeholder="请输入地址" border />
<ux-button type="primary" text="提交" @click="onSubmit" />
<ux-tag text="新" type="error" />
</view>
</template>
<script setup lang="uts">
import { $u } from '@/uni_modules/uview-pro-x'
const siteUrl = ref('')
const onSubmit = () => {
// 校验输入的地址是否为合法的 http(s) URL
if (!$u.test.url(siteUrl.value)) {
uni.showToast({ title: '请输入正确的地址', icon: 'none' })
return
}
console.log('提交内容:' + siteUrl.value)
}
</script>
进阶用法
$u 全局工具对象
import { $u } from '@/uni_modules/uview-pro-x'
| 常用能力 | 说明 |
|---|---|
$u.test.url('https://uviewpro.cn') |
URL、邮箱、数字、区间等 20+ 种正则与类型校验 |
$u.addUnit(20) |
数值转带单位字符串(不传单位默认补 px) |
$u.toStyle(obj) |
样式对象转样式字符串 |
$u.debounce / $u.throttle |
防抖 / 节流函数包装 |
$u.deepClone(obj) / $u.deepMerge(a, b) |
深克隆 / 深合并 |
$u.hexToRgba('#2979ff', 0.3) |
十六进制颜色转 rgba |
$u.color.primary |
读取当前主题色(响应式,随主题 / 暗黑切换自动更新) |
内置 Hooks
import { useTheme, useLocale, useCountDown } from '@/uni_modules/uview-pro-x'
| Hook | 用途 |
|---|---|
useTheme |
主题切换、暗黑模式、CSS 变量生成 |
useLocale |
国际化翻译、语言切换与持久化 |
useCountDown |
倒计时 |
useDebounce / useThrottle |
防抖 / 节流 |
usePopup |
弹窗开关状态 |
useNotice |
滚动通告栏状态 |
useRect |
元素几何信息查询 |
useTouch |
触摸手势(滑动距离 / 方向) |
useSafeArea |
底部安全区高度 |
useWindowInfo |
屏幕 / 窗口信息 |
useDeviceInfo |
设备信息(平台 / 型号 / 系统等) |
usePageScroll |
页面滚动距离,页面 onPageScroll 与 scroll-view 共用一条通道 |
useRequest |
请求三态(loading / data / error),重跑先取消、卸载自动取消 |
另有
useBEM、useStyle、useParent、useChildren、useConfig等为组件内部工具,二次开发组件时可参考。
HTTP 请求
import { http, useRequest } from '@/uni_modules/uview-pro-x'
// axios 实例模型:http.create 派生独立实例,拦截器成链、上传下载带进度
const api = http.create({ baseURL: 'https://example.com' })
api.get('/api/user').then((res) => {
console.log(res.data)
})
// 页面级三态:重复 run() 先取消上一次,组件卸载自动取消
const user = useRequest((ctx) => api.get('/api/user', null, { signal: ctx.signal }))
// user.loading / user.data / user.error / user.run() / user.cancel()
失败一律 reject HttpError,isCancel(e) 区分取消与真实失败;完整能力见http 请求与useRequest。
主题与暗黑模式
import { useTheme } from '@/uni_modules/uview-pro-x'
const { setTheme, setDarkMode, toggleDarkMode, isInDarkMode } = useTheme()
setTheme('purple') // 切换主题(名称需已注册:内置 'uviewpro' 或自定义主题)
setDarkMode('dark') // 'light' | 'dark' | 'auto'(跟随系统)
toggleDarkMode() // 亮暗一键切换
自定义多主题:在 app.use(uViewProX, { theme: [...] }) 中传入主题数组(与内置官方蓝合并,同名覆盖)。
app.use(uViewProX, {
theme: [
{
name: 'purple',
label: '霞光紫',
color: { primary: '#7c3aed' }
}
]
})
国际化
import { useLocale } from '@/uni_modules/uview-pro-x'
const { t, setLocale, currentLocale } = useLocale()
t('uModal.title') // 翻译
setLocale('en-US') // 运行时切换语言(自动持久化)
自定义语言包在注册插件时传入 locale.locales 合并(同名覆盖)。
app.use(uViewProX, {
locale: {
locales: [zhCN, enUS, zhTW], // zhTW 为自定义语言包
defaultLocale: 'zh-CN'
}
})
注意事项
装之前对一遍这几条,能省掉大部分「跑不起来」:
- 项目类型:只支持 uni-app x(
.uvue页面)。uni-app 的 Vue2 / Vue3 项目请用 uView Pro,两边组件与 API 不通用。 - 脚本后缀:页面脚本写
<script setup lang="uts">,入口是main.uts;从 TS 版搬代码时后缀与类型写法都要改,不能直接混拷。 - 组件前缀:本库是
ux-;u-前缀属于 uView Pro,两套标签不能混在一个页面里。 - 导入路径:组件、工具、hooks、类型一律从库入口
@/uni_modules/uview-pro-x导入,不要引libs/等下级目录——加密版不含下级目录的导出。 - 命名导入:加密版入口不转发
default,import uViewProX from ...拿到的是undefined,必须import { uViewProX } ...。 - 主题文件:加密版插件包内无法
@import,需把$u-*变量块复制到项目uni.scss。 - App 端:走蒸汽模式(vapor),改了组件库或 manifest 后要重新生成自定义基座,再真机运行。
版本与售后
本库有两种获取方式,组件、API、主题与语言包完全一致,差别只在接入细节与能否修改源码。
两版同步迭代:新组件、新能力、缺陷修复都会在 TS 版与 UTS 版上同步落地。选哪个只看项目用哪种语言,不存在一版新、一版旧。
| 版本 | 源码 | 接入差异 |
|---|---|---|
| 源码版 | 含完整 UTS 源码,可自行修改、二次开发 | main.uts 使用命名导入;uni.scss 可直接 @import '@/uni_modules/uview-pro-x/theme.scss' |
| 普通授权版 | 加密分发,不可修改内部实现 | 入口不转发 default,必须命名导入;插件包内无法 @import 主题文件,需把 $u-* 变量块复制到 uni.scss |
配置时如果分不清自己用的是哪个版本,或按文档操作后主题、国际化没有生效,不用自己反复试错:扫文末的二维码,把项目结构和报错发给我,我按你的项目帮你改到能正常运行。
AI 辅助开发
uView Pro X 提供配套的 Agent Skills 技能包,安装后 AI 编程助手(Qoder、Claude Code、Cursor 等支持 skills 的客户端)即可掌握本库的页面编写规范、UTS / UVUE 约束、多语言与多主题接入配方、多端兼容避错清单。
pnpx skills add uview-pro/skills
运行以上命令选择 uview-pro-x-uts skill 来安装(这是 UTS 版的技能包;TypeScript 项目选 uview-pro-x),如果安装失败,可以去开源仓库中下载,地址为 https://github.com/uview-pro/skills。
安装后在 AI 助手中直接描述需求(例如「用 uview-pro-x 写一个带主题切换的登录页」),助手会按技能内的规范生成可编译的页面代码,并校验 ux-* 组件的属性用法。
交流反馈
![]() |
![]() |
购买源码版的开发者请注意,添加时需备注「购买人账号名称」,我会核对购买凭证后拉入源码交流群。
![]() |
资源链接
| 资源 | 说明 |
|---|---|
| uView Pro X · 官方文档 | 本库的组件 API、主题、国际化等完整文档 |
| uView Pro X · 插件市场 | 本库的下载、在线试用与版本说明 |
| uView Pro X · TS 版插件市场 | 用 TypeScript 的项目请装这个,它与本插件是独立发布的两个包 |
| uView Pro · 官方文档 | uView Pro(Vue3 + TS 版本)完整文档,API 与本库基本一致 |
| uView Pro · 插件市场 | uView Pro 的下载与版本说明 |
| uni-app x · 官方文档 | 平台能力、蒸汽模式与 UTS 语言参考 |

收藏人数:
https://github.com/anyup/hello-uview-pro-x-uts
https://uts.uviewpro.cn
购买源码授权版(
试用
使用 HBuilder 导入示例项目
赞赏(0)







下载 7204
赞赏 89
下载 12775286
赞赏 1960
赞赏
京公网安备:11010802035340号