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

导航条

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

全局参考

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

如果您正在使用 使用@capgo/capacitor-导航栏 来规划原生媒体和界面行为,连接它与 @capgo/capacitor-导航栏 了解@capgo/capacitor-导航栏的实现细节在 开始使用 了解开始使用的实现细节在 使用@capgo/capacitor-实时活动 来实现原生能力的@capgo/capacitor-实时活动 @capgo/capacitor-实时活动 了解@capgo/capacitor-实时活动的实现细节在 使用@capgo/capacitor-视频播放器 为native能力在使用 @capgo/capacitor-video-player 中。