@capgo/capacitor-native-navigation

原生导航栏

使用平台 UI 代替 web 组件绘制顶部导航栏和底部标签栏。

web 所有路由

原生发送用户意图事件，然后您的现有路由器更改 WebView 内容。

序列化图标

使用 SVG、SF Symbol、内置图像或 Android drawable 描述符配置选项卡和按钮。

原生过渡壳

捕获当前 WebView，通过 JavaScript 更新内容，然后使用原生快照到 WebView 动画完成。

缩放路线

使用共享元素样式的原生缩放几何学打开卡片、网格和媒体详细路线。

演示

原生壳	触摸流

Core API

• configure(options?) 支持原生 Chrome 主机并控制内容边距。
• setNavbar(options) 更新原生标题、副标题、后退按钮、按钮、颜色、透明度和可见性。
• setTabbar(options) 更新选项卡、选中选项卡、徽章、标签、图标、颜色和可见性。
• beginTransition(options?) 捕获 WebView 发出之前的 JavaScript 路由更改。
• finishTransition(options?) 从捕获的快照到 live WebView 进行动画，直到路由内容准备就绪。
• beginZoomTransition(target, options?) 和 finishZoomTransition(target?, options?) 是用于从元素或矩形进行缩放过渡的 JavaScript 帮助程序。
• getPluginVersion() 返回原生实现版本标记。

事件

• navbarBack 当原生后退手柄被点击时触发。
• navbarItemTap 当原生导航栏操作按钮被点击时触发。
• tabSelect 当原生标签被选中时触发。
• safeAreaChanged 报告原生栏和安全区域的边距变化。
• transitionStart 并 transitionEnd 报告原生过渡边界。

平台模型

iOS 使用 UINavigationBar 并 UITabBar. 在 iOS 26 和更高版本中，插件让系统渲染 Liquid Glass 行为；旧版本使用原生半透明/材料 fallbacks。

Android 使用 AppCompat 工具栏和 Material 底部导航栏，边缘到边缘。

插件不创建一个原生 WebView per 路由。版本 1 保持一个单独的 Capacitor WebView 以便桥梁稳定，让原生拥有仅仅是框架，栏视觉，标签选择 Chrome，安全区域报告和过渡壳。

继续从 @capgo/capacitor-native-navigation 中

如果您正在使用 @capgo/capacitor-native-navigation 来规划原生媒体和界面行为，连接它与 使用 @capgo/capacitor-native-navigation 为原生能力在使用 @capgo/capacitor-native-navigation 中 使用 @capgo/capacitor-live-activities 为原生能力在使用 @capgo/capacitor-live-activities 中 @capgo/capacitor-live-activities 为 @capgo/capacitor-live-activities 实现细节 使用 @capgo/capacitor-video-player 为了使用@capgo/capacitor-video-player的原生能力， @capgo/capacitor-video-player 为了@capgo/capacitor-video-player的实现细节，