{"_id":"@cordova-ohos/cordova-plugin-navigationbar","_rev":"3-e541a93b87eaaaf6a647f11838ad58aa","name":"@cordova-ohos/cordova-plugin-navigationbar","dist-tags":{"latest":"1.0.32"},"versions":{"1.0.31":{"name":"@cordova-ohos/cordova-plugin-navigationbar","version":"1.0.31","keywords":["cordova","navigationbar","ecosystem:cordova","cordova-openharmony"],"author":{"name":"Huawei Device, Inc. Ltd. and","email":"马弓手"},"license":"Apache-2.0","_id":"@cordova-ohos/cordova-plugin-navigationbar@1.0.31","maintainers":[{"name":"luqi_tan","email":"295099422@qq.com"},{"name":"wanpengsz","email":"wanpengsz@163.com"},{"name":"xkh111","email":"xukaihui11@163.com"}],"bugs":{"url":"https://gitcode.com/OpenHarmony-Cordova/cordova-plugin-navigationbar/issues"},"dist":{"shasum":"0da8a8503fd386ab502d987bd744e75f70b3a56d","tarball":"https://registry.npmjs.org/@cordova-ohos/cordova-plugin-navigationbar/-/cordova-plugin-navigationbar-1.0.31.tgz","fileCount":5,"integrity":"sha512-UJ0f5h1YVaToXotje4zpZwf3S4vcFyIrvP7GnbszsexDOuCPVCjbUcHadjW7QXhs7djgv2bJ65qiRglXJajHIQ==","signatures":[{"sig":"MEYCIQDqPJyH0wEXm+wa/lptlrXFkcppIAee5AGRyWFD4t0n6QIhAOV/+JKNYze2ztnG/GEnnNlEOdgim0EsPz637/y1gPLA","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22009},"cordova":{"id":"cordova-plugin-navigationbar","platforms":["ohos"]},"engines":{"cordovaDependencies":{"1.0.31":{"hcordova":">=1.0.0","@cordova-ohos/ohos":">=2.0.0"}}},"gitHead":"4a02014d8250f58b6d2c533b6049fd41042e3d91","_npmUser":{"name":"wanpengsz","email":"wanpengsz@163.com"},"repository":{"url":"gitcode:OpenHarmony-Cordova/cordova-plugin-navigationbar","type":"git"},"_npmVersion":"9.6.2","description":"Cordova alipay Plugin","directories":{},"_nodeVersion":"20.16.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cordova-plugin-navigationbar_1.0.31_1773997202441_0.9899825188984195","host":"s3://npm-registry-packages-npm-production"}},"1.0.32":{"name":"@cordova-ohos/cordova-plugin-navigationbar","version":"1.0.32","description":"Cordova Navigationbar Plugin","cordova":{"id":"cordova-plugin-navigationbar","platforms":["ohos"]},"repository":{"type":"git","url":"gitcode:CPF-Cordova/cordova-plugin-navigationbar"},"bugs":{"url":"https://gitcode.com/CPF-Cordova/cordova-plugin-navigationbar/issues"},"keywords":["cordova","navigationbar","ecosystem:cordova","cordova-openharmony"],"engines":{"cordovaDependencies":{"1.0.32":{"@cordova-ohos/ohos":">=2.0.0","hcordova":">=1.0.0"}}},"author":{"name":"Huawei Device, Inc. Ltd. and","email":"马弓手"},"license":"Apache-2.0","_id":"@cordova-ohos/cordova-plugin-navigationbar@1.0.32","gitHead":"5d859f7a1f0e44b53324ce87213c620a34f6e983","_nodeVersion":"22.0.0","_npmVersion":"10.5.1","dist":{"integrity":"sha512-jxjYhWQUSN27T1qtDVmyZCtepXP5mepCDpCv6fNcnLQIgjTlEv809KpLAWmj+gr0wbxUmmY+N4aNXjC465eVyQ==","shasum":"53fe02b254324a61eb99ae70e2091a29b4ebba10","tarball":"https://registry.npmjs.org/@cordova-ohos/cordova-plugin-navigationbar/-/cordova-plugin-navigationbar-1.0.32.tgz","fileCount":6,"unpackedSize":34077,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQChuPI+QHvMWjk7mML6bhIly0Moqy2SQe/AORcTu5SrFwIgfQTKf/UPdoYHa2yT2swIoc4sA4tQlOJLE+9FqFZZhp4="}]},"_npmUser":{"name":"luqi_tan","email":"295099422@qq.com"},"directories":{},"maintainers":[{"name":"luqi_tan","email":"295099422@qq.com"},{"name":"wanpengsz","email":"wanpengsz@163.com"},{"name":"xkh111","email":"xukaihui11@163.com"},{"name":"hcordova","email":"chenlihuiabc@163.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cordova-plugin-navigationbar_1.0.32_1785161064307_0.38582742102904066"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-20T09:00:02.342Z","modified":"2026-07-27T14:04:24.655Z","1.0.31":"2026-03-20T09:00:02.594Z","1.0.32":"2026-07-27T14:04:24.458Z"},"bugs":{"url":"https://gitcode.com/CPF-Cordova/cordova-plugin-navigationbar/issues"},"author":{"name":"Huawei Device, Inc. Ltd. and","email":"马弓手"},"license":"Apache-2.0","keywords":["cordova","navigationbar","ecosystem:cordova","cordova-openharmony"],"repository":{"type":"git","url":"gitcode:CPF-Cordova/cordova-plugin-navigationbar"},"description":"Cordova Navigationbar Plugin","maintainers":[{"name":"luqi_tan","email":"295099422@qq.com"},{"name":"wanpengsz","email":"wanpengsz@163.com"},{"name":"xkh111","email":"xukaihui11@163.com"},{"name":"hcordova","email":"chenlihuiabc@163.com"}],"readme":"# <center>cordova-plugin-navigationbar</center>\r\n\r\n[![zh-CN](https://img.shields.io/badge/lang-中文-blue.svg)](README.md)\r\n[![en](https://img.shields.io/badge/lang-English-blue.svg)](README.en.md)\r\n\r\n本项目基于 [cordova-plugin-navigationbar@1.0.31](https://www.npmjs.com/package/cordova-plugin-navigationbar/v/1.0.31) 开发，本文档重点阐述其在 OpenHarmony（OHOS）系统中的具体应用。\r\n- [cordova-plugin-navigationbar](#cordova-plugin-navigationbar)\r\n  - [简介](#简介)\r\n  - [支持平台](#支持平台)\r\n  - [下载安装](#下载安装)\r\n    - [从 npm 安装（推荐）](#从-npm-安装推荐)\r\n    - [指定平台安装 ohos](#指定平台安装-ohos)\r\n    - [从 GitCode 仓库安装](#从-gitcode-仓库安装)\r\n    - [离线安装（本地包）](#离线安装本地包)\r\n    - [安装后验证](#安装后验证)\r\n    - [卸载](#卸载)\r\n  - [约束与限制](#约束与限制)\r\n    - [兼容性](#兼容性)\r\n  - [使用示例](#使用示例)\r\n    - [1. 显示导航栏](#1-显示导航栏)\r\n    - [2. 隐藏导航栏](#2-隐藏导航栏)\r\n  - [使用说明](#使用说明)\r\n    - [核心说明](#核心说明)\r\n  - [目录结构](#目录结构)\r\n  - [贡献代码](#贡献代码)\r\n  - [许可证](#许可证)\r\n  - [官方资源](#官方资源)\r\n\r\n\r\n## 简介\r\n\r\ncordova-plugin-navigationbar 是一款专为 Cordova 混合移动应用打造的导航栏控制插件，支持跨平台自定义设备导航栏的显示和隐藏等核心属性，助力开发者实现与应用风格统一的导航栏视觉效果，提升用户体验。\r\n\r\n- 灵活显示控制：支持导航栏的显示/隐藏切换，可设置临时隐藏或永久隐藏（需适配系统规则）\r\n\r\n- 无依赖轻量设计：不依赖第三方 UI 库，插件体积小巧，对应用性能影响极小\r\n\r\n## 支持平台\r\n\r\n- **Android**：API 19 及以上（Android 4.4+）\r\n\r\n- **iOS**：10.0 及以上\r\n\r\n- **OHOS**：5.0+\r\n\r\n## 下载安装\r\n\r\n通过 hcordova CLI 即可快速安装插件，支持从 npm 仓库或 GitCode 仓库获取。\r\n\r\n### 从 npm 安装（推荐）\r\n\r\n```bash\r\n# 使用 hcordova CLI 安装\r\n\r\n# 安装 hcordova 命令化工具\r\nnpm install -g hcordova\r\n\r\n# 全平台安装插件\r\nhcordova plugin add cordova-plugin-navigationbar\r\n```\r\n\r\n### 指定平台安装 ohos\r\n\r\n仅为 OHOS 平台安装插件：\r\n\r\n```bash\r\n# 仅安装到 OHOS 平台\r\nhcordova plugin add cordova-plugin-navigationbar --platform ohos\r\n\r\n# 指定版本安装\r\nhcordova plugin add cordova-plugin-navigationbar@1.0.0 --platform ohos\r\n```\r\n\r\n### 从 GitCode 仓库安装\r\n\r\n仅为 OHOS 平台安装插件：\r\n\r\n```bash\r\n# 仅安装到 OHOS 平台\r\n\r\n# 默认分支安装\r\nhcordova plugin add https://gitcode.com/CPF-Cordova/cordova-plugin-navigationbar.git --platform ohos\r\n\r\n# 指定标签/分支安装\r\nhcordova plugin add https://gitcode.com/CPF-Cordova/cordova-plugin-navigationbar.git@develop --platform ohos\r\n```\r\n\r\n### 离线安装（本地包）\r\n\r\n适用于无网络环境，先下载插件包到本地，再执行离线安装：\r\n\r\n```bash\r\n# 下载插件包到本地（示例路径：~/Downloads/cordova-plugin-navigationbar）\r\n# 执行离线安装\r\nhcordova plugin add ~/Downloads/cordova-plugin-navigationbar --platform ohos\r\n```\r\n\r\n### 安装后验证\r\n\r\n安装完成后，可通过以下命令验证插件是否成功添加到项目中：\r\n\r\n```bash\r\n# 查看已安装的插件列表，若包含本插件 ID 则表示插件已成功安装\r\nhcordova plugin list\r\n```\r\n\r\n### 卸载\r\n\r\n```bash\r\n# Cordova CLI 全平台卸载\r\nhcordova plugin remove cordova-plugin-navigationbar \r\n\r\n# 指定平台卸载\r\nhcordova plugin remove cordova-plugin-navigationbar --platform ohos\r\n```\r\n\r\n## 约束与限制\r\n\r\n本插件强制依赖于 `cordova-plugin-navigationbar-color` 插件，具体功能由 `cordova-plugin-navigationbar-color` 插件实现\r\n\r\n### 兼容性\r\n\r\n支持：\r\n\r\n| 项目 | 版本/信息 |\r\n|-----|--------|\r\n| SDK | API12+ |\r\n| IDE | DevEco Studio: 5.0+ |\r\n| ROM | 5.1+ |\r\n| Emulator | OpenHarmony 6.0+ |\r\n\r\n在以下版本中已测试通过：\r\n\r\n| 项目 | 版本/信息 |\r\n|-----|--------|\r\n| @cordova-ohos/ohos | 14.0.1-ohos-14.0.1 |\r\n| SDK | 5.0.0(12) |\r\n| IDE | DevEco Studio: 6.0.13.200 |\r\n| ROM | 5.1.0.120 SP3 |\r\n| Emulator | OpenHarmony 6.0.1(21) |\r\n\r\n## 使用示例\r\n\r\n插件暴露全局对象 `window.NavigationBar`，所有方法均支持回调函数语法，以下为核心功能的使用示例，可直接复制到项目中使用。\r\n\r\n### 1. 显示导航栏\r\n\r\n显示隐藏的导航栏，若导航栏已显示则无效果。\r\n\r\n```javascript\r\nNavigationBar.setUp(true,function(){\r\n        console.log(\"设置成功\");\r\n});\r\n```\r\n\r\n### 2. 隐藏导航栏\r\n\r\n隐藏当前显示的导航栏，实现沉浸式全屏效果。\r\n\r\n```javascript\r\nNavigationBar.hide();\r\n```\r\n\r\n## 使用说明\r\n\r\n### 核心说明\r\n1. 插件调用：所有 API 均通过全局对象 `window.NavigationBar` 调用，无需额外引入，直接调用对应方法即可。\r\n2. 功能说明：setUp(true) 用于显示导航栏，hide() 用于隐藏导航栏，适配系统原生导航栏规则，临时隐藏后切换页面可能恢复显示，永久隐藏需遵循对应系统规则。\r\n3. 权限说明：插件无需额外申请权限，自动适配系统导航栏控制权限，无需手动编写权限申请代码。\r\n4. 错误处理：API 调用失败时，可通过回调函数查看错误信息，便于问题排查。\r\n\r\n## 目录结构\r\n\r\n```\r\ncordova-plugin-navigationbar  # [根目录] 导航栏插件项目根目录\r\n├── .gitignore                # [Git 配置] 指定 Git 版本控制中需要忽略的文件和目录\r\n├── LICENSE                   # [许可证] 项目的开源协议或版权声明\r\n├── OAT.xml                   # [门禁配置] 开源审查配置\r\n├── package.json              # [NPM 配置] 项目元数据，包含版本、依赖等信息\r\n├── plugin.xml                # [Cordova 配置] 核心配置文件，定义插件如何修改配置文件或注入逻辑\r\n└── README.md                 # [说明文档] 项目的使用说明和功能介绍\r\n```\r\n\r\n## 贡献代码\r\n\r\n使用过程中发现任何问题都可以提 [Issue](https://gitcode.com/CPF-Cordova/cordova-plugin-navigationbar/issues) ，当然也非常欢迎发 [PR](https://gitcode.com/CPF-Cordova/cordova-plugin-navigationbar/pulls) 共建。\r\n\r\n## 许可证\r\n\r\n本插件基于 **Apache License 2.0** 开源，详见 [LICENSE](LICENSE) 文件。\r\n\r\n## 官方资源\r\n\r\nOHOS Cordova [https://gitcode.com/CPF-Cordova/cordova-plugin-navigationbar](https://gitcode.com/CPF-Cordova/cordova-plugin-navigationbar)\r\n\r\nAndroid/iOS：[https://npmjs.com/cordova-plugin-navigationbar/issues](https://npmjs.com/cordova-plugin-navigationbar/issues)\r\n","readmeFilename":"README.md"}