@capgo/capacitor-navigation-native

Chrome natif

Dessinez la barre de navigation supérieure et la barre de boutons inférieure avec l'UI de la plateforme au lieu de composants web.

Routes détenues par le web

Le shell natif émet des événements d'intention utilisateur, puis votre routeur existant change le contenu de la vue WebView.

Icônes sérialisées

Configurez les onglets et les boutons avec SVG, SF Symbol, image embarquée ou descripteurs de drawable Android.

Shell de transition natif

Capturer la vue WebView actuelle, mettre à jour le contenu en JavaScript, puis terminer avec une animation de snapshot à WebView natif.

Zoom des routes

Ouvrir les routes de carte, grille et détails de média avec une géométrie de zoom natif à l'élément partagé.

Démo

Shell natif	Flux de tap

Le noyau API

• configure(options?) active le hôte de chrome natif et contrôle les marges de contenu.
• setNavbar(options) met à jour le titre, le sous-titre, le bouton de retour, les boutons, les couleurs, la transparence et la visibilité.
• setTabbar(options) met à jour les onglets, l'onglet sélectionné, les badges, les étiquettes, les icônes, les couleurs et la visibilité.
• beginTransition(options?) capture la vue WebView avant le changement de route JavaScript.
• finishTransition(options?) anime à partir du snapshot capturé vers la vue WebView en direct après que le contenu de la route soit prêt.
• beginZoomTransition(target, options?) et finishZoomTransition(target?, options?) sont des aides JavaScript pour les transitions de zoom à partir d'éléments ou de rectangles.
• getPluginVersion() renvoie la marque de version de l'implémentation native.

Événements

• navbarBack se déclenche lorsque l'affordance de retour native est tapée.
• navbarItemTap se déclenche lorsque bouton d'action de la barre de navigation native est tapé.
• tabSelect se déclenche lorsque une barre de tab native est sélectionnée.
• safeAreaChanged signale les changements des barres et des aires de sécurité.
• transitionStart et transitionEnd reporter les limites de transition natives.

Modèle de plateforme

iOS utilise UINavigationBar et UITabBarSur iOS 26 et versions plus récentes, le plugin laisse le système rendre le comportement de verre liquide ; les versions plus anciennes utilisent des fallbacks translucides/matériels natives.

Android utilise un menu d'application AppCompat et une navigation en bas avec un placement à l'égard de l'arête.

Le plugin ne crée pas un WebView natif par route. La version 1 garde un seul Capacitor WebView pour la stabilité de la passerelle et laisse les natives gérer uniquement la fenêtre, la barre de navigation, le choix de la page, la zone de sécurité et la coque de transition.

Continuez à partir de @capgo/capacitor-navigation native

Si vous utilisez @capgo/capacitor-navigation native pour planifier le comportement des médias et des interfaces natives, connectez-le à En utilisant @capgo/capacitor-navigation-native pour la capacité native dans En utilisant @capgo/capacitor-navigation-native, En utilisant @capgo/capacitor-activités-en-vive pour la capacité native dans En utilisant @capgo/capacitor-activités-en-vive, @capgo/capacitor-activités-en-vive pour le détail d'implémentation dans @capgo/capacitor-activités-en-vive, En utilisant @capgo/capacitor-joueur-de-videos pour la capacité native dans En utilisant @capgo/capacitor-joueur-de-videos, et @capgo/capacitor-joueur-de-videos pour le détail d'implémentation dans @capgo/capacitor-joueur-de-videos.