document.popupNode

« DOM Reference

Deprecated
This feature has been removed from the Web. Though some browsers may still support it, it is in the process of being dropped. Do not use it in old or new projects. Pages or Web apps using it may break at any time.

Note: Starting with Gecko 2.0, authors are encouraged to use the menupopup property triggerNode instead.

Summary

When a popup attached via the popup or context attributes is opened, the XUL document's popupNode property is set to the node that was clicked on. This will be the target of the mouse event that activated the popup. If the popup was opened via the keyboard, the popup node may be set to null. Typically, this property will be checked during a popupshowing event handler for a context menu to initialize the menu based on the context.

This property is only set for popups attached via the popup or context attributes. For other types of popups, the value is not changed. In these other cases, for example when calling the popup's showPopup method, you may wish to set the popupNode property directly beforehand.

This property applies only to XUL documents.

Usage

var node = document.popupNode;

Example

<menupopup id="toolbarContextMenu">
  ...
  <menuitem name="Delete" oncommand="mailNewsCore.deleteButton(document.popupNode)">
  ...
</menupopup>

See http://www.mozilla.org/xpfe/xptoolkit/popups.html

Specification

XUL-specific method. Not part of any specification. Defined in nsIDOMXULDocument.idl.

Document Tags and Contributors

Contributors to this page: Sheppy, SylvainPasche, Enn, gurdev_singh, Nickolay, kscarfone, Waldo, Neil
Last updated by: kscarfone,
Hide Sidebar