GlobalEventHandlers.oncontextmenu

An event handler property for right-click events on the window. Unless the default behavior is prevented (see examples below on how to do this), the browser context menu will activate (though IE8 has a bug with this and will not activate the context menu if a contextmenu event handler is defined). Note that this event will occur with any non-disabled right-click event and does not depend on an element possessing the "contextmenu" attribute.

Syntax

window.oncontextmenu = funcRef;
//funcRef refers to the function to be called

Example

These examples will disable right click on the page:

document.oncontextmenu = function () { // Use document as opposed to window for IE8 compatibility
   return false;
};

window.addEventListener('contextmenu', function (e) { // Not compatible with IE < 9
    e.preventDefault();
}, false);

Specifications

Specification Status Comment
WHATWG HTML Living Standard
The definition of 'oncontextmenu' in that specification.
Living Standard  

Document Tags and Contributors

 Last updated by: cvrebert,