cordova-plugin-backbutton

一个为 Apache Cordova 应用提供灵活、可扩展 的硬件返回按钮事件处理插件，解决原生 backbutton 事件的优先级混乱、拦截不便等问题。

🌟 核心特性

• 简洁 API：onBackButton/offBackButton 替代原生事件绑定，降低使用成本

• 精准拦截：回调返回 true 即可阻断事件冒泡，灵活控制默认行为（退出应用 / 页面后退）

• 优先级排序：支持自定义事件执行顺序，确保关键逻辑（如模态框关闭）优先响应

• 无重复注册：自动去重相同回调函数，避免内存泄漏和逻辑冲突

• 跨平台兼容：iOS 无硬件返回键场景下安全安装，不影响应用打包

• TypeScript 友好：完整类型定义，开发时提供类型提示

📦 安装方式

常用安装

# 安装hcordova
npm install -g hcordova
hcordova plugin add cordova-plugin-backbutton

从 GitCode 安装

hcordova plugin add https://gitcode.com/OpenHarmon-Cordova/cordova-plugin-backbutton.git --platform ohos

快速上手

//返回桌面
function setAppGoHome() {
    navigator.Backbutton.goHome(function() {
        console.log('success')
    }, function() {
        console.log('fail')
    });
}

//返回上一页
function setAppGoBack() {
    navigator.Backbutton.goBack(function() {
        console.log('success')
    }, function() {
        console.log('fail')
    });
}

许可证

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

联系方式

HarmonyOS Cordova https://gitcode.com/OpenHarmony-Cordova/cordova-plugin-backbutton

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