@chefslist/capacitor-android-navigation-bar-info

中文文档
0.0.2发布于 2025/10/31Apache License, Version 2.0, January 2004TypeScriptESM + CJS零依赖近 30 天下载 1870

Android 获得导航条高、能见度和手势导航模式的电容插件

中文使用文档
文档目录9 节
  1. 安装
  2. 使用量
  3. 获取导航栏信息
  4. 听取导航栏更改
  5. API 密码
  6. 获取Navigation BarInfo ()
  7. 添加聆听器( “ 导航BarInfoChanged ” ,...)
  8. 删除所有收听器( )
  9. 接口

电容器和机器人导航

Android 的 Capacittor 插件, 提供有关导航栏的信息, 如导航栏高度、 手势导航模式等

安装

npm install @chefslist/capacitor-android-navigation-bar-info
npx cap sync

使用量

获取导航栏信息

import { NavigationBarInfo } from '@chefslist/capacitor-android-navigation-bar-info';

const info = await NavigationBarInfo.getNavigationBarInfo();
console.log('Navigation bar height:', info.heightInDp);
console.log('Device height:', info.deviceHeight);
console.log('Is visible:', info.isNavigationBarVisible);
console.log('Is gesture navigation:', info.isGestureNavigation);

听取导航栏更改

插件在导航栏信息变化时自动检测(例如,在Android 15+上的窗口模式和全屏模式之间切换时):

import { NavigationBarInfo } from '@chefslist/capacitor-android-navigation-bar-info';

// Add listener for navigation bar changes
await NavigationBarInfo.addListener('navigationBarInfoChanged', (info) => {
  console.log('Navigation bar info changed:', info);
  // Update your UI based on new navigation bar dimensions
});

// Don't forget to remove listeners when component unmounts
await NavigationBarInfo.removeAllListeners();

API 密码

获取Navigation BarInfo ()

getNavigationBarInfo() => Promise<NavigationBarInfo>

回返情况: Promise<NavigationBarInfo>


添加聆听器( “ 导航BarInfoChanged ” ,...)

addListener(eventName: 'navigationBarInfoChanged', listenerFunc: (info: NavigationBarInfo) => void) => Promise<PluginListenerHandle>

听取导航栏信息更改( 例如, 在窗口模式和全屏模式之间切换时)

参数类型
eventName'navigationBarInfoChanged'
listenerFunc(info: NavigationBarInfo) => void

回返情况: Promise<PluginListenerHandle>


删除所有收听器( )

removeAllListeners() => Promise<void>

删除此插件的所有听众


接口

导航列信息

Prop类型
heightInDpnumber
deviceHeightnumber
densitynumber
isNavigationBarVisibleboolean
isGestureNavigationboolean

插件听筒

Prop类型
remove() => Promise<void>

版本与发布记录

@chefslist/capacitor-android-navigation-bar-info 共发布 2 个版本,首次发布于 2025/10/08;过去 12 个月发布了 0 个版本。

版本发布日期距今
0.0.2latest2025/10/311 年前
0.0.12025/10/081.1 年前

关于 @chefslist/capacitor-android-navigation-bar-info 的常见问题

@chefslist/capacitor-android-navigation-bar-info 是什么?

Android 获得导航条高、能见度和手势导航模式的电容插件

如何安装 @chefslist/capacitor-android-navigation-bar-info?

在项目目录运行 npm install @chefslist/capacitor-android-navigation-bar-info,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@capacitor/core(>=7.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@chefslist/capacitor-android-navigation-bar-info 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@chefslist/capacitor-android-navigation-bar-info 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@chefslist/capacitor-android-navigation-bar-info 可以商用吗?

@chefslist/capacitor-android-navigation-bar-info 使用 Apache License, Version 2.0, January 2004 许可。声明的许可为 Apache License, Version 2.0, January 2004,请阅读许可原文确认使用条件。以上为概括,不构成法律意见,请以许可原文为准。

@chefslist/capacitor-android-navigation-bar-info 的下载量有多少?

根据 npm 官方下载统计,@chefslist/capacitor-android-navigation-bar-info 在 2026/10/10 – 2026/11/08 这 30 天内被下载 1,870 次,日均约 62 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@chefslist/capacitor-android-navigation-bar-info 还在维护吗?

最新版本 0.0.2 发布于 2025/10/31(1 年前);至今共发布 2 个版本,其中过去 12 个月发布了 0 个;首次发布于 2025/10/08。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。