メインコンテンツへスキップ
@capgo/capacitor-navigation-bar UI & システム オープンソース

ナビゲーションバー Capacitor プラグイン

Android のナビゲーションバーの色や表示設定をカスタマイズし、没入感のある UI を実現します

インストール

bun add @capgo/capacitor-navigation-bar bunx cap sync
npm、pnpm、または yarn
  • npm install @capgo/capacitor-navigation-bar
  • pnpm add @capgo/capacitor-navigation-bar
  • yarn add @capgo/capacitor-navigation-bar

ガイド

Capacitor で Navigation Bar を使う方法

実機でテストする

Capgo アプリをダウンロードして、QR code をスキャンしてください。

Navigation Bar plugin プレビュー QR code

@capgo/capacitor-navigation-bar の使用方法

Androidのナビゲーションバーをカスタマイズするための Capacitor Navigation Bar Plugin。

インストール

bun add @capgo/capacitor-navigation-bar
bunx cap sync

このプラグインで利用可能な機能

  • setNavigationBarColor - ナビゲーションバーの色とボタンのテーマを設定します。
  • getNavigationBarColor - 現在のナビゲーションバーの色とボタンのテーマを取得します。

実装例

setNavigationBarColor

ナビゲーションバーの色とボタンのテーマを設定します。

import { NavigationBar, NavigationBarColor } from '@capgo/capacitor-navigation-bar';

// Set to white with dark buttons
await NavigationBar.setNavigationBarColor({
  color: NavigationBarColor.WHITE,
  darkButtons: true
});

// Set to custom color
await NavigationBar.setNavigationBarColor({
  color: '#FF5733',
  darkButtons: false
});

// Set a custom divider color on Android 9+
await NavigationBar.setNavigationBarColor({
  color: NavigationBarColor.WHITE,
  darkButtons: true,
  dividerColor: '#D9D9D9'
});

getNavigationBarColor

現在のナビゲーションバーの色とボタンのテーマを取得します。

import { NavigationBar } from '@capgo/capacitor-navigation-bar';

const { color, darkButtons } = await NavigationBar.getNavigationBarColor();
console.log('Current color:', color);
console.log('Using dark buttons:', darkButtons);

リファレンス全文

@capgo/capacitor-navigation-bar の使用方法へ進む

以下を使用している場合: @capgo/capacitor-navigation-bar の使用方法 ネイティブのメディアやインターフェースの挙動を計画し、以下と連携させます: @capgo/capacitor-navigation-bar @capgo/capacitor-navigation-bar での実装の詳細についてはこちら: はじめに Getting Started の実装の詳細については、 @capgo/capacitor-live-activities の使用 @capgo/capacitor-live-activities を使用したネイティブ機能について、 @capgo/capacitor-live-activities @capgo/capacitor-live-activities の実装詳細については、 @capgo/capacitor-video-player の使用 @capgo/capacitor-video-player. を使用したネイティブ機能について

よくある質問

Navigation Bar プラグイン FAQ

Capacitor アプリに Navigation Bar プラグインをインストールするにはどうすればよいですか?

"bun add @capgo/capacitor-navigation-bar" (または "npm install @capgo/capacitor-navigation-bar") を実行した後、"bunx cap sync" を実行して、iOS および Android プロジェクトにネイティブの code を反映させてください。その後、アプリの code から "@capgo/capacitor-navigation-bar" をインポートします。

@capgo/capacitor-navigation-bar は React、Vue、Angular で動作しますか?

はい。Navigation Bar は Capacitor パッケージであるため、Ionic、React、Vue、Angular、Svelte、およびプレーンな JavaScript を含む、Capacitor 内で動作するあらゆる Web フレームワークで使用可能です。

@capgo/capacitor-navigation-bar はどの Capacitor バージョンをサポートしていますか?

Capgo プラグインは Capacitor のメジャーバージョンに合わせています。使用している Capacitor のメジャーバージョンと一致するプラグインのメジャーバージョンを使ってください (例: Capacitor 8 ならプラグイン v8)。GitHub の README にある互換性テーブルに、メンテナンス中のバージョンが記載されています。

@capgo/capacitor-navigation-bar は無料かつオープンソースですか?

はい。code のソースコードは GitHub の https://github.com/Cap-go/capacitor-navigation-bar/ で公開されており、パッケージは npm から無料でインストールできます。バグ報告やプルリクエストもお待ちしています。

App Store の審査なしで、Navigation Bar を使用している code をアップデートできますか?

このプラグインをインストールまたはアップグレードするとネイティブの code が変わるため、ストア向けの新しいビルドが必要です。その後は、プラグインを呼び出す JavaScript、HTML、CSS の変更を Capgo によるライブアップデートで即座に配信できます。

アプリの審査を待たずに Navigation Bar の変更をリリース

ストアビルドにプラグインを組み込めば、Capgo のライブアップデートで JavaScript、HTML、CSS の変更を数分でユーザーに配信できます。

Capgo から始める