跳过主要内容
@capgo/capacitor-导航栏 UI & 系统 开源

导航栏 Capacitor插件

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

安装

bun add @capgo/capacitor-navigation-bar bunx cap sync
npm, pnpm 或 yarn
  • npm install @capgo/capacitor-navigation-bar
  • pnpm add @capgo/capacitor-navigation-bar
  • yarn add @capgo/capacitor-navigation-bar

指南

如何在Capacitor中使用导航栏

在设备上测试

下载Capgo应用,扫描QR code

导航栏插件预览QR code

使用@capgo/capacitor-navigation-bar

Capacitor导航栏插件,用于自定义Android导航栏

安装

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

本插件暴露的内容

  • setNavigationBarColor - 设置导航栏颜色和按钮主题
  • getNavigationBarColor - 获取当前导航栏颜色和按钮主题

示例用法

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

完整参考

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

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

常见问题

导航栏插件常见问题

如何在Capacitor应用中安装导航栏插件?

运行"bun add @capgo/capacitor-导航栏"(或"npm install @capgo/capacitor-导航栏"),然后运行"bunx cap sync"以便iOS和Android项目捕获native code。从"@capgo/capacitor-导航栏"中导入它到你的code应用中。

Does @capgo/capacitor-navigation-bar 支持 React、Vue 和 Angular 吗?

Yes. Navigation Bar 是一个 Capacitor 包,支持任何运行在 Capacitor 内的 Web 框架,包括 Ionic、React、Vue、Angular、Svelte 和普通 JavaScript。

哪个 Capacitor 版本支持 @capgo/capacitor-navigation-bar?

Capgo 插件遵循 Capacitor 的主要版本:使用与 Capacitor 主要版本匹配的插件主要版本(例如插件 v8 与 Capacitor 8)。兼容性表格在 GitHub README 中列出。

@capgo/capacitor-navigation-bar 是否免费且开源?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-navigation-bar/ and the package is free to install from npm. Bug reports and pull requests are welcome.

是否可以在 App Store 审核时更新使用 Navigation Bar 的 code?

安装或升级插件会改变原生的 code,需要重新构建 App Store。之后,JavaScript、HTML 和 CSS 调用插件的更改可以立即通过 Capgo 实时更新发布。

无需等待应用程序审查即可将导航栏更改发送

一旦插件在您的商店构建中,Capgo 即刻将您的 JavaScript、HTML 和 CSS 更改推送给用户。

开始使用 Capgo