メインコンテンツにジャンプ
プラグインに戻る
@capgo/capacitor-ナビゲーションバー
チュートリアル
github.com/Cap-go による

ナビゲーションバー

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

ガイド

ナビゲーションバーのチュートリアル

@capgo/capacitor-navigation-bar を使用する

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);

フルリファレンス