@capgo/capacitor-native-navigation

原生 Chrome

使用平台 UI 绘制顶部导航栏和底部标签栏，而不是 web 组件。

web 所有路由

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

序列化图标

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

原生过渡壳

捕获当前 WebView，使用 JavaScript 更新内容，然后以原生快照到 WebView 动画结束。

缩放路由

打开带有共享元素样式原生缩放几何的卡片、网格和媒体详细信息路由。

演示

原生壳	点击流

核心 API

• configure(options?) 启用本地浏览器宿主并控制内容边距。
• setNavbar(options) 更新本地标题、副标题、后退按钮、按钮、颜色、透明度和可见性。
• setTabbar(options) 更新标签页、选中标签页、徽章、标签、图标、颜色和可见性。
• beginTransition(options?) 捕获 WebView 出口之前的 JavaScript 路由变化。
• finishTransition(options?) 在路由内容准备好后，从捕获的快照中动画到 live WebView。
• beginZoomTransition(target, options?) 并 finishZoomTransition(target?, options?) 用于元素或矩形的 JavaScript 帮助，实现从元素或矩形的缩放过渡。
• getPluginVersion() 返回本地实现版本标记。

事件

• navbarBack 事件
• navbarItemTap fires when a native navbar action button is tapped.
• tabSelect fires when a native tab is selected.
• safeAreaChanged reports native bar and safe-area inset changes.
• transitionStart 和 transitionEnd report native transition boundaries.

平台模型

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 for the native capability in Using @capgo/capacitor-native-navigation, 使用@capgo/capacitor-native-navigation for the native capability in Using @capgo/capacitor-live-activities, 使用@capgo/capacitor-live-activities for the implementation detail in @capgo/capacitor-live-activities, @capgo/capacitor-live-activities 为使用 @capgo/capacitor-video-player 这个原生能力， @capgo/capacitor-video-player 为 @capgo/capacitor-video-player 这个实现细节，