# 更新日志
更新日志及升级指导
为减少重复工作,后续API变更等重大的日志(升级时请关注这些重大变化)在这里可以查看,常规更新日志请访问此链接查看 更新日志。
-
3.8.X
2026根据近期提交与插件 changelog 整理的重大更新(常规细节请看源码 changelog):- 变更 3.8.139:uview-plus 转为付费授权(插件市场普通授权 99 元、源码授权 199 元),并彻底关闭开发文档站广告——不再有微信广告弹窗,也不再加载 Google AdSense,文档浏览不再被打断
- 新增
3.8.138:新增
u-audio音频播放器组件,基于uni.createInnerAudioContext实现,支持播放/暂停、进度条拖动、倍速切换、多源自动切换与 play/error 事件,App / H5 / 各小程序全平台可用;u-parse的音频节点改用u-audio渲染(Vue3 已废除<audio>组件) - 修复
3.8.137:
u-tabbar等八个父子联动组件(tabbar / steps / checkbox-group / radio-group / grid / collapse / dropdown / swipe-action)修复抖音小程序等平台 watch 回调早于自身 created 执行时访问未初始化children的崩溃(#1065),u-tabbar-item找不到父组件时改为最多 10 次、每次 100ms 的延迟重试并补注册到parent.children,消除「必须搭配up-tabbar组件使用」误报并恢复抖音端吸顶联动;u-sticky吸顶 top 值显式钉死 px,修复配置全局unit: 'rpx'的项目在非 375px 宽度设备上吸顶元素与导航栏之间出现间隙(#1063);u-select对齐复位并入打开的同一次渲染提交、溢出判断改为与对齐状态无关,修复奇偶次打开面板位置交替错误(#1061);u-input修复 firstChange 标记导致首次程序化赋值(弹窗选择回填)不触发表单验证的问题及doBlur小程序端报错(#726);u-form未配置 trigger 的校验规则不再被静默跳过、errorType="toast"在自动触发校验时也能弹出提示(#726 / #614);u-form-item的borderBottom未显式设置时跟随u-form同名属性(#614) - 修复
3.8.136:
u-goods-sku的close()原this.false = true为无效赋值(误建 false 属性、弹窗从未真正关闭),改为this.show = false真正关闭弹窗,并将 popup 的 close/closed 事件经模板透传给父组件,避免ref.close()触发 popup 的 show watcher 补发导致父组件重复收到 close 事件;u-iconApp 本地字体构建插件改为按包内相对路径后缀匹配,覆盖 npm(node_modules)/ pnpm 安装方式,修复 App 远程 @font-face 不被剥离的问题(#1069),App-Vue 改用原始_www/static/app-plus/uview-plus/upicon.ttf路径交由 view 层转换一次,修复云打包正式 APK 图标不显示的问题(#1069) - 新增
3.8.135:新增
u-lottieLottie 动画组件,覆盖 H5 / App-Vue、微信小程序与鸿蒙多端渲染。H5 / App-Vue 基于 lottie-web SVG 渲染器,H5 端引擎按需加载、加载失败自动清理;微信小程序基于 lottie-miniprogram 画布渲染;鸿蒙通过 harmony-canvas-adapter 画布适配。支持filePath(动画 JSON 地址,http(s),H5 / App-Vue 额外支持本地静态路径)与animationData(直接传 Lottie JSON 对象,优先级更高)两种数据来源,可配置contentModel填充模式(ScaleToFill / AspectFill / Center)、loop循环播放与autoplay自动播放;实例方法提供 reload / playAnimation / pauseAnimation / resumeAnimation / cancelAnimation,statechange事件统一回报 ready / play / pause / resume / stop / complete / error 状态(微信小程序从 event.detail 读取)。新增u-upload新增mediaType属性(默认['image', 'video']),accept 为 media 时透传给 chooseMedia 控制可选文件类型(image / video / mix)。修复u-upload的 chooseMedia 不再做平台编译判断,改为运行时检测接口是否存在,不存在时自动回退到 chooseImage,修复部分平台 accept="media" 直接报错的问题 - 修复
3.8.134:修复
u-cropper的三个问题。一、iOS 上底部操作栏与页面浮动按钮/标签重叠:画布高度减掉了底部安全区,而操作栏仍是 50px 贴在屏幕最底,两者之间露出一条约安全区高度的页面背景,页面上浮动的元素会从这条缝里透出来(安卓safeAreaInsets.bottom为 0,所以只有苹果机能看到);现在操作栏高度改为 50px + 安全区并用padding-bottom让出,与画布严丝合缝,按钮也完整位于 home 指示条上方。二、quality参数完全失效:5 处导出都把fileType硬编码为 png,PNG 是无损格式、没有质量档位;新增fileType属性(默认png,可选png/jpg),只有 jpg 才会按quality压缩,chooseImage的 params 也可覆盖。三、质量归一化使用parseInt,parseInt(0.5)为 0 后被|| 0.9改回 0.9,所有小数质量都被悄悄抬高;改用parseFloat并夹取到 0-1。升级注意:fileType默认仍为 png,输出格式与升级前一致,不需要改代码;需要压缩体积时显式传fileType="jpg"并配合quality - 修复
3.8.133:修复
u-number-keyboard退格键在微信小程序下短按不删除内容、只剩长按连删有效的问题。根因是@touchstart上残留的.stop会编译成catchtouchstart,把同一节点上的tap一起吞掉;同时补充touchcancel清理定时器,避免触摸被系统手势打断后长按连删空转。新增u-toast新增overlay属性(默认true),设置:overlay="false"后遮罩由铺满全屏收缩为跟随内容大小并居中的浮动层,提示期间点击与滚动可穿透页面;show()未显式传值时回落到该 prop,show({ overlay })仍然优先 - 新增
3.8.132:
u-goods-sku新增defaultSku属性,支持默认选中的 SKU,并支持响应式更新与重置恢复(#1070);新增safeAreaInsetBottom属性(默认true),可关闭底部安全距离,并透传给u-popup。修复calc.div改用digit.divide实现,避免依赖未定义的xyutil,修复运行环境为空时的崩溃 - 修复
3.8.130:修复
u-text在微信小程序下的v-bind="" is not supported.编译报错,并恢复根节点属性继承,避免普通文本的id、data-*等属性丢失。升级注意:撤回 3.8.128 向内部分享按钮自动透传任意data-*属性的实现;需要自定义分享数据时,请使用原生button显式绑定data-*并设置open-type="share" - 变更
3.8.129:
u-navbar在微信小程序端默认避让右上角原生胶囊按钮,避免右侧插槽、图标和文字被遮挡;新增avoidCapsule属性(默认true),如需保留原有布局可显式设置为false(#1058) - 新增
3.8.128:新增
u-video(up-video)视频播放器组件,统一封装video播放能力,支持弹幕(danmaku)、自定义进度条与控制层以及常见播放属性透传,覆盖 H5 / 小程序 / App;随包新增面向 AI 编码助手的skills/uview-plus技能包,含 setup、components、api、icons、pitfalls 参考文档 - 修复
3.8.128:集中修复一批跨组件问题。
u-list/u-list-item新增anchor锚点滚动定位并修复scrollIntoViewById调用后不滚动(#671、#721);u-calendar修复关闭重开后副标题与月份不一致,并优化大monthNum下的渲染性能;u-select完善面板指示器、自适应与多选回显;u-icon字体加载失败后改由定时器重试,修复u-search输入后无法再次聚焦(#844);u-dropdown修复 nvue 下菜单宽度被压缩(#814);u-collapse修复展开后内容变高被裁切;u-cell必填星号改用真实节点渲染,修复小程序与 nvue 下不显示;u-slider修复 border-box 下的滑块错位;u-textarea回车默认换行并支持confirmHold;u-text透传data-*属性;u-upload透传 H5 端视频真实 File 对象;u-search修复小程序端占位符颜色首屏不生效;u-cate-tab优化大量图片首屏渲染与滚动联动;以及u-picker、u-datetime-picker、u-grid、u-parse、u-number-keyboard、u-car-keyboard与类型声明的多项修复 - 修复
3.8.127:修复抖音小程序中
u-tabbar-item/u-steps-item因父子组件生命周期顺序导致的崩溃。抖音小程序下子组件created可能早于父组件执行,此时父组件children数组尚未初始化,子组件init()访问parent.children.indexOf会抛TypeError并误报「必须搭配父组件使用」。现为u-tabbar-item/u-steps-item/u-list-item补齐parent/children守卫并在mounted补偿重试,共享 mixingetParentData()也改为访问children前先判断父组件存在 - 新增
3.8.126:新增
u-flex(up-flex)通用弹性布局容器组件,跨端同名同默认,作为页面view之上的一层弹性布局落点,免去每处手写display:flex与各类对齐样式。支持direction主轴方向、justify主轴对齐(兼容start/end简写)、align交叉轴对齐、wrap换行与gap间距(任意单位),并暴露click事件 - 修复
3.8.125:修复
u-signature签名组件在 App 端无法绘制、笔迹画出后立即消失的问题。根因是画布上下文异步就绪未做握手、触摸坐标未换算到画布坐标系、以及每次draw()都会刷新绘图命令队列清空已画笔迹。现改为touchMove增量线段绘制并用draw(true)保留已绘制内容,坐标统一换算到画布坐标系,并新增画布ready/initCanvas握手避免首笔丢失。覆盖 APP-PLUS / APP-HARMONY / APP-NVUE,微信小程序与 H5 不受影响 - 新增
3.8.124:App 端图标字体默认改用随包分发的本地字体(
_www/static/app-plus/uview-plus/upicon.ttf),弱网或离线时不再丢图标;新增通用 Vite 插件入口UpVite(libs/vite/index.js),不使用 Root 组件的项目单独引入即可复制字体,后续组件库新增构建期能力不需要再改业务项目的vite.config - 变更 升级注意: 3.8.124 起 App 端默认优先加载本地字体。未引入
UpVite的项目本地字体文件不存在,会自动回退config.iconUrl,行为与升级前一致,不会丢图标;不希望使用本地字体可传UpVite({ appStaticIconFont: false })。H5 与小程序不受影响 - 新增
3.8.92:up-swipe-action-item 支持
scrolling/v-model:scrolling和@scrolling,横向滑动时可配合page-meta或scroll-view暂停页面/容器滚动,手势结束后自动恢复 - 变更 升级注意: 3.8.91 起
u-text默认flex1由true调整为false,文本组件不再默认占满父级剩余空间;如果业务依赖旧版横向撑满、占位或对齐效果,请显式设置flex1,或为外层/文本指定宽度。 - 变更 重大变更: i18n 默认仅内置 zh-Hans,其他语言需 registerLocale 按需注册;可用 allLocales 一键恢复旧行为(#908)
- 修复 完善 up-dragsort 禁用拖拽逻辑:全局 draggable 为 false 时不再进入 dragIndex,避免 Android 禁用场景小范围漂浮与阴影(#854)
- 修复 H5 下 index.js 组件自动注册:移除对 import.meta.glob 的运行时函数判断,确保 Vite 编译期宏正常展开
- 新增 统一 up-canvas 画布承载,迁移二维码/条形码/裁剪/海报/上传等组件的直接 canvas 使用,并补充跨端绘制、导出与像素读写能力
- 变更 up-button 非 nvue 普通按钮默认宽度由 100% 调整为 auto,避免横向布局挤压相邻内容;size="large" 仍全宽,需要全宽请显式设置 custom-style 或外层宽度
- 修复 waterfall 在列高未稳定时可能只渲染左侧一列;markdown 依赖改为 mjs 模块导入提升打包兼容性
- 新增 calendar 透传 overlay、duration、overlayStyle、overlayOpacity、zIndex、safeAreaInsetBottom、safeAreaInsetTop、bgColor 等弹层属性;pageInline 可通过 safeAreaInsetBottom=false 关闭底部安全区
- 修复 pagination 总数与每页条数选择展示;line-progress 默认参数错配导致进度宽度异常
- 新增 tooltip 支持 singleton 单例打开(同页仅一个显示),close 时同步 update:show;并补齐 manual 模式 show / open / close 能力
- 修复 navbar 全局左侧点击拦截上下文;action-sheet description 上下间距;pageInline 在 nvue 下不显示;number-box integer=false 小数键盘;textarea 字数统计空值报错
- 优化 navbar 安全区背景渲染;color-picker box-sizing 防止 padding 撑开;补齐支付宝等平台缺失 onWindowResize 的 uni API shim
- 优化 组件 props 默认配置改为懒注册/按需加载,降低按需引入体积,并保持 setConfig 与 uni.$u.props 兼容
- 修复 table2 超出隐藏与属性行为补齐,修复微信小程序重复 slot name="cell" 报错(#839)
- 新增 calendar 顶部时分秒选择(enableTime / timePrecision / defaultTime)、区间返回格式 rangeResultMode、今天按钮与 todayColor,完善区间模式“今天”表现
- 修复 picker 异步 columns 时 defaultIndex 不更新(#841);pageInline 日历隐藏挂载首日偏移;datetime-picker 遮罩关闭与 pageInline 滚动默认值;number-box 最小值限制导致无法输入(#914)
- 新增 单行日历 up-calendar-strip、tabs shapeMode 多形态、up-guide 首屏引导、tabbar 风格与动态图标、signature clear 方法
- 优化 主题变量与暗色适配(input/textarea/form/action-sheet 等)、nativeThemeSync 控制原生 UI 主题同步、tree 重构支持手风琴/高亮/复选框控制
-
3.4.X
2025- 变更新setConfig机制确保http在nvue等环境下生效
- 新增step组件增加title插槽及增加辅助class便于自定义样式
- 新增modal增加异步操作进行中点击取消弹出提示特性防止操作被中断
- 新增tag组件新增textSize/height/padding/borderRadius属性
- 新增新增genLightColor自动计算浅色方法及tag组件支持autoBgColor自动计算背景色
- 新增upload组件支持服务器本机和阿里云OSS自动上传功能及上传进度条
- 新增upload组件支持视频预览及oss上传时获取视频封面图
- 新增新增up-action-sheet-data快捷组件
- 新增新增up-picker-data快捷组件
- 修复dropdown关闭后遮挡页面内容 #653
- 新增支持自托管内置图标及扩展自定义图标
- 新增优化全局导入组件,增加App环境下全自动导入。
- 修复up-form编译在微信小程序里样式缺失 #640
-
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模式下运行