はじめに

インストール

AIアシストセットアップを使ってプラグインをインストールできます。以下のコマンドで、お使いのAIツールに Capgo スキルを追加してください：

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

次に、以下のプロンプトを使用します：

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-navigation-bar` plugin in my project.

手動セットアップを希望する場合は、以下のコマンドでプラグインをインストールし、下記のプラットフォーム別の手順に従ってください：

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

インポート

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

クイックスタート

ナビゲーションバーをダークヘッダーとライトアイコンに合わせます。

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

await NavigationBar.setNavigationBarColor({
  color: '#0f172a',
  darkButtons: false,
});

例：イマーシブリーダーモード

await NavigationBar.hide();
// later, when leaving the reader
await NavigationBar.show();

例：現在のテーマを読み取る

const { color, darkButtons } = await NavigationBar.getNavigationBarColor();

よくある落とし穴

• Android のみ：このプラグインにはiOSのナビゲーションバーに相当する機能はありません。
• エッジ・トゥ・エッジ：ステータスバーやWebViewのsafe area CSSと組み合わせることで、バーが再表示された際にコンテンツが隠れるのを防げます。

API の概要

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

型リファレンス

NavigationBarColor

定義済みのナビゲーションバーの色。

export enum NavigationBarColor {
  /** White color */
  WHITE = '#FFFFFF',
  /** Black color */
  BLACK = '#000000',
  /** Transparent color */
  TRANSPARENT = 'transparent',
}

信頼できる情報源

このページはプラグインの src/definitions.tsから生成されています。上流で公開 API が変更されたら、sync を再実行してください。

Getting Started から続ける

以下を使用している場合： はじめに ネイティブのメディアやインターフェースの挙動を計画するには、以下と連携させてください： @capgo/capacitor-navigation-bar を使用する場合 @capgo/capacitor-navigation-bar を使用したネイティブ機能について： @capgo/capacitor-live-activities の使用 @capgo/capacitor-live-activities を使用したネイティブ機能について、 @capgo/capacitor-live-activities @capgo/capacitor-live-activities の実装詳細について、 @capgo/capacitor-video-player の使用 @capgo/capacitor-video-player を使用したネイティブ機能、および @capgo/capacitor-video-player @capgo/capacitor-video-player. の実装詳細