跳过主要内容
返回插件
@capgo/capacitor-导航条
教程
@capgo/capacitor-导航条

导航条

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

指南

导航栏教程

在设备上测试

Download the Capgo app, then scan the QR code.

导航栏插件预览二维码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);

完整参考

继续使用@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 中