更新记录

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 鸿蒙 微信小程序
√ √ √ √ √ √

其他

多语言 暗黑模式 宽屏模式 蒸汽模式
√ √ √ √
uView Pro X

uView Pro X · UTS 版

基于 UTS + UVUE 的 uni-app x UI 组件库

官方文档 · GitHub · Gitee · 插件市场

先确认版本:本插件是 UTS 版。

  • 项目是 uni-app x + UTS,装这个
  • 项目是 uni-app x + TypeScript,请买 TS 版,不要装这个
  • 项目是 uni-app(非 x),请用 uView Pro

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 上,不引入额外运行时库。
  • 内置请求层:http axios 实例模型(双向拦截器 / 派生实例 / 上传下载进度)+ 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 语言参考

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

无

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

暂无用户评论。