跳过内容

@capgo/capacitor-transitions

为Capacitor应用添加本地感知的路由转换和可选的iOS边缘滑动返回

Ionic 风格的运动

使用 iOS 和 Android 路由动画,模仿移动导航模式,而不需要将 Ionic 组件发送

滑动返回

启用一个跟随手指的 iOS 边缘手势,仅在原生 Capacitor iOS 中自动启用

框架无关

直接使用 Web 组件或为 React、Vue、Angular、Svelte 和 Solid 提供帮助

无 UI 锁定

带来自己的工具栏、内容、底部导航和路由器,而库协调转换层

@capgo/capacitor-transitions 适用于那些想要拥有Ionic质量页面动画效果,但不想采用Ionic组件系统的应用。它会在您的现有Web路由中保留导航,并在Capacitor WebView中动画化页面元素。

使用它时需要:

  • push、pop和root路由转换,感觉与平台约定相似
  • 协调的头部、内容和底部动画
  • 页面缓存以快速后退导航
  • 可选的iOS边缘滑动返回手势,遵循用户的手指
  • 框架特定设置助手,无框架特定路由
  • <cap-router-outlet> 拥有动画路由栈。
  • <cap-page> 包裹每个页面。
  • <cap-header>, <cap-content><cap-footer> 识别应该一起移动的区域。
  • initTransitions(options?) 初始化框架绑定。
  • setDirection('forward' | 'back' | 'root' | 'none') 告诉下一个路由更新哪个动画要运行。
  • setupRouterOutlet(element, options?) 连接一个插口到生命周期和手势行为。
  • setupPage(element, callbacks?) 注册页面生命周期回调。

平台模型

平台模型

platform="auto" 从运行时环境中选择 iOS 或 Android 动画配置文件。您可以强制 platform="ios"platform="android" 在测试时。

swipe-gesture="auto" 使用 Capacitor 运行时辅助工具,并仅在本机 iOS Capacitor 应用中启用边缘手势。使用 true 强制启用或 false 禁用它。

该手势在 Web 层中实现。它旨在通过从指针位置驱动动画进度,根据距离和速度来完成或取消,来模仿 Ionic 的 iOS 滑动返回转场效果。