cordova-plugin-navigationbar

一款专为 Cordova 混合移动应用打造的导航栏控制插件，支持跨平台自定义设备导航栏的显示和隐藏等核心属性，助力开发者实现与应用风格统一的导航栏视觉效果，提升用户体验。

功能特性

• 灵活显示控制：支持导航栏的显示/隐藏切换，可设置临时隐藏或永久隐藏（需适配系统规则）

• 无依赖轻量设计：不依赖第三方UI库，插件体积小巧，对应用性能影响极小

安装方法

1. 基础安装（推荐）

适用于大多数场景，直接从 npm 仓库安装稳定版：

# 安装hcordova
npm install -g hcordova

# 安装最新稳定版插件
hcordova plugin add cordova-plugin-navigationbar --platform ohos

# 安装指定版本（示例：1.0.0 版本）
hcordova plugin add [email protected] --platform ohos

2. 从 GitCode 安装开发版

适用于需要体验最新功能的开发者，从 GitHub 仓库直接安装：

# 从 GitCode 安装（获取最新开发版）
hcordova plugin add https://gitcode.com/OpenHarmony-Cordova/cordova-plugin-navigationbar.git --platform ohos

4. 安装后验证

安装完成后，可通过以下命令验证插件是否安装成功：

# 查看已安装的插件列表
hcordova plugin list

# 若列表中显示 cordova-plugin-navigationbar 则安装成功

卸载方法

进入项目根目录，执行以下命令卸载插件，卸载后建议重新构建项目以清理残留的原生配置文件：

# 全平台卸载导航栏控制插件
hcordova plugin remove cordova-plugin-navigationbar

# 指定OHOS卸载
hcordova plugin remove cordova-plugin-navigationbar --platform ohos

API 参考

1. 显示导航栏（show）

显示隐藏的导航栏，若导航栏已显示则无效果。

NavigationBar.setUp(true,function(){
        console.log("设置成功");
});

2. 隐藏导航栏（hide）

隐藏当前显示的导航栏，沉浸式隐藏（全屏效果）。

NavigationBar.hide();

许可证

本插件基于 Apache License 开源，详见 LICENSE 文件。

联系方式

OHOS Cordova https://gitcode.com/OpenHarmony-Cordova/cordova-plugin-navigationbar

Android/iOS：https://npmjs.com/cordova-plugin-navigationbar/issues