@capgo/capacitor-navegación nativa

Navegación Nativa

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

Rutas propiedad de la web

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

Iconos serializados

Configure pestañas y botones con SVG, SF Symbol, imágenes embaladas o descripciones de recursos de Android.

Conjunto 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

Conjunto de shell nativa	Flujo de toque

Núcleo API

• configure(options?) Habilita el host de chrome nativo y controla los márgenes de contenido.
• setNavbar(options) Actualiza título, subtítulo, botón de atrás, botones, colores, transparencia y visibilidad.
• setTabbar(options) Actualiza pestañas, pestaña seleccionada, etiquetas, iconos, colores y visibilidad.
• beginTransition(options?) Captura la WebView saliente antes del cambio de ruta en 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 la marca de versión de la implementación nativa.

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 la transición nativa.

Modelo de plataforma

iOS utiliza UINavigationBar y UITabBar. En iOS 26 y posteriores, el plugin permite que el sistema renderice el comportamiento de vidrio líquido; las versiones anteriores utilizan respaldos de material translúcido/nativo.

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

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, el selector de pestañas, la zona segura y la caja de transició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-video-player, y @capgo/capacitor-video-player para el detalle de implementación en @capgo/capacitor-video-player.