document.popupNode

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 popupshown 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" onclick="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 .