跳过内容

@capgo/capacitor-转场

为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 边缘滑动返回手势,跟随用户的手指
  • 框架特定设置辅助函数而无需框架特定的路由器
使用 Capacitor 风格壳的前进和后退导航的动画 React 页面转场演示
React 转场流程
  • <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 滑动后退转场效果一样,通过驱动动画进度从指针位置开始,然后根据距离和速度来完成或取消。

继续阅读 @capgo/capacitor-transitions

标题:继续阅读 @capgo/capacitor-transitions

如果您正在使用 @capgo/capacitor-transitions 来规划原生媒体和界面行为,连接它与 使用 @capgo/capacitor-transitions for the native capability in Using @capgo/capacitor-transitions, 使用 @capgo/capacitor-transitions for the native capability in Using @capgo/capacitor-live-activities, @capgo/capacitor实时活动 为 @capgo/capacitor实时活动 的实现细节 使用 @capgo/capacitor视频播放器 为使用 @capgo/capacitor视频播放器 的原生能力, 和 @capgo/capacitor视频播放器 为 @capgo/capacitor视频播放器 的实现细节