{"_id":"@cordova-ohos/cordova-plugin-dialogs","_rev":"5-75bff599c0ee496b9a22a97fdce34332","name":"@cordova-ohos/cordova-plugin-dialogs","dist-tags":{"latest":"2.0.3"},"versions":{"2.0.2":{"name":"@cordova-ohos/cordova-plugin-dialogs","version":"2.0.2","keywords":["cordova","dialogs","ecosystem:cordova","cordova-openharmony"],"author":{"name":"Huawei Device, Inc. Ltd. and","email":"马弓手"},"license":"Apache-2.0","_id":"@cordova-ohos/cordova-plugin-dialogs@2.0.2","maintainers":[{"name":"luqi_tan","email":"295099422@qq.com"}],"bugs":{"url":"https://gitcode.com/OpenHarmony-Cordova/cordova-plugin-dialogs/issues"},"dist":{"shasum":"ea19ed6278ba445c256428ab7a0f8fc5c3ac93b4","tarball":"https://registry.npmjs.org/@cordova-ohos/cordova-plugin-dialogs/-/cordova-plugin-dialogs-2.0.2.tgz","fileCount":10,"integrity":"sha512-W3x106RAgloIjY+ToM0BAiJa6MGgop7+sgjo25MUxj4hmOoDLYXNr+1+lbKQqJZcGmCAwApjLC+0uNX3M0SMew==","signatures":[{"sig":"MEUCIQDFxxFGfPMidCLKoL3rgwhjxQiKUQjOeptiXOzgtAXPXwIgT8OQiteeghulGNTtoukkueclFyvjmuuBTNvaH1JWh1o=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":61457},"cordova":{"id":"cordova-plugin-dialogs","platforms":["ohos"]},"engines":{"cordovaDependencies":{"2.0.2":{"hcordova":">=1.0.0","@cordova-ohos/ohos":">=2.0.0"}}},"gitHead":"0033ccb490cc4971ec19e34e53c5fb84700a0da9","_npmUser":{"name":"luqi_tan","email":"295099422@qq.com"},"repository":{"url":"gitcode:OpenHarmony-Cordova/cordova-plugin-dialogs","type":"git"},"_npmVersion":"10.5.1","description":"Cordova dialogs Plugin","directories":{},"_nodeVersion":"22.0.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cordova-plugin-dialogs_2.0.2_1773827183041_0.5906289881726967","host":"s3://npm-registry-packages-npm-production"}},"2.0.3":{"name":"@cordova-ohos/cordova-plugin-dialogs","version":"2.0.3","description":"Cordova dialogs Plugin","cordova":{"id":"cordova-plugin-dialogs","platforms":["ohos"]},"repository":{"type":"git","url":"gitcode:CPF-Cordova/cordova-plugin-dialogs"},"bugs":{"url":"https://gitcode.com/CPF-Cordova/cordova-plugin-dialogs/issues"},"keywords":["cordova","dialogs","ecosystem:cordova","cordova-openharmony"],"engines":{"cordovaDependencies":{"2.0.3":{"@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-dialogs@2.0.3","gitHead":"f0baedeba4b118efe408d8cf5ff184ea6da761af","_nodeVersion":"22.0.0","_npmVersion":"10.5.1","dist":{"integrity":"sha512-v/zzTo4pfR67lbvbL31/UgMlaBqybjWosmbLDCHCMCLW50vFz+9NX0cZoEqqaN36AiDRiXUqCZNTE09xXH6mJg==","shasum":"2863204f8a6bf4bfda9b738bd99c21065624b578","tarball":"https://registry.npmjs.org/@cordova-ohos/cordova-plugin-dialogs/-/cordova-plugin-dialogs-2.0.3.tgz","fileCount":11,"unpackedSize":87822,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCID/wAePmaaOZ8z+vOUnSAM2/GOxfAMi33lsiI9tgJTdvAiEAypfjqmlCFZG/P6r+sQci2zpKEClPXbRytZT9gI3Px9Q="}]},"_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-dialogs_2.0.3_1785141327635_0.02914992177703346"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-18T09:46:22.924Z","modified":"2026-07-27T08:35:28.063Z","2.0.2":"2026-03-18T09:46:23.185Z","2.0.3":"2026-07-27T08:35:27.777Z"},"bugs":{"url":"https://gitcode.com/CPF-Cordova/cordova-plugin-dialogs/issues"},"author":{"name":"Huawei Device, Inc. Ltd. and","email":"马弓手"},"license":"Apache-2.0","keywords":["cordova","dialogs","ecosystem:cordova","cordova-openharmony"],"repository":{"type":"git","url":"gitcode:CPF-Cordova/cordova-plugin-dialogs"},"description":"Cordova dialogs 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":"# cordova-plugin-dialogs\r\n\r\n[](README.md)\r\n[](README.en.md)\r\n\r\n本项目基于 [cordova-plugin-dialogs@2.0.2](https://www.npmjs.com/package/cordova-plugin-dialogs/v/2.0.2) 开发，本文档重点阐述其在 OpenHarmony（OHOS）系统中的具体应用。\r\n\r\n- [cordova-plugin-dialogs](#cordova-plugin-dialogs)\r\n - [简介](#简介)\r\n - [支持平台](#支持平台)\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 - [兼容性](#兼容性)\r\n - [使用示例](#使用示例)\r\n - [示例 1：警告框（Alert）](#示例-1警告框alert)\r\n - [示例 2：确认框（Confirm）](#示例-2确认框confirm)\r\n - [示例 3：输入框（Prompt）](#示例-3输入框prompt)\r\n - [示例 4：嘟嘟提示音（Beep）](#示例-4嘟嘟提示音beep)\r\n - [完整示例项目](#完整示例项目)\r\n - [使用说明](#使用说明)\r\n - [核心 API 说明](#核心-api-说明)\r\n - [4.1 警告框（Alert）](#41-警告框alert)\r\n - [4.2 确认框（Confirm）](#42-确认框confirm)\r\n - [4.3 输入框（Prompt）](#43-输入框prompt)\r\n - [4.4 嘟嘟提示音（Beep）](#44-嘟嘟提示音beep)\r\n - [目录结构](#目录结构)\r\n - [贡献代码](#贡献代码)\r\n - [许可证](#许可证)\r\n - [官方资源](#官方资源)\r\n\r\n## 简介\r\n\r\n`cordova-plugin-dialogs` 是一款专为 Apache Cordova/PhoneGap 应用设计的对话框插件，旨在帮助开发者快速实现跨平台的系统级对话框功能。通过该插件，开发者无需关注不同平台对话框的原生实现差异，即可轻松调用警告框、确认框、输入框和嘟嘟声等常用交互组件，为用户提供统一且符合平台设计规范的交互体验，本文档主要说明该插件在 OHOS 系统中的应用。\r\n\r\n该插件完全遵循 Cordova 插件开发标准，API 设计简洁直观，支持多平台自适应，可无缝集成到各类 Cordova 移动应用中，适用于消息提示、用户确认、信息输入等多种业务场景。\r\n\r\n- 跨平台统一：无需关注各平台原生实现差异，API 调用方式统一，适配 OHOS、Android、iOS 等多平台\r\n\r\n- 功能丰富：支持警告框、确认框、输入框、嘟嘟提示音等常用交互组件，覆盖多种业务场景\r\n\r\n- 易用便捷：API 设计简洁，支持回调函数处理用户交互结果，集成门槛低\r\n\r\n- 平台适配：贴合各平台设计规范，对话框样式自适应，提升用户体验\r\n\r\n- 轻量高效：插件体积小，无冗余依赖，不影响应用运行性能\r\n\r\n## 支持平台\r\n\r\n- **Android**：API 级别 21 及以上（覆盖 Android 5.0 及更高版本）\r\n\r\n- **iOS**：iOS 10.0 及以上，支持 iPhone、iPad 等全系列 iOS 设备\r\n\r\n- **Windows**：Windows 10 及以上，包含 UWP 通用应用场景\r\n\r\n- **Browser**：主流桌面及移动浏览器（如 Chrome、Firefox、Safari、Edge 等）\r\n\r\n- **OHOS**：5.0+（本文档重点说明该平台使用）\r\n\r\n## 下载安装\r\n\r\n通过 hcordova CLI 即可快速安装插件，支持直接安装、指定 OHOS 平台安装及从 GitCode 源码安装，安装前需确保满足前置环境要求并创建 Cordova 项目。\r\n\r\n### 前提条件\r\n\r\n在安装插件前，请确保开发环境满足以下基础要求：\r\n\r\n- 已安装 Node.js（v14.0.0 及以上）和 npm（v6.0.0 及以上），可通过 `node -v` 和 `npm -v` 命令验证版本。\r\n\r\n- 已全局安装 Cordova CLI（v10.0.0 及以上），若未安装，可执行命令：`npm install -g hcordova`\r\n\r\n- 已创建 Cordova 项目（若尚未创建，可通过 `hcordova create MyDialogApp com.example.dialogapp 对话框示例应用` 命令快速创建项目）。\r\n\r\n## 安装方式\r\n\r\n### 从 npm 安装（推荐）\r\n\r\n```bash\r\n# 使用 hcordova CLI 安装\r\n# 安装 hcordova 命令化工具\r\nnpm install -g hcordova\r\n\r\n# 全平台安装插件（推荐稳定版）\r\nhcordova plugin add cordova-plugin-dialogs\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-dialogs --platform ohos\r\n```\r\n\r\n### 从 GitCode 仓库安装\r\n\r\n仅为 OHOS 平台安装插件（获取最新开发版）：\r\n\r\n```bash\r\n# 仅安装到 OHOS 平台\r\nhcordova plugin add https://gitcode.com/CPF-Cordova/cordova-plugin-dialogs.git --platform ohos\r\n\r\n# 指定标签/分支安装\r\nhcordova plugin add https://gitcode.com/CPF-Cordova/cordova-plugin-dialogs.git@develop --platform ohos\r\n```\r\n\r\n### 安装指定版本\r\n\r\n```bash\r\n# 仅安装到 OHOS 平台指定版本\r\nhcordova plugin add cordova-plugin-dialogs@1.0.0 --platform ohos\r\n```\r\n\r\n### 离线安装（本地包）\r\n\r\n适用于无网络环境，先下载插件包到本地，再执行离线安装：\r\n\r\n```bash\r\n# 下载插件包到本地（示例路径：~/Downloads/cordova-plugin-dialogs）\r\n# 执行离线安装\r\nhcordova plugin add ~/Downloads/cordova-plugin-dialogs --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-dialogs \r\n\r\n# 指定平台卸载\r\nhcordova plugin remove cordova-plugin-dialogs --platform ohos\r\n\r\n```\r\n\r\n### 插件验证\r\n\r\n安装完成后，可通过以下命令验证插件是否成功添加到项目中：\r\n\r\n```bash\r\nhcordova plugin list\r\n\r\n```\r\n\r\n若输出结果包含 `cordova-plugin-dialogs`，则表示插件已成功安装。\r\n\r\n## 约束与限制\r\n\r\n* 依赖插件：无强制依赖，插件集成后可直接使用，无需额外配置\r\n\r\n* 调用时机：所有 API 需在 `deviceready` 事件触发后调用，避免因原生接口未初始化导致错误\r\n\r\n* 平台差异：部分对话框样式（如标题显示、按钮布局）会随平台原生规范略有差异，不影响核心功能使用\r\n\r\n* 输入限制：输入框仅支持文本输入，不支持密码隐藏、格式校验等高级功能，需开发者自行实现\r\n\r\n* 嘟嘟提示音：仅部分设备支持，不同设备的提示音音量、音色可能存在差异\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### 示例 1：警告框（Alert）\r\n\r\n用于向用户展示纯提示性信息，仅包含“确认”按钮，适用于告知用户操作结果、系统通知等场景。\r\n\r\n```js\r\n// 等待 Cordova 环境就绪\r\ndocument.addEventListener('deviceready', function() {\r\n // 显示警告框\r\n navigator.notification.alert(\r\n '操作已成功完成！\\n请返回首页继续操作', // 提示内容（支持换行）\r\n function() {\r\n console.log('用户已确认警告信息');\r\n // 此处可添加确认后的逻辑，如跳转页面\r\n // window.location.href = 'index.html';\r\n }, // 回调函数\r\n '操作成功', // 对话框标题\r\n '确定' // 按钮文本\r\n );\r\n}, false);\r\n\r\n```\r\n\r\n### 示例 2：确认框（Confirm）\r\n\r\n用于获取用户的二元选择（如“确认/取消”），包含多个按钮，适用于删除操作确认、权限申请确认等场景。\r\n\r\n```js\r\ndocument.addEventListener('deviceready', function() {\r\n // 显示确认框（删除操作确认）\r\n navigator.notification.confirm(\r\n '确定要删除该条数据吗？删除后无法恢复！', // 提示内容\r\n function(buttonIndex) {\r\n // buttonIndex 为用户点击的按钮索引（0：第一个按钮，1：第二个按钮）\r\n if (buttonIndex === 1) {\r\n console.log('用户选择：确定删除');\r\n // 执行删除逻辑\r\n // deleteData();\r\n } else {\r\n console.log('用户选择：取消删除');\r\n }\r\n }, // 回调函数\r\n '删除确认', // 对话框标题\r\n ['确定', '取消'] // 按钮列表\r\n );\r\n}, false);\r\n\r\n```\r\n\r\n### 示例 3：输入框（Prompt）\r\n\r\n用于获取用户输入的文本信息，包含输入框和确认/取消按钮，适用于获取用户名、备注信息等场景。\r\n\r\n```js\r\ndocument.addEventListener('deviceready', function() {\r\n // 显示输入框（获取用户昵称）\r\n navigator.notification.prompt(\r\n '请输入您的昵称，将用于显示在个人主页', // 提示内容\r\n function(result) {\r\n // result 对象包含 buttonIndex 和 input1 两个属性\r\n console.log('用户点击的按钮索引：', result.buttonIndex);\r\n console.log('用户输入的昵称：', result.input1);\r\n if (result.buttonIndex === 1 && result.input1.trim() !== '') {\r\n alert('昵称设置成功：' + result.input1);\r\n // 保存昵称逻辑\r\n // saveNickname(result.input1);\r\n } else if (result.buttonIndex === 1) {\r\n alert('昵称不能为空，请重新输入');\r\n } else {\r\n alert('已取消昵称设置');\r\n }\r\n }, // 回调函数\r\n '设置昵称', // 对话框标题\r\n ['确认', '取消'], // 按钮列表\r\n '小明' // 输入框默认文本\r\n );\r\n}, false);\r\n\r\n```\r\n\r\n### 示例 4：嘟嘟提示音（Beep）\r\n\r\n用于设置设备响铃次数，适用于需要声音提示的场景。\r\n\r\n```js\r\ndocument.addEventListener('deviceready', function() {\r\n // 响铃 1 次\r\n navigator.notification.beep(1);\r\n // 响铃 3 次（间隔响铃）\r\n // navigator.notification.beep(3);\r\n}, false);\r\n\r\n```\r\n\r\n### 完整示例项目\r\n\r\n以下是一个包含所有对话框功能的完整 Cordova 页面示例，可直接复制到项目的 `www/index.html` 文件中使用：\r\n\r\n```html\r\n\r\n\r\n\r\n \r\n \r\n cordova-plugin-dialogs 示例\r\n \r\n \r\n \r\n\r\n\r\n\r\n 对话框插件示例
\r\n \r\n \r\n \r\n\r\n\r\n\r\n```\r\n\r\n## 使用说明\r\n\r\n### 核心 API 说明\r\n\r\n插件通过全局对象 `navigator.notification` 暴露所有对话框相关 API，所有方法均支持回调函数，便于处理用户交互结果。以下是各核心功能的详细说明：\r\n\r\n#### 4.1 警告框（Alert）\r\n\r\n用于向用户展示纯提示性信息，仅包含“确认”按钮，用户点击后关闭对话框，适用于告知用户操作结果、系统通知等场景。\r\n\r\n方法签名：`navigator.notification.alert(message, alertCallback, title, buttonName);`\r\n\r\n| **参数名** | **类型** | **是否必选** | **说明** |\r\n|---|---|---|---|\r\n| message | String | 是 | 对话框中显示的提示内容，支持换行符（`\\n`）实现多行文本。 |\r\n| alertCallback | Function | 否 | 用户点击确认按钮后的回调函数，无参数，仅用于执行后续逻辑。 |\r\n| title | String | 否 | 对话框标题，默认值为“Alert”（不同平台可能有差异，如 iOS 默认无标题）。 |\r\n| buttonName | String | 否 | 确认按钮文本，默认值为“OK”。 |\r\n#### 4.2 确认框（Confirm）\r\n\r\n用于获取用户的二元选择（如“是/否”“确认/取消”），包含多个按钮，用户点击后通过回调函数返回选择结果，适用于删除操作确认、权限申请确认等场景。\r\n\r\n方法签名：`navigator.notification.confirm(message, confirmCallback, title, buttonLabels);`\r\n\r\n| **参数名** | **类型** | **是否必选** | **说明** |\r\n|---|---|---|---|\r\n| message | String | 是 | 对话框提示内容，支持多行文本。 |\r\n| confirmCallback | Function | 是 | 用户点击按钮后的回调函数，参数为用户选择的按钮索引（从 0 开始）。 |\r\n| title | String | 否 | 对话框标题，默认值为“Confirm”。 |\r\n| buttonLabels | Array/String | 否 | 按钮文本列表，可传入字符串（逗号分隔，如“确定，取消”）或数组（如 [\"确定\",\"取消\"]），默认值为 [\"OK\", \"Cancel\"]。 |\r\n#### 4.3 输入框（Prompt）\r\n\r\n用于获取用户输入的文本信息，包含输入框和确认/取消按钮，用户提交后通过回调函数返回输入内容，适用于获取用户名、备注信息等场景。\r\n\r\n方法签名：`navigator.notification.prompt(message, promptCallback, title, buttonLabels, defaultText);`\r\n\r\n| **参数名** | **类型** | **是否必选** | **说明** |\r\n|---|---|---|---|\r\n| message | String | 是 | 输入提示文本，告知用户需输入的内容类型。 |\r\n| promptCallback | Function | 是 | 用户操作后的回调函数，参数为包含 `buttonIndex`（按钮索引）和 `input1`（输入内容）的对象。 |\r\n| title | String | 否 | 对话框标题，默认值为“Prompt”。 |\r\n| buttonLabels | Array/String | 否 | 按钮文本列表，默认值为 [\"OK\", \"Cancel\"]。 |\r\n| defaultText | String | 否 | 输入框默认填充文本，适用于预填默认值（如常用用户名）。 |\r\n#### 4.4 嘟嘟提示音（Beep）\r\n\r\n用于设置设备响铃次数，提供声音提示功能。\r\n\r\n方法签名：`navigator.notification.beep(count);`\r\n\r\n| **参数名** | **类型** | **是否必选** | **说明** |\r\n|---|---|---|---|\r\n| count | Number | 是 | 响铃次数，1=响一次，2=响二次，n=响 n 次。 |\r\n## 目录结构\r\n\r\n```\r\ncordova-plugin-dialogs/\r\n├── src/ # 源代码目录\r\n│ └── main/ # 主要源代码\r\n│ ├── cpp/ # C++ 原生代码\r\n│ │ └── Notification/ # 通知模块\r\n│ │ ├── Notification.cpp # 通知弹窗功能的 C++ 实现\r\n│ │ └── Notification.h # 通知弹窗功能的头文件\r\n│ └── ets/ # ArkTS 代码（OpenHarmony API）\r\n│ └── components/ # 组件目录\r\n│ └── AlertDialog/ # 弹窗组件\r\n│ └── NotificationAlert.ets # 通知弹窗的 ArkTS 实现\r\n├── www/ # Web 资源目录\r\n│ └── harmony/ # OHOS 相关资源\r\n│ └── notification.js # JavaScript 通知弹窗接口（Cordova 桥接层）\r\n├── .gitignore # Git 忽略文件配置\r\n├── LICENSE # 项目开源许可证\r\n├── OAT.xml # OpenHarmony 审核配置文件\r\n├── package.json # Node.js 包配置\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-dialogs/issues) ，当然也非常欢迎发 [PR](https://gitcode.com/CPF-Cordova/cordova-plugin-dialogs/pulls) 共建。\r\n\r\n## 许可证\r\n\r\n本插件基于 **Apache License 2.0** 开源协议发布，详细许可条款请查看项目根目录下的 [LICENSE](LICENSE) 文件。\r\n\r\n## 官方资源\r\n\r\n- GitCode 仓库：[https://gitcode.com/CPF-Cordova/cordova-plugin-dialogs](https://gitcode.com/CPF-Cordova/cordova-plugin-dialogs)\r\n\r\n- Apache Cordova（Android/iOS）官方论坛：[https://cordova.apache.org/community/](https://cordova.apache.org)\r\n","readmeFilename":"README.md"}