Saltar al contenido
Capgo - Actualizaciones en vivo para aplicaciones Capacitor Capgo

@capgo/capacitor-navegación nativa

Rendere la barra de navegación de iOS y Android nativamente mientras JavaScript sigue controlando las rutas, el contenido, los iconos, los etiquetas y el estado de la barra.
Comienza GitHub

Navegación nativa

Dibuja la barra de navegación superior y la barra de pestañas inferior con la interfaz de usuario de la plataforma en lugar de componentes web.

Rutas propiedad de la web

La navegación nativa emite eventos de intención del usuario, luego su router existente cambia el contenido de la WebView.

Iconos serializados

Configura pestañas y botones con descripciones de SVG, SF Symbol, imágenes embutidas o Android drawable.

Concha de transición nativa

Captura la WebView actual, actualiza el contenido en JavaScript y luego finaliza con una animación de snapshot a WebView nativa.

Zoom de rutas

Abre rutas de tarjeta, mosaico y detalles de medios con geometría de zoom de elementos compartidos estilo nativo.

Demo

Sección titulada “Demo”
Concha nativaFlujo de toque
Demostración animada de concha de navegación nativa que muestra una barra de navegación nativa, pestañas y contenido de WebViewDemostración animada de flujo de toque nativo que muestra la selección de pestañas, transición de empuje y botón de atrás nativo

Núcleo API

Sección titulada “Núcleo API”
  • configure(options?) habilita el host de chrome nativo y controla los márgenes de contenido.
  • setNavbar(options) actualiza el título, subtítulo, botón de atrás, botones, colores, transparencia y visibilidad.
  • setTabbar(options) actualiza las pestañas, pestaña seleccionada, etiquetas, iconos, colores y visibilidad.
  • beginTransition(options?) captura la WebView saliente antes del cambio de ruta de JavaScript.
  • finishTransition(options?) animación desde la captura de instantáneo a la WebView en vivo después de que el contenido de la ruta esté listo.
  • beginZoomTransition(target, options?) y finishZoomTransition(target?, options?) son ayudantes de JavaScript para transiciones de zoom desde elementos o rectángulos.
  • getPluginVersion() devuelve el marcador de versión de implementación nativa.

Eventos

Sección titulada “Eventos”
  • navbarBack dispara cuando se toca la oferta de atrás nativa.
  • navbarItemTap dispara cuando se presiona un botón de acción de la barra de navegación nativa.
  • tabSelect dispara cuando se selecciona una pestaña nativa.
  • safeAreaChanged informa los cambios en los márgenes de la barra y la zona segura.
  • transitionStart y transitionEnd informa los límites de transición nativa.

Modelo de plataforma

Sección titulada “Modelo de plataforma”

iOS utiliza UINavigationBar y UITabBarEn iOS 26 y posteriores, el complemento permite que el sistema renderice el comportamiento de vidrio líquido; las versiones anteriores utilizan fallbacks de transparencia/material nativos.

Android utiliza una barra de herramientas de AppCompat y una navegación inferior de Material con colocación de borde a borde.

El complemento no crea una WebView nativa por ruta. La versión 1 mantiene un solo WebView Capacitor para estabilidad de puente y deja que el nativo tenga solo el marco, la barra de visualización, la selección de pestañas, el informe de zona segura y la caja de transición.

Sigue adelante desde @capgo/capacitor-navegación nativa

Título de la sección “Sigue adelante desde @capgo/capacitor-navegación nativa”

Si estás utilizando @capgo/capacitor-navegación nativa para planificar el comportamiento de medios y interfaz nativa, conecta con Usando @capgo/capacitor-navegación nativa para la capacidad nativa en Usando @capgo/capacitor-navegación nativa, Usando @capgo/capacitor-actividades en vivo para la capacidad nativa en Usando @capgo/capacitor-actividades en vivo, @capgo/capacitor-actividades en vivo para el detalle de implementación en @capgo/capacitor-actividades en vivo, Usando @capgo/capacitor-reproductor de video para la capacidad nativa en Usando @capgo/capacitor-reproductor-de-videos, y @capgo/capacitor-reproductor-de-videos para el detalle de implementación en @capgo/capacitor-reproductor-de-videos.