dijit/Menu.js

• Provides:

  • dijit.Menu

• Requires:

  • dojo.window in common
  • dijit._Widget in common
  • dijit._KeyNavContainer in common
  • dijit._Templated in common
  • dijit.MenuItem in common
  • dijit.PopupMenuItem in common
  • dijit.CheckedMenuItem in common
  • dijit.MenuSeparator in common

• dijit._MenuBase

  • type

    Function

  • chains:
    • dijit._Widget: (prototype)
    • dijit._Templated.prototype: (prototype)
    • dijit._KeyNavContainer.prototype: (prototype)
    • dijit._Widget: (call)
    • dijit._Templated: (call)
    • dijit._KeyNavContainer: (call)
  • summary

    Base class for Menu and MenuBar

• dijit._MenuBase.parentMenu

  • tags: readonly
  • type

    Widget

  • summary

    pointer to menu that displayed me

• dijit._MenuBase.popupDelay

  • type

    Integer

  • summary

    number of milliseconds before hovering (without clicking) causes the popup to automatically open.

• dijit._MenuBase.startup

  • type

    Function

• dijit._MenuBase.onExecute

  • summary

    Attach point for notification about when a menu item has been executed.
    This is an internal mechanism used for Menus to signal to their parent to
    close them, because they are about to execute the onClick handler.   In
    general developers should not attach to or override this method.

  • tags:
  • type

    Function

• dijit._MenuBase.onCancel

  • parameters:
    • closeAll: (typeof Boolean)
  • summary

    Attach point for notification about when the user cancels the current menu
    This is an internal mechanism used for Menus to signal to their parent to
    close them.  In general developers should not attach to or override this method.

  • tags:
  • type

    Function

• dijit._MenuBase._moveToPopup

  • parameters:
    • evt: (typeof Event)
  • summary

    This handles the right arrow key (left arrow key on RTL systems),
    which will either open a submenu, or move to the next item in the
    ancestor MenuBar

  • tags:
  • type

    Function

• dijit._MenuBase._onPopupHover

  • parameters:
    • evt: (typeof Event)
  • summary

    This handler is called when the mouse moves over the popup.

  • tags:
  • type

    Function

• dijit._MenuBase.currentPopup.parentMenu

• dijit._MenuBase.currentPopup.parentMenu.focusedChild

• dijit._MenuBase.onItemHover

  • parameters:
    • item: (typeof MenuItem)
  • summary

    Called when cursor is over a MenuItem.

  • tags:
  • type

    Function

• dijit._MenuBase.hover_timer

  • type

    Object

• dijit._MenuBase._hoveredChild

  • type

    Object

• dijit._MenuBase._onChildBlur

  • parameters:
    • item
  • summary

    Called when a child MenuItem becomes inactive because focus
    has been removed from the MenuItem *and* it's descendant menus.

  • tags:
  • type

    Function

• dijit._MenuBase.onItemUnhover

  • parameters:
    • item: (typeof MenuItem)
  • summary

    Callback fires when mouse exits a MenuItem

  • tags:
  • type

    Function

• dijit._MenuBase._stopPopupTimer

  • summary

    Cancels the popup timer because the user has stop hovering
    on the MenuItem, etc.

  • tags:
  • type

    Function

• dijit._MenuBase._stopPendingCloseTimer

  • parameters:
    • popup: (typeof dijit._Widget)
  • summary

    Cancels the pending-close timer because the close has been preempted

  • tags:
  • type

    Function

• dijit._MenuBase._stopFocusTimer

  • summary

    Cancels the pending-focus timer because the menu was closed before focus occured

  • tags:
  • type

    Function

• dijit._MenuBase._focus_timer

  • type

    Object

• dijit._MenuBase._getTopMenu

  • summary

    Returns the top menu in this chain of Menus

  • tags:
  • type

    Function

• dijit._MenuBase.onItemClick

  • parameters:
    • item: (typeof dijit._Widget)
    • evt: (typeof Event)
  • summary

    Handle clicks on an item.

  • tags:
  • type

    Function

• dijit._MenuBase._openPopup

  • returns

    the focused child lost focus since the timer was started

  • summary

    Open the popup to the side of/underneath the current menu item

  • tags:
  • type

    Function

• dijit._MenuBase.focusedChild

  • type

    Object

• dijit._MenuBase.focusedChild.popup

• dijit._MenuBase.focusedChild.popup.parentMenu

  • type

    Object

• dijit._MenuBase.focusedChild.popup.from_item

• dijit._MenuBase.currentPopup

  • type

    Object

• dijit._MenuBase.focusedChild.popup._focus_timer

  • type

    Object

• dijit._MenuBase._markActive

  • summary

    Mark this menu's state as active.
    Called when this Menu gets focus from:
    1) clicking it (mouse or via space/arrow key)
    2) being opened by a parent menu.
    This is not called just from mouse hover.
    Focusing a menu via TAB does NOT automatically set isActive
    since TAB is a navigation operation and not a selection one.
    For Windows apps, pressing the ALT key focuses the menubar
    menus (similar to TAB navigation) but the menu is not active
    (ie no dropdown) until an item is clicked.

  • type

    Function

• dijit._MenuBase.isActive

  • type

    bool

• dijit._MenuBase.onOpen

  • parameters:
    • e: (typeof Event)
  • summary

    Callback when this menu is opened.
    This is called by the popup manager as notification that the menu
    was opened.

  • tags:
  • type

    Function

• dijit._MenuBase.isShowingNow

  • type

    bool

• dijit._MenuBase._markInactive

  • summary

    Mark this menu's state as inactive.

  • type

    Function

• dijit._MenuBase.onClose

  • summary

    Callback when this menu is closed.
    This is called by the popup manager as notification that the menu
    was closed.

  • tags:
  • type

    Function

• dijit._MenuBase._closeChild

  • summary

    Called when submenu is clicked or focus is lost.  Close hierarchy of menus.

  • tags:
  • type

    Function

• dijit._MenuBase._onItemFocus

  • parameters:
    • item: (typeof MenuItem)
  • summary

    Called when child of this Menu gets focus from:
    1) clicking it
    2) tabbing into it
    3) being opened by a parent menu.
    This is not called just from mouse hover.

  • type

    Function

• dijit._MenuBase._onBlur

  • summary

    Called when focus is moved away from this Menu and it's submenus.

  • tags:
  • type

    Function

• dijit._MenuBase._cleanUp

  • summary

    Called when the user is done with this menu.  Closes hierarchy of menus.

  • tags:
  • type

    Function

• dijit.Menu

  • type

    Function

  • chains:
    • dijit._MenuBase: (prototype)
    • dijit._MenuBase: (call)

• dijit.Menu.constructor

  • constructor - constructor
  • type

    Function

• dijit.Menu.templateString

  • type

    Object

• dijit.Menu.baseClass

  • type

    String

• dijit.Menu.targetNodeIds

  • tags: const
  • type

    String[]

  • summary

    Array of dom node ids of nodes to attach to.
    Fill this with nodeIds upon widget creation and it becomes context menu for those nodes.

• dijit.Menu.contextMenuForWindow

  • tags: const
  • type

    Boolean

  • summary

    If true, right clicking anywhere on the window will cause this context menu to open.
    If false, must specify targetNodeIds.

• dijit.Menu.leftClickToOpen

  • tags: const
  • type

    Boolean

  • summary

    If true, menu will open on left click instead of right click, similiar to a file menu.

• dijit.Menu.refocus

  • type

    Boolean

  • summary

    When this menu closes, re-focus the element which had focus before it was opened.

• dijit.Menu.postCreate

  • type

    Function

• dijit.Menu._openSubMenuKey

• dijit.Menu._closeSubMenuKey

• dijit.Menu._onKeyPress

  • parameters:
    • evt: (typeof Event)
  • summary

    Handle keyboard based menu navigation.

  • tags:
  • type

    Function

• dijit.Menu._iframeContentWindow

  • parameters:
    • iframe_el: (typeof HTMLIFrameElement)
  • returns

    Window

  • summary

    Returns the window reference of the passed iframe

  • tags:
  • type

    Function

• dijit.Menu._iframeContentDocument

  • parameters:
    • iframe_el: (typeof HTMLIFrameElement)
  • returns

    HTMLDocument

  • summary

    Returns a reference to the document object inside iframe_el

  • tags:
  • type

    Function

• dijit.Menu.bindDomNode

  • parameters:
    • node: (typeof String|DomNode)
  • summary

    Attach menu to given node

  • type

    Function

• dijit.Menu.unBindDomNode

  • parameters:
    • nodeName: (typeof String|DomNode)
  • summary

    Detach menu from given node

  • type

    Function

• dijit.Menu._scheduleOpen

  • parameters:
    • target: (typeof DomNode)
    • iframe: (typeof DomNode)
    • coords: (typeof Object)
  • summary

    Set timer to display myself.  Using a timer rather than displaying immediately solves
    two problems:
    
    1. IE: without the delay, focus work in "open" causes the system
    context menu to appear in spite of stopEvent.
    
    2. Avoid double-shows on linux, where shift-F10 generates an oncontextmenu event
    even after a dojo.stopEvent(e).  (Shift-F10 on windows doesn't generate the
    oncontextmenu event.)

  • type

    Function

• dijit.Menu._openTimer

  • type

    Object

• dijit.Menu._openMyself

  • parameters:
    • args: (typeof This)

      is an Object containing:
      * target:
      The node that is being clicked
      * iframe:
      If an <iframe> is being clicked, iframe points to that iframe
      * coords:
      Put menu at specified x/y position in viewport, or if iframe is
      specified, then relative to iframe.
      
      _openMyself() formerly took the event object, and since various code references
      evt.target (after connecting to _openMyself()), using an Object for parameters
      (so that old code still works).

  • summary

    Internal function for opening myself when the user does a right-click or something similar.

  • type

    Function

• dijit.Menu._onBlur

  • type

    Function

• dijit.Menu.uninitialize

  • type

    Function

• dijit.Menu._bindings

  • type

    Array

• dijit

  • type

    Object