hmos-arkui-longtake-transition
Installation
SKILL.md
鸿蒙一镜到底转场效果 Skill
本skill指导如何为鸿蒙应用添加一镜到底(LongTake)转场效果,使用 @hmanimations/ezcustomtransition 三方库实现从触发页组件到目标页的流畅过渡动画。
前提条件检查
在开始集成前,先确认用户的工程满足以下条件:
- 使用 Navigation 路由 — 应用必须基于 Navigation + NavDestination 的路由体系,而非 Router
- 目标页适配沉浸式状态栏 — 一镜到底目标页需要适配沉浸式状态栏效果
- 目标页隐藏默认标题栏 — NavDestination 必须配置
.hideTitleBar(true),标题栏内容由应用自己绘制
如果不满足,先提示用户调整工程结构,再继续集成。
集成步骤
集成一镜到底效果需要修改6个位置,按顺序执行。每个步骤都至关重要——遗漏任何一步都会导致转场动画无法正常工作。
详细API参考请阅读 references/ezcustomtransition.md,常见问题排查请阅读 references/best-practices.md。