Saltare al contenuto

@capgo/capacitor-navigazione nativa

Rendere la navigazione iOS e Android nativamente mentre JavaScript mantiene le rotte, il contenuto, gli iconi, i nomi e lo stato della barra.

Chrome nativo

Disegna la barra di navigazione superiore e la barra dei pulsanti inferiori con l'interfaccia utente del dispositivo al posto dei componenti web.

Rotte di proprietà web

Il nativo emette eventi di intento dell'utente, quindi il tuo router esistente cambia il contenuto della finestra di visualizzazione web.

Icone serializzate

Configura schede e pulsanti con descriptor SVG, SF Symbol, immagine incorporata o descriptor Android drawable.

Shell di transizione nativa

Cattura la WebView corrente, aggiorna il contenuto in JavaScript, quindi finisci con un'animazione di snapshot-to-WebView nativa.

Zoom percorsi

Apri le rotte di card, griglia e media-detail con geometria di zoom nativa a stile elemento condiviso.

Shell nativaFlusso di tap
Demo di navigazione nativa animata che mostra un navbar nativo, schede e contenuto WebViewFlusso di tap nativa animato che mostra la selezione di schede, transizione di push e back nativo
  • configure(options?) abilita l'host chrome nativo e controlla gli insetti di contenuto.
  • setNavbar(options) aggiorna il titolo, la sottotitolo, il pulsante indietro, i pulsanti, i colori, la trasparenza e la visibilità.
  • setTabbar(options) aggiorna le schede, la scheda selezionata, le etichette, le icone, i colori e la visibilità.
  • beginTransition(options?) captura la WebView in uscita prima del cambio di route JavaScript.
  • finishTransition(options?) animazione da snapshot catturato alla WebView live dopo che il contenuto della route è pronto.
  • beginZoomTransition(target, options?) e finishZoomTransition(target?, options?) sono aiuti JavaScript per le transizioni di zoom da elementi o rettangoli.
  • getPluginVersion() restituisce il marker di versione dell'implementazione nativa.
  • navbarBack si attiva quando l'affordance di ritorno nativo viene premuto.
  • navbarItemTap si attiva quando viene premuto un pulsante di azione della barra di navigazione nativa.
  • tabSelect si attiva quando viene selezionata una scheda nativa.
  • safeAreaChanged rappresenta i cambiamenti degli insetti della barra e dell'area di sicurezza nativa.
  • transitionStart e transitionEnd rappresenta i confini di transizione nativa.

iOS utilizza UINavigationBar e UITabBar. Su iOS 26 e versioni successive, il plugin consente al sistema di rendere il comportamento di vetro liquido; le versioni più vecchie utilizzano fallback materiali traslucidi/nativi.

Android utilizza un toolbar AppCompat e una navigazione inferiore Material con posizionamento orizzontale.

Il plugin non crea un WebView nativo per ogni route. La versione 1 mantiene un singolo WebView Capacitor per stabilità del ponte e lascia che il nativo possieda solo il frame, le visualizzazioni della barra, la selezione della scheda, il chrome della selezione della scheda, la segnalazione dell'area di sicurezza e la shell di transizione.

Se stai utilizzando @capgo/capacitor-navigazione-nativa per pianificare il comportamento di media e interfaccia nativa, connettilo con Utilizzando @capgo/capacitor-navigazione-nativa per la capacità nativa in Utilizzando @capgo/capacitor-navigazione-nativa, Utilizzando @capgo/capacitor-attività-in-vivo per la capacità nativa in Utilizzando @capgo/capacitor-attività-in-vivo, @capgo/capacitor-attività-in-vivo per il dettaglio di implementazione in @capgo/capacitor-attività-in-vivo, Utilizzando @capgo/capacitor-lettore-di-video per la capacità nativa in Utilizzare @capgo/capacitor-player-video, e @capgo/capacitor-player-video per il dettaglio di implementazione in @capgo/capacitor-player-video.