Skip to content

@capgo/native-navigation

JavaScriptがルート、コンテンツ、アイコン、ラベル、バーの状態を管理するのに対して、iOSとAndroidのナビゲーションチームをネイティブにレンダリングします。

ネイティブChrome

プラットフォームUIでWebコンポーネントではなく、トップナビゲーションバーとボトムタブバーを描画する。

ウェブ所有ルート

ネイティブはユーザーインテントイベントを発生させ、既存のルーターがWebViewのコンテンツを変更します。

シリアライズされたアイコン

SVG、SF Symbol、バンドル画像、またはAndroid drawable descriptorを使用してタブとボタンを構成します。

ネイティブのトランジションシェル

現在のWebViewをキャプチャし、JavaScriptでコンテンツを更新し、ネイティブのスナップショットからWebViewへのアニメーションで終了します。

  • configure(options?) ネイティブChromeホストを有効化し、コンテンツインセットを制御します。
  • setNavbar(options) ネイティブのタイトル、サブタイトル、戻るボタン、ボタン、色、透明度、非表示を更新します。
  • setTabbar(options) タブ、選択されたタブ、バッジ、ラベル、アイコン、色、非表示を更新します。
  • beginTransition(options?) JavaScript ルート変更前に出発する WebView をキャプチャします。
  • finishTransition(options?) ルート コンテンツが準備された後、キャプチャされたスナップショットからライブ WebView までアニメーションします。
  • getPluginVersion() ネイティブ実装のバージョン マーカーを返します。
  • navbarBack ネイティブの戻るアフォーダンスがタップされたときに発火します。
  • navbarItemTap ネイティブのナビゲーションバー アクション ボタンがタップされたときに発火します。
  • tabSelect ネイティブのタブが選択されたときに発火します。
  • safeAreaChanged ネイティブバーとセーフエリア インセットの変更を報告します。
  • transitionStarttransitionEnd ネイティブのトランジション境界を報告します。

iOSは UINavigationBarUITabBariOS 26 以降では、プラグインはシステムが液体ガラスの動作をレンダリングすることを許可します。古いバージョンでは、ネイティブの半透明/マテリアルフォールバックが使用されます。

Androidは、エッジトゥーエッジの配置でAppCompatツールバーとマテリアルな下部ナビゲーショーを使用します。

プラグインは、バージョン1では、1つのCapacitor WebViewを保持し、ブリッジの安定性を確保し、ネイティブがフレーム、バーの視覚、タブの選択、セーフエリアの報告、トランジションシェルを所有することを許可します。