hmos-arkui-longtake-transition

Installation
SKILL.md

鸿蒙一镜到底转场效果 Skill

本skill指导如何为鸿蒙应用添加一镜到底(LongTake)转场效果,使用 @hmanimations/ezcustomtransition 三方库实现从触发页组件到目标页的流畅过渡动画。

前提条件检查

在开始集成前,先确认用户的工程满足以下条件:

  1. 使用 Navigation 路由 — 应用必须基于 Navigation + NavDestination 的路由体系,而非 Router
  2. 目标页适配沉浸式状态栏 — 一镜到底目标页需要适配沉浸式状态栏效果
  3. 目标页隐藏默认标题栏 — NavDestination 必须配置 .hideTitleBar(true),标题栏内容由应用自己绘制

如果不满足,先提示用户调整工程结构,再继续集成。

集成步骤

集成一镜到底效果需要修改6个位置,按顺序执行。每个步骤都至关重要——遗漏任何一步都会导致转场动画无法正常工作。

详细API参考请阅读 references/ezcustomtransition.md,常见问题排查请阅读 references/best-practices.md

Installs
3
First Seen
Jun 22, 2026
hmos-arkui-longtake-transition — iskenkenya/skills