[CB-10805] menubutton event is not correctly documented

• Type: Bug
• Status: Open
• Priority: Minor
• Resolution: Unresolved
• Component/s: cordova-android, cordova-docs
• Assignee: jcesarmobile
• Reporter: jcesarmobile
• Created: 08/Mar/16 07:56
• Updated: 14/Jul/17 16:58

Description

This is the doc for menubutton

menubutton

The event fires when the user presses the menu button. Applying an event handler overrides the default menu button behavior.
Quick Example

document.addEventListener("menubutton", onMenuKeyDown, false);

function onMenuKeyDown() {
// Handle the back button
}

But menubutton event was broken on android. (See CB-9949)

When fixed, a change was introduced, to make the menubutton work, now it's required to add this line:

navigator.app.overrideButton("menubutton", true);  

But that is not documented anywhere.

I think it should be added as an android quirk as it is supported by blackberry too and I don't think this is needed on blackberry devices.

Issue Links

• is related to: CB-9949 Menu button event not fired in Android