更新日志

更新日志及升级指导

为减少重复工作，后续API变更等重大的日志（升级时请关注这些重大变化）在这里可以查看，常规更新日志请访问此链接查看 更新日志。

• 4.5.38

  • 修复up-datetime-picker 的 format 现在同时支持本库 timeFormat 的小写写法（yyyy-mm-dd hh:MM）与 dayjs 的大写写法（YYYY-MM-DD HH:mm）。此前 format 被直接交给 dayjs，传本库通用的 yyyy-mm-dd 时 dayjs 只认得其中的 mm(分钟) 与 dd(星期)，输入框显示成 yyyy-00-Th（issue #537）
  • 修复up-datetime-picker（Vue 端）绑定值解析放宽：Date 对象与 12 位（2001 年前）毫秒时间戳不再被判为非法值替换成 minDate（默认当前年份-10）。日期模式下 v-model 一律归一化为毫秒时间戳，与滚动选择后的既有行为一致；无法识别的值仍回退 minDate。uni-app x 端的 correctValue 本就自行解析，不受影响
  • 变更up-datetime-picker 文档与类型补齐 hasInput、placeholder、format；format 默认值实为空（按 mode 取默认格式），此前文档误写为 'YYYY-MM-DD HH:mm'
• 4.5.36

  • 修复 修复组件卸载后仍查询节点，导致切页时 APP 与鸿蒙端大量抛出 Cannot read properties of undefined (reading '$')（功能不受影响，H5 端不出现）。在 useUltraUI 的 $uGetRect 与 upCreateIntersectionObserver 集中拦截，卸载后分别返回零尺寸与空观察器，覆盖 up-tabs、up-sticky、up-subsection、up-waterfall、up-index-list 等全部依赖节点测量的 Vue 组件；调用形态不变，无需迁移。uni-app x 原生端无此 nodeId 映射，.uvue 变体不受影响
• 4.5.35

  • 变更up-select 的 overlayOpacity 默认值由 0.01 调整为 0.15：此前近乎不可见，用户无法察觉下拉已接管整页点击；新默认值明显浅于 up-popup 的 0.5，不会压暗页面。需要完全透明请显式传 :overlay-opacity="0"
• 4.5.34

  • 修复 修复 up-tabbar/up-tabbar-item 中间凸起按钮圆弧边框在不同文字布局、midButtonOffsetY 偏移及 border 配置下的裁剪越界；Vue 与 UVue 改按 tabbar 和圆形按钮的实际位置计算裁剪高度，避免边框超出顶部或被错误截断
• 4.5.33

  • 新增up-navbar 新增 mode 属性，ios 值提供 iOS 大标题模式：初始背景透明、标题 34px 左对齐显示，下滑压缩后过渡为居中标题并由下方 12px 上浮就位，同时背景淡入
  • 新增up-navbar 新增 scrollTop 属性接收页面滚动距离，需由页面 onPageScroll 传入；不传时停留在大标题展开态，不报错
  • 新增--up-navbar-glass-bg-color 与 --up-navbar-glass-blur 主题变量，可调整磨砂底色与模糊半径
  • 注意 平台差异：backdrop-filter 在 WebView 类端（Web、H5、微信小程序 iOS 等）呈现真实毛玻璃；App 原生端（UVue）的支持情况取决于渲染器，若不生效则磨砂表现为 0.82 不透明底色，该不透明度本身即为文字可读性下限。大标题压缩与居中标题上浮不依赖 backdrop-filter，两端均可工作
  • 注意ios 模式下 fixed 与 placeholder 被忽略：固定层恒定固定、in-flow 层恒定渲染，因为该层承载的是大标题这一实际内容而非可选占位。default 模式结构与语义完全不变
• 4.5.31

  • 新增up-cropper 的 chooseImage(index, params, data) 支持 params.imageSrc：业务侧自行拍照/选图后，可把已有路径直接交给裁剪器，不再强制打开系统选图；不传或传空值仍保持原有选图行为
  • 优化up-cropper（Vue 端）抽取共享 loadImage(path)，系统选图与外部路径复用同一套图片信息读取、裁剪框初始化与绘制流程；uni-app x 端「重选」固定回到系统选图，不会重复加载传入的 imageSrc
• 4.5.30

  • 修复up-popup 由外部直接把 show 置为 false 关闭时不再静默，同样会触发 close；此前只有点击遮罩、点击关闭图标才会触发，导致以 v-model:show 控制弹窗的业务收不到关闭通知
  • 新增up-popup 新增 closed 事件，在离场动画结束、弹窗真正消失后触发；close 表示「关闭动作发生」（动画开始前），closed 表示「已经关闭完毕」，需要等弹窗消失后再跳转或重置数据的场景请监听 closed
  • 新增closed 事件透传至 up-picker、up-action-sheet、up-keyboard、up-calendar、up-color-picker、up-goods-sku、up-datetime-picker、up-picker-data，Vue 与 uni-app x 双端一致；up-calendar 仅在主体弹窗关闭时触发，关闭内部时间选择器不会误报
  • 优化 补充 onClosed 类型声明（popup / picker / datetimePicker / actionSheet / keyboard / calendar），并新增 verify:popup-close-events 回归校验
• 4.5.29

  • 修复 修复 HarmonyOS uni-app x Canvas 上下文条件编译、首帧绘制时序、DPR 坐标换算和 transparent 颜色解析，恢复 up-qrcode 二维码完整清晰绘制
  • 修复up-poster 改为预加载图片后按配置顺序统一绘制，恢复渐变背景、卡片、文字、商品图与二维码，并补充中文换行兜底和画布初始化错误处理
  • 修复 修复 up-calendar 在 H5 端因运行时类型别名擦除触发的 monthsItem is not defined，以及 up-novel-reader 在 HarmonyOS 端使用 Regex 导致的编译失败
  • 优化up-barcode 与 up-poster 在画布上下文为空时立即报错，并补充 Harmony Canvas、Poster 与 Calendar 回归校验
• 4.5.28

  • 新增up-tabs 新增 capsule、card、pill-arrow、tag 四种形态模式，并在 click 事件中追加原始点击事件参数
  • 新增 新增 Vue 与 UniApp X 双端 up-tabs-pro，支持受控 current、作用域内容插槽以及事件透传
  • 修复 修复 tabs 组件在 UniApp X Android 端的 Number 转换、作用域插槽类型推断和样式对象类型兼容问题
• 4.5.X

  2026根据 uview-ultra 近期提交与插件 changelog 整理的重大更新（常规细节见源码 changelog）：

  • 修复 4.5.32：同步 uview-plus issue #864，修复 Vue 版 up-sticky、up-lazy-load、up-cate-tab 在小程序端输出 Avoid app logic that relies on enumerating keys on a component instance 告警的问题；三者改用新增的公共方法 upCreateIntersectionObserver 创建交叉观察器，优先走组件实例上的同名方法（内部已完成实例解包），APP 端仍回退全局 API，组件对外行为与配置不变。uni-app x（UVue）版本次未改动
  • 修复 4.5.27：luch-request UTS 版重写，修复其在 UniApp X（Android）端无法编译的问题；公开接口与 JS 版一致（config/response 为 UTSJSONObject，取值用 ['key']），uts 入口导出 Request 与全局 http；详见 Http 请求章节「UniApp X（UTS）使用注意」
  • 变更 4.5.27：up-novel-reader（UVue）顶/底工具栏改为悬浮（position:absolute），正文占满全高，工具栏显隐不再挤压正文布局
  • 修复 4.5.26：up-datetime-picker（Vue/UVue）动态修改 minMinute/minHour 等边界值时保留当前已选值，仅按新边界重新校正，不再回退到 modelValue；新增 change 去重，边界变化重建列不再重复触发 change，已选值超界时自动夹取并补发一次 change；UVue 端补全此前未接通的 modelValue/mode/边界值响应式
  • 修复 4.5.26：up-novel-reader（UVue）修复无法通过 uni-app x（Android）编译的一系列问题（不支持的 CSS 值、UTSJSONObject Any? 类型、setup 函数前向引用、props 与局部变量/defineExpose 命名冲突、nextTick(async)、数组 API 等），并修复 App 端因 flex 默认竖向导致工具栏/设置/目录布局错乱（补 flex-direction:row）
  • 修复 4.5.25：修复文档构建错误，保护 barcode 与 goodsSku 文档中的 Markdown 表格类型参数，修复 coupon 文档错误链接，确保文档站构建与死链校验通过
  • 新增 4.5.24：新增 up-novel-reader 小说阅读器组件，支持 scroll/page 双模式、目录、设置、主题、书签、进度恢复、阅读时长和安全区；Vue 与 UVue 保持同一公开 API
  • 修复 4.5.22：修复 overlay 动态挂载二维码时的 Canvas 初始化竞态；Vue 与 UVue 版 up-qrcode 统一迁移到 up-canvas，由画布宿主集中管理节点、context、DPR、图片加载与导出，并共享并发初始化结果，避免重复重设尺寸或清空画布导致二维码只绘制局部；Vue H5 继续使用 uni-h5 内置 HiDPI，Vue 小程序与 UVue Canvas 在宿主层重设 backing store 并只应用一次 pixelRatio 变换，同时新增 overlay 二维码示例与回归校验
  • 修复 4.5.21：同步 uview-plus issue #1047，修复 Vue 与 UVue 版 up-waterfall 在多批数据快速到达、clear() 或中间插入时的并发分配错乱；改用共享串行队列和任务代数取消，并在非纯追加变化时全量重排，避免数据错列、重复或丢失
  • 修复 4.5.19：系统清理 H5 严格类型检查告警：移除 search、tabbar、tabbar-item、calendar 中会破坏 props 推断的 null 构造器，并为 steps、radio、picker、text、number-box、popup、tag、rate、swipe-action、checkbox、subsection、waterfall、skeleton、swiper、tabs 等组件补齐空值兜底；同步收窄 form、async-validator、canvas、图片和滚动事件类型；恢复 up-row 子组件注册方法并处理空节点尺寸，修复运行时 getChildren not found 和读取空节点 width 的异常
  • 修复 待发布：同步 uview-plus 3.8.97 的 up-dragsort 小程序兼容修复，Vue 与 UVue 版以稳定条目 ID 维护渲染节点和视觉顺序，修复微信小程序拖动松手后的节点覆盖；自定义 handler 插槽兼容小程序动态插槽名，示例改为显式作用域写法
  • 新增 4.5.17：up-swipe-action-item 支持 scrolling / v-model:scrolling 和 @scrolling，横向滑动时可配合 page-meta 或 scroll-view 暂停页面/容器滚动，手势结束后自动恢复
  • 修复 待发布：同步 uview-plus issue #905，修复 Vue 与 UVue 版 up-action-sheet 自定义插槽点击不遵守 closeOnClickAction 的问题；Vue 版同时兼容 up-cell 默认阻止事件冒泡的场景
  • 变更升级注意： 4.5.16 起 up-text 同步 flex1 默认行为，默认不再写入 flex: 1 和 width: 100%；如果业务依赖旧版默认撑满父级剩余空间，请显式设置 flex1，或为外层/文本指定宽度。
  • 变更 完善 Swiper vertical 纵向滑动属性说明与示例，Vue 与 uni-app x 均可透传至原生 swiper
  • 修复 4.5.11：同步公共样式 `.w-full` 的 `box-sizing: border-box`，与 uview-plus 对齐，避免宽度 100% 工具类在 padding/border 场景下撑破布局
  • 变更重大变更： i18n 默认仅内置 zh-Hans，其他语言需 registerLocale 按需注册；JS/UTS 双端支持，可用 allLocales 一键恢复旧行为（#908）
  • 新增 cropper 支持并文档化 inner：开启后拖动/缩放保持裁剪框在图片内并禁用旋转（同步 uview-plus #921）；chooseImage 传参与 prop 对齐；inner + canChangeSize 时调整裁剪框也限制在图片内
  • 修复 App 端内置图标字体改为包内本地加载（同步 uview-plus #1044）：up-icon 使用包内 upicon.ttf，避免 alicdn 弱网阻塞；无需手动拷贝 static
  • 变更 4.5.5：143 个 Vue 组件迁移为 true script setup，新增 useUltraUI 组合式能力；移除 Vue 侧全局 mixin / libs/mixin，组件改为显式 commonProps
  • 修复 4.5.5：up-swipe-action-item 关闭态右侧删除按钮 H5 亚像素露边（同步 #843，vue/uvue）
  • 变更 适配 HBuilderX 5.0+ 样式隔离策略 2.0 向下兼容：开启 styleIsolationVersion=2；组件/页面 uvue 统一 styleIsolation=app-and-page，允许全局与页面 class 影响组件；修复 defineOptions 尾逗号导致 UTS 编译失败
  • 变更 4.5.4：多组件适配蒸汽模式与 BEM 样式（button/card/choose/select/table2/tree/coupon/dragsort/pagination/scroll-list/swiper-indicator 等），减少深层选择器；若存在自定义覆盖内部 class，请按 BEM 命名同步调整
  • 修复 up-dragsort 向上拖拽只能移动一层；清理 UTS 遗留 mixin，组件改为显式公共 props；action-sheet 保留 button/openType 事件转发
  • 新增 calendar 透传 overlay、duration、overlayStyle、overlayOpacity、zIndex、safeAreaInsetBottom、safeAreaInsetTop、bgColor、closeable、closeIconPos、zoom 等弹层属性；pageInline 可关闭底部安全区占位
  • 优化 4.5.0：uvue 大规模 Composition API 化（script setup + UTS），补齐父子通信与实例暴露；修复 Android UTS 严格比较/空数组/字符串长度等编译兼容问题
  • 修复 navbar 全局左侧点击拦截上下文；action-sheet description 上下间距；日历打开卡顿与底部确定按钮不显示；number-box integer=false 小数键盘
  • 修复 真机 UTS Number 构造编译错误；lazy-load / swipe-action-item Android UTS 编译阻塞；textarea count 空值字数统计报错
  • 新增 UTS 版 luch-request（UniApp X 兼容）；calendar 顶部时分秒选择、今天按钮；datetime-picker 扩展 datehour/timesecond/datetimesecond；popup/picker/datetime-picker 支持 pageInline
  • 修复 table2 微信小程序重复 slot name="cell"（#839）；picker 异步 columns 时 defaultIndex 不更新（#841）；日历隐藏挂载首日偏移；radio label 插槽与 subsection disabled 默认值
  • 新增 4.4.0 起大量 uni-app x / Android 组件与示例：popover、pagination、dragsort、tree、choose、virtual-list、markdown、barcode、poster、cropper、canvas 等，并修复多处 Android 崩溃与类型强转问题
  • 变更 3.x 升级到 4.x 前缀迁移：class/sass/工具类/easycom/图标由 u- 系改为 up- 系；u-- 开头组件已删除，请直接使用 up- 开头组件
• 3.3.X

  2024

  • 变更form-item的rule属性变更为rules
  • 优化公共mixin改造为按需导入语法
  • 优化slider组件重构优化
  • 优化index-list组件重构优化
  • 优化input组件maxlength默认中从-1改为140
  • 优化小程序下steps和grid都统一采用css的grid布局
• 3.2.X

  2024

  • 新增增加瀑布流与图片懒加载组件
  • 修复去除安卓steps提示不支持
  • 新增typescript支持
  • 优化组件内uni.$u用法改为import引入
• 3.1.X

  2022-2024

  • 优化日常修复
• 3.0.0

  2022-07-09

  • 修改 修改原版uview2的代码使其支持vue3模式下运行