@capgo/capacitor-native-navigation

iOS와 Android의 네비게이션 크롬을 자바스크립트가 경유하는 경로, 콘텐츠, 아이콘, 레이블 및 바 상태를 소유하는 동안 네이티브로 렌더링합니다.

네이티브 크롬

플랫폼 UI 대신 웹 컴포넌트가 아닌 상단 네비게이션 바와 하단 탭 바를 그립니다.

웹 소유 경로

네이티브는 사용자 의도 이벤트를 발생시키고, 그 후에 존재하는 라우터가 WebView의 콘텐츠를 변경합니다.

직렬화 아이콘

SVG, SF Symbol, 패키지 이미지, 또는 Android drawable descriptor를 사용하여 탭과 버튼을 구성합니다.

네이티브 전환 셸

현재 WebView를 캡처하고, JavaScript에서 콘텐츠를 업데이트한 후 네이티브 스냅샷-WebView 애니메이션으로 마무리합니다.

줌 경로

공유된 요소 스타일 네이티브 줌 기하학으로 카드, 그리드, 미디어 디테일 경로를 열 수 있습니다.

데모

네이티브 셸	탭 흐름

configure(options?) 네이티브 크롬 호스트를 활성화하고 콘텐츠 인셋을 제어합니다.
setNavbar(options) 네이티브 제목, 서브 타이틀, 뒤로 가기 버튼, 버튼, 색상, 투명도 및 가시성을 업데이트합니다.
setTabbar(options) 탭, 선택된 탭, 배지, 레이블, 아이콘, 색상 및 가시성을 업데이트합니다.
beginTransition(options?) JavaScript 경로 변경 전에 outgoing WebView를 캡처합니다.
finishTransition(options?) 경로 콘텐츠가 준비되면 live WebView로부터 캡처된 스냅샷으로 애니메이션합니다.
beginZoomTransition(target, options?) and finishZoomTransition(target?, options?) are JavaScript helpers for zoom transitions from elements or rectangles.
getPluginVersion() returns the native implementation version marker.

iOS는 UINavigationBar 와 UITabBar. iOS 26 이상 버전에서는 시스템이 Liquid Glass 동작을 렌더링하도록 허용하며, 이전 버전에서는 네이티브 투명/물리적 fallback을 사용합니다.

Android는 AppCompat 툴바와 Material 하단 네비게이션과 edge-to-edge 배치 사용합니다.

플러그인은 하나의 네이티브 WebView를 각 경로마다 생성하지 않습니다. 버전 1은 단일 Capacitor WebView를 유지하여橋의 안정성을 유지하고 네이티브가 프레임, 바 시각, 탭 선택 창, 안전 영역 보고, 전환 셸만 소유합니다.

@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-네이티브 네비게이션을 사용 중이라면 @capgo/capacitor-네이티브 네비게이션을 사용하여 네이티브 미디어 및 인터페이스 동작을 계획하고 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-네이티브 네비게이션을 사용합니다. @capgo/capacitor-네이티브 네비게이션을 사용합니다. native 기능을 사용하는 @capgo/capacitor-native-navigation을 위해 native 기능을 사용하는 @capgo/capacitor-live-activities native 기능을 사용하는 @capgo/capacitor-live-activities를 위해 @capgo/capacitor-live-activities implementation detail을 사용하는 @capgo/capacitor-live-activities native 기능을 사용하는 @capgo/capacitor-video-player native 기능을 사용하는 @capgo/capacitor-video-player을 위해 @capgo/capacitor-video-player implementation detail을 사용하는 @capgo/capacitor-video-player