@capgo/capacitor-native-navigation

原生浏览器

使用原生 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_KEEP_0__/__CAPGO_KEEP_1__-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的实现细节。