メインコンテンツにジャンプします
プラグインに戻る
@capgo/capacitor-ナビゲーションバー
チュートリアル
@capgo/capacitor-ナビゲーションバー

ナビゲーションバー

Android ナビゲーションバーのカラーと可視性をカスタマイズして、インマーシブ UI エクスペリエンスを実現します。

Guide

Tutorial on Navigation Bar

Test on device

Download the Capgo app, then scan the QR code.

ナビゲーションバー プラグイン プレビュー QR code

@capgo/capacitor-ナビゲーションバーを使用する

Capacitorのナビゲーションバー プラグイン: Androidのナビゲーションバーをカスタマイズする

インストール

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

このプラグインが公開するもの

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

例の使用

setNavigationBarColor

- ナビゲーションバーの色とボタンのテーマを設定する

import { NavigationBar } 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);

フル リファレンス

Capacitor の @capgo/capacitor-navigation-bar を使用し続ける

Capacitor の @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-navigation-bar を使用している場合 Capacitor の @capgo/capacitor-live-activities と連携する Capacitor の @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-navigation-bar の実装詳細 @capgo/capacitor-navigation-bar for the implementation detail in @capgo/capacitor-navigation-bar, Capacitor の @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-live-activities を使用する @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-live-activities @capgo/capacitor-navigation-bar Capacitorのネイティブ機能を使用するために@capgo/capacitor-live-activities @capgo/capacitor-live-activities Capacitorの実装詳細を使用するために@capgo/capacitor-live-activities、 Capacitorのネイティブ機能を使用するために@capgo/capacitor-video-player Capacitorのネイティブ機能を使用するために@capgo/capacitor-video-player。