0.5.0重磅发布:动画插件+H5体验全面优化

v0.5.0 为 MINOR 版本,核心能力是新增 AnimationPlugin 导航窗口动画插件 (App / 小程序透传原生动画、H5 用 Web Animations API 实现),并附带两处 H5 动画体验修复(首次进入卡顿、返回动画不生效)与查询参数工具的公共导出。本版本无破坏性变更。

一、新增:AnimationPlugin 导航窗口动画插件

为导航注入窗口过渡动画,对齐 uni-app x 原生 animationType:

ts 复制代码
import { createRouter, AnimationPlugin } from '@meng-xi/unix-router'

const router = createRouter({
  routes,
  plugins: [AnimationPlugin],
  animation: { type: 'slide-in-right', duration: 300 } // 全局默认动画(可选)
})

// 单次覆盖:本次导航使用 fade-in
router.push({ path: 'pages/detail/detail', animationType: 'fade-in', animationDuration: 500 })

跨端实现

平台 实现方式
App / 小程序 透传 animationType / animationDuration 给 uni.* 原生导航 API(原生窗口动画)
H5 通过 Web Animations API(element.animate)播放进入 / 退出动画,无需 CSS @keyframes(遵守项目 CSS 规则)

动画类型

slide-in-right / slide-in-left / slide-in-top / slide-in-bottom / fade-in / zoom-in / zoom-fade-in / pop-in / auto / none。

  • back() 使用全局默认动画作为关闭动画(back 无 location 可传,单次覆盖仅对前向导航有效);
  • 未注册插件时携带 animationType 的导航仍正常执行(动画被忽略);
  • H5 端依赖核心新增的 onBeforeNavigation 异步钩子 :返回时会先播完退出动画再真正 navigateBack。

二、修复:H5 动画体验

1. 首次进入二级页面动画卡顿

根因 :onCompleteNavigation 回调触发时,uni-app x H5 已把新页内容替换进 uni-page(data-page 已切换),但旧实现等 rAF 动画第一帧才把元素跳到 translateX(100%)。页面在原位静止显示 1-2 帧后再跳向屏幕外滑入,造成「内容闪现后再滑一次」的割裂感(观感卡顿)。

修复 :onCompleteNavigation 内同步应用动画起点样式 (如 transform: translateX(100%))+ 强制 reflow,让新页渲染首帧即位于屏幕外,再于下一帧播放滑入动画;动画结束后清理内联起点样式,避免残留注入影响后续 back 的退出动画起始帧。

2. H5 返回动画不生效

根因 :back 时以进入型动画类型(如 slide-in-right)查找退出关键帧表,查不到 → 静默不播。

修复 :新增 toExitType() 映射(进入型 → 退出型,如 slide-in-right → slide-out-right),退出动画得以正确播放。

三、新增:查询参数工具公共导出

queryInt() / queryNumber() / queryBool() 此前仅能从 utils/query.uts 相对路径导入,现由库入口直接导出:

ts 复制代码
import { queryInt, queryNumber, queryBool, useRoute } from '@meng-xi/unix-router'

const route = useRoute()
const idNum = queryInt(route.query, 'id', 0)     // 便捷解析数值
const flag  = queryBool(route.query, 'vip', false) // 便捷解析布尔

四、升级指南

从 ≤0.4.x 升级无需任何改动(无破坏性变更)。按需启用动画:

  1. 注册插件并(可选)配置全局默认动画:plugins: [AnimationPlugin] + animation: { type, duration };
  2. 单次覆盖:导航位置对象携带 animationType / animationDuration。

版本兼容性

功能 ≤0.4.x 0.5.0
导航动画 ❌ ✅ AnimationPlugin(跨端)
animation / animationType 选项 ❌ ✅
H5 back 退出动画 ❌ ✅
queryInt 等工具 仅相对路径 ✅ 公共导出

五、相关链接

欢迎反馈与共建:GitHub

相关推荐
htzyl2065 分钟前
前端监控最容易写错的 18 个地方:从平均值到 beforeunload
前端·浏览器
鹿鹿鹿鹿isNotDefined9 分钟前
布局更新后,canvas 重新绘制,出现了只持续一帧的闪烁?!
前端·javascript·vue.js
zhanlang021713 分钟前
HTML 零基础入门到企业实战【第六章 表格标签】6.3 单元格合并:跨行 rowspan、跨列 colspan 实战技巧
前端·html
技术分享官15 分钟前
Geejing WebBuilder 新手指导:用 Wb.Button 按钮组件跑通企业级快速开发平台的前后端闭环
前端·javascript·低代码
SameX15 分钟前
ArkTS 没有 AbortController 怎么取消 setTimeout 链用自增 token 的做法
前端
不可能片场35 分钟前
工程实践 雪花id进JS别当数字传
前端·electron
涛涛ing42 分钟前
AI帮我生成了一个炫酷的3D大屏,上线3天就卡崩了
前端
jerrywus1 小时前
用 AMD Radeon Cloud 免费跑 ComfyUI:从开机到打开界面
前端·agent·claude
学以智用1 小时前
CKEditor5 完整详解
前端·后端
掘金者阿豪1 小时前
数据库性能优化:一次慢查询背后,可能不只是SQL的问题
前端·后端