跳过主要内容
返回插件
@capgo/capacitor-navigation-bar
教程
由 github.com/Cap-go

导航栏

定制 Android 导航栏颜色和可见性以实现沉浸式 UI 体验

指南

导航栏指南

使用 @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);

全参考