更新日志
1.0.31(2026-11-17)
🐛 Bug Fixes | Bug 修复
- ux-navbar: 修正导航栏高度单位的描述错误问题
✨ Features | 新功能
- ux-button: 新增fontSize、bold、color、height四个可配置属性,支持自定义按钮文字样式和尺寸
- button: 新增按钮字号、文字色和自定义高度演示示例
1.0.30(2026-11-16)
🐛 Bug Fixes | Bug 修复
- ux-car-keyboard: 修复数字键盘按压反馈失效及样式继承问题
1.0.29(2026-11-15)
🐛 Bug Fixes | Bug 修复
- layout-line: 修复多个间距组件 ux-line 示例展示问题
💄 Styles | 风格
- 修改默认导航栏文字颜色为黑色,适配浅色主题显示
1.0.28(2026-11-13)
♻️ Code Refactoring | 代码重构
- config: 新增 BASE_THEME_NAME 常量统一管理主题名称,明确内置基线主题变量
- useTheme: 重构主题合并与初始化逻辑,优化主题配置处理,新增归一化主题配置函数,确保用户自定义主题能正确继承基线配置并正常生效
- useTheme: 重构主题演示页面,新增完整设置与主题管理功能,包括:设置面板、暗黑模式三态、主题列表、调色板、状态持久化、CSS变量、恢复默认
- scripts: 新增对 App 端 uvue 不支持组合选择器的校验规则
1.0.27(2026-11-13)
🐛 Bug Fixes | Bug 修复
- search-page: 修复搜索页未注入时暗黑模式样式不生效的问题
1.0.26(2026-11-12)
✨ Features | 新功能
- ux-link: 新增 text 属性作为插槽 fallback 内容
- platform: 新增支付宝小程序平台支持,和支付宝小程序体验码,可扫码体验,但仍有一些问题
🐛 Bug Fixes | Bug 修复
- ux-text: 修复 link 模式下微信小程序文字重复渲染问题
1.0.25(2026-11-12)
♻️ Code Refactoring | 代码重构
- demo-result: 重构组件演示样式适配多端主题联动
🐛 Bug Fixes | Bug 修复
- ux-form-item: 修复 App 端错误提示文字被截断的问题
- ux-tag: 修复 App 端 Tag 文字顶部被裁剪问题
1.0.24(2026-11-11)
✨ Features | 新功能
- request: 新增 Request 请求库核心模块,支持请求、响应拦截器配置,支持多实例多域名请求配置,支持取消请求
- request: 新增 Request 上传和下载的基础传输实现,封装平台原生 API,提供进度回调、中止能力,适配加密环境类型擦除问题,剥离默认配置与拦截器逻辑
- useRequest: 新增 useRequest 请求钩子,提供带竞态处理和取消能力的请求封装,支持请求的 loading 状态、数据存储、错误处理,支持自动取消上一次未完成请求以避免竞态,在组件卸载时自动取消请求。
- demo: 新增 Request 请求模块的核心功能演示,以及 useRequest 组合式请求工具的使用示例,包含单例实例、拦截器配置、多域名派生实例及拦截器安装逻辑,展示基础三态、连续调用、取消请求等场景
- demo: 新增 version 统一管理版本号和新增能力登记,版本号自动获取
1.0.23(2026-11-11)
🐛 Bug Fixes | Bug 修复
- ux-checkbox: 修复 App 端 checkbox 禁用态跨端显示不一致问题
- ux-radio: 修复App 端禁用态文字颜色错误的问题,解决跨端样式不一致的bug
💄 Styles | 风格
- demo: 简化 steps 步骤计数样式,移除冗余属性,修复 App 演示兼容
1.0.22(2026-11-10)
✨ Features | 新功能
- ux-sticky: 新增吸顶组件,适配多端导航栏与外部滚动通道,统一多端导航栏高度计算,优化吸顶定位逻辑避免内容上跳
- sticky: 新增吸顶组件的全场景演示页面,包含基础用法、原生导航栏和无导航栏三种场景
♻️ Code Refactoring | 代码重构
- demo: 优化容器返回顶部逻辑,统一处理页面和容器滚动
- demo: 完善吸顶组件的使用说明文案,补充 bgColor 属性的注释
1.0.21(2026-11-10)
🐛 Bug Fixes | Bug 修复
- useChildren: 修复使用 Pinia 时类型与 useChildren 不兼容导致的运行时异常警告,优化依赖更新问题
✨ Features | 新功能
- 新增 pinia 状态管理演示示例,包括定义 store、挂载和页面使用的完整示例
- steps: 新增动态步骤条示例,支持添加和删除步骤,自动同步步骤数、序号与连接线
1.0.20(2026-11-10)
🐛 Bug Fixes | Bug 修复
- i18n: 修正多语言文件中部分组件的命名问题,包括简体中文、英文、法语
- types: 解决加密版插件编译时类型导入丢失导致的运行期导出错误问题
- empty: 修复空状态示例中的购物车图标模式声明错误问题
1.0.19(2026-11-09)
🐛 Bug Fixes | Bug 修复
- type: 修复 DarkMode 运行时导入问题,解决加密版插件运行时导入类型报错的问题
- module: 修复加密版插件导入路径错误导致的模块找不到问题
✨ Features | 新功能
- ux-button: 新增 ux-button 组件的 easycom 配置文件
1.0.18(2026-11-09)
✨ Features | 新功能
- 新增 usePageScroll 钩子,提供统一的页面滚动距离管理通道,支持页面本身滚动和 scroll-view 容器内滚动两种场景
- 新增获取导航栏高度的工具方法 getNavbarHeight,用于获取不同平台下的导航栏缺省高度
♻️ Code Refactoring | 代码重构
- ux-navbar: 统一处理 H5、App、小程序各端的缺省高度值,简化组件内的重复代码
- backTop: 统一使用 usePageScroll 管理滚动状态,简化多端适配逻辑
🐛 Bug Fixes | Bug 修复
- ux-back-top: 修复滚动距离计算逻辑的描述注释,明确外部 scroll-top 优先的规则,解决小程序端滚动跟踪的理解歧义
1.0.17(2026-11-06)
🐛 Bug Fixes | Bug 修复
- 修复非 APP 环境下图标提示文字显示异常的问题
♻️ Code Refactoring | 代码重构
- 删除无用验证页面及相关配置
- 删除已废弃的遮罩组件文件
1.0.16(2026-11-05)
♻️ Code Refactoring | 代码重构
- ux-collapse-item: 优化折叠项 hover 样式的类名生成方式,使用 bem 工具类
- ux-column-notice: 提取通告栏文字类型类名的计算属性,优化代码结构
- ux-grid-item: 优化部分硬编码样式,统一样式命名生成工具
- 优化脚本顺序校验的行内注释处理逻辑
🐛 Bug Fixes | Bug 修复
- ux-image: 修复微信小程序下图片长按菜单失效问题
1.0.15(2026-11-04)
✨ Features | 新功能
- useLocale: 重构 useLocale 国际化功能支持,优化页面结构,删除冗余按钮样式
- useTheme: 新增 useTheme 主题管理 hook,包含快速查看主题状态、主题切换、暗黑模式设置、CSS 变量查看、恢复默认等
1.0.14(2026-11-04)
✨ Features | 新功能
- 新增 useRect 钩子函数,用于获取元素布局信息,演示元素尺寸测量、重新测量功能
1.0.13(2026-11-03)
✨ Features | 新功能
- 新增 useCountDown 倒计时钩子工具,包含基础倒计时、控制操作、结束回调等,并新增演示示例。
1.0.11(2026-11-02)
✨ Features | 新功能
- 新增 useDebounce 示例代码片段并重构演示页面,支持默认延迟、自定义延迟、临时指定延迟多个配置
- 新增 useThrottle Hook 演示代码及页面,包含默认间隔、自定义间隔、临时指定间隔三种使用场景
1.0.10(2026-11-01)
✨ Features | 新功能
- image: 优化ux-image图片演示效果
- swiper: 更新轮播图示例图片资源地址
1.0.9(2026-10-30)
✨ Features | 新功能
- ux-icon: 重构图标库前缀机制,支持自定义图标库与内置库统一逻辑,调整多个组件的图标前缀默认值
- custom-icon: 新增自定义图标功能的演示页面,包括接入说明、三种取字方式、样式能力、与内置图标共存的示例
1.0.8(2026-10-30)
💄 Styles | 风格
- 移除多个文件中重复的主题样式导入
✨ Features | 新功能
- 替换部分本地为线上地址并新增图片图标示例
- 新增格式化、数值、字符串等工具演示页面,format、number、string、toStyle、color、test
- 完善 trim、throttle、debounce、addUnit、deepClone、deepMerge 工具函数的演示页面
1.0.7(2026-10-29)
✨ Features | 新功能
- 新增自定义字体图标库演示示例
- icon: 新增自定义字体图标支持能力,新增 registerIconFont 方法用于注册自定义图标字体库
1.0.6(2026-10-29)
✨ Features | 新功能
- ux-alert-tips: 新增图标大小可配置属性 iconSize
- ux-cell-item: 优化单元格布局与插槽图标适配
🐛 Bug Fixes | Bug 修复
- ux-tag: 修复标签在高行高容器中高度虚高的问题
1.0.5
♻️ Code Refactoring | 代码重构
- components: 重构 ux-keyboard 组件并移除 HarmonyOS 平台按钮边框样式
🐛 Bug Fixes | Bug 修复
- ux-tabbar: 修复路由读取导致的高亮错判问题
1.0.4
♻️ Code Refactoring | 代码重构
- plugin: 修改插件导出方式适配加密编译场景
- 调整uViewProX的导入方式
1.0.3
🐛 Bug Fixes | Bug 修复
- 修复theme.scss在运行时全局变量丢失问题,为CSS变量添加默认回退值,以防止主题颜色丢失
1.0.2
文档
- 文档站新增「AI 技能」指南,中英文同步上线,说明技能安装、使用流程、目录结构与手动校验方式
- 技能包同步开源在 uview-pro/skills,命令行安装失败时可直接下载使用
生态
- 发布配套 Agent Skills 技能包
uview-pro-x:AI 编程助手可据此按本库规范编写页面,写组件前查 API 卡片,写完运行verify-ux-usage.mjs校验ux-*用法
1.0.1
- 优化 README.md,添加组件说明
- 添加官方文档链接
- 添加示例演示入口
1.0.0
uView Pro X 首个正式版本,作为后续迭代的功能基线。
组件概览
首批 76 个 ux-* 组件(含子组件)完成从 uView Pro 到 uni-app x 的迁移,覆盖 7 个分类,共 61 个组件示例页:
- 基础(8 页):
ux-icon、ux-image、ux-button、ux-cell-group/ux-cell-item、ux-badge、ux-tag、ux-text、ux-avatar - 表单(13 页):
ux-form/ux-form-item、ux-input、ux-textarea、ux-select、ux-picker、ux-rate、ux-search、ux-number-box、ux-keyboard/ux-number-keyboard/ux-car-keyboard、ux-checkbox/ux-checkbox-group、ux-radio/ux-radio-group、ux-switch、ux-slider - 数据展示(5 页):
ux-line-progress、ux-circle-progress、ux-count-to、ux-count-down、ux-swiper - 反馈(14 页):
ux-action-sheet、ux-toast、ux-notice-bar(含ux-row-notice、ux-column-notice)、ux-alert-tips、ux-top-tips、ux-collapse/ux-collapse-item、ux-popup、ux-swipe-action、ux-modal、ux-mask、ux-loading、ux-loadmore、ux-empty、ux-no-network - 布局(6 页):
ux-line、ux-card、ux-grid/ux-grid-item、ux-divider、ux-row/ux-col、ux-section - 导航(8 页):
ux-tabbar、ux-back-top、ux-navbar、ux-tabs、ux-subsection、ux-steps/ux-step、ux-link、ux-pagination - 其他(7 页):
ux-gap、ux-safe-bottom、ux-status-bar、ux-transition、ux-skeleton、ux-full-screen、ux-config-provider;另有ux-overlay、ux-sticky、ux-waterfall等基础能力组件
工程能力
- 组件样式基于 UCSS 重写,仅使用 flex 布局,同时适配 App / H5 / 微信小程序。
- 组件专属样式类统一由
useBEM生成(ux-前缀),结合样式隔离,避免与业务类名冲突。 - 主题变量集中在
theme.scss($u-*),提供多主题配置与暗黑模式。 - 内置中文 / 英文语言包,通过
ux-config-provider与useLocale全局切换。 - 提供
$u工具函数与useTheme、useLocale等组合式能力。 - 提供 9 个工具函数示例页(
addUnit、test、toStyle、color、trim、debounce、throttle、deepClone、deepMerge)与 3 个 Hooks 示例页(useDebounce、useThrottle、useLocale)。
文档
- 中英文双语文档站上线,包含组件说明、示例源码与 API 表。
- 组件页内嵌 H5 在线预览,可在文档中直接交互体验。
- 演示工程覆盖每个组件的独立示例页,可直接在真机或浏览器中运行验证。
已知限制
- App 端 UCSS 不支持 CSS 过渡与伪元素,部分视觉效果(如水波纹、细边框)在 App 端会降级为静态样式。
- 当前以 App / H5 / 微信小程序为主要验证目标,其他小程序平台尚未逐一验证。