@capgo/capacitor-native-navigation

原生 Chrome

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

web 所有路由

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

序列化图标

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

原生转场壳

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

缩放路由

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

演示

原生壳	点击流

核心 API

• configure(options?) 启用本地 Chrome 主机并控制内容边距。
• setNavbar(options) 更新本地标题、副标题、后退按钮、按钮、颜色、透明度和可见性。
• setTabbar(options) 更新标签页、选中标签页、徽章、标签、图标、颜色和可见性。
• beginTransition(options?) 捕获 WebView 之前 JavaScript 路由变化的出站 WebView。
• 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的实现细节。