跳过主要内容
返回插件
@capgo/capacitor-navigation-bar
教程
@capgo/capacitor-navigation-bar

导航栏

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

指南

导航栏上的导游

在设备上测试

下载Capgo应用,然后扫描code中的二维码

导航栏插件预览二维码code

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

全局参考

继续使用@capgo/capacitor-navigation-bar

如果您正在使用 使用@capgo/capacitor-navigation-bar 来规划原生媒体和界面行为,连接它与 @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 的原生能力