--- title:
context
{{Deprecated_inline}} : Indicates the popup menu state, which represents a group of commands activated through another element. This might be as a button menu referenced by a {{HTMLAttrxRef("menu", "button")}} attribute of a {{HTMLElement("button")}} element, or as context menu for an element with a contextmenu
attribute. This value is the default if the attribute is missing and the parent element is also a <menu>
element.toolbar
: Indicates the toolbar state, which represents a toolbar consisting of a series of commands for user interaction. This might be in the form of an unordered list of {{HTMLElement("li")}} elements, or, if the element has no <li>
element children, flow content describing available commands. This value is the default if the attribute is missing.The {{HTMLElement("menu")}} and {{HTMLElement("ul")}} elements both represent an unordered list of items. The key difference is that {{HTMLElement("ul")}} primarily contains items for display, whilst {{HTMLElement("menu")}} is intended for interactive items, to act on.
An HTML menu can be used to create context menus (typically activated by right-clicking another element) or toolbars.
{{anch("Context menu", "Context menus")}} consist of a <menu>
element which contains {{HTMLElement("menuitem")}} elements for each selectable option in the menu, <menu>
elements for submenus within the menu, and {{HTMLElement("hr")}} elements for separator lines to break up the menu's content into sections. Context menus are then attached to the element they're activated from using either the associated element's {{HTMLAttrxRef("contextmenu")}} attribute or, for {{anch("Button menu", "button-activated menus")}} attached to {{HTMLElement("button")}} elements, the {{HTMLAttrxRef("menu", "button")}} attribute.
{{anch("Toolbar", "Toolbar menus")}} consist of a <menu>
element whose content is described in one of two ways: either as an unordered list of items represented by {{HTMLElement("li")}} elements (each representing a command or option the user can utilize), or (if there are no <li>
elements), flow content describing the available commands and options.
This element was deprecated in HTML4, but reintroduced in HTML5.1 and the HTML living standard. This document describes the current Firefox implementation. Type 'list' is likely to change to 'toolbar' according to HTML5.1.
{{Deprecated_header}}
<!-- A <div> element with a context menu --> <div contextmenu="popup-menu"> Right-click to see the adjusted context menu </div> <menu type="context" id="popup-menu"> <menuitem>Action</menuitem> <menuitem>Another action</menuitem> <hr/> <menuitem>Separated action</menuitem> </menu>
div { width: 300px; height: 80px; background-color: lightgreen; }
{{EmbedLiveSample("Context_menu", "100%", 80)}}
Menu buttons haven't been implemented in any known browsers yet. The {{HTMLAttrxRef("type", "menu")}} attribute on the <menu>
element is now obsolete.
{{HTMLElement("menuitem")}} element is obsolete.
<!-- A button, which displays a menu when clicked. --> <button type="menu" menu="popup-menu"> Dropdown </button> <menu type="context" id="popup-menu"> <menuitem>Action</menuitem> <menuitem>Another action</menuitem> <hr/> <menuitem>Separated action</menuitem> </menu>
{{EmbedLiveSample("Menu_button", "100%", 50)}}
Toolbar menus haven't been implemented in any known browsers yet.
<!-- A context menu for a simple editor, - containing two menu buttons. --> <menu type="toolbar"> <li> <button type="menu" menu="file-menu">File</button> <menu type="context" id="file-menu"> <menuitem label="New..." onclick="newFile()"> <menuitem label="Save..." onclick="saveFile()"> </menu> </li> <li> <button type="menu" menu="edit-menu">Edit</button> <menu type="context" id="edit-menu"> <menuitem label="Cut..." onclick="cutEdit()"> <menuitem label="Copy..." onclick="copyEdit()"> <menuitem label="Paste..." onclick="pasteEdit()"> </menu> </li> </menu>
{{EmbedLiveSample("Toolbar", "100%", 100)}}
Specification | Status | Comment |
---|---|---|
{{SpecName("HTML WHATWG", "grouping-content.html#the-menu-element", "<menu>")}} | {{Spec2("HTML WHATWG")}} | No change from latest snapshot, {{SpecName("HTML5.3")}} |
{{SpecName("HTML5.1", "interactive-elements.html#the-menu-element", "<menu>")}} | {{Spec2("HTML5.1")}} |
{{Compat("html.elements.menu")}}
contextmenu
global attribute can be used on an element to refer to the id
of a menu
with {{HTMLAttrxRef("type", "menu", 'type="context"')}}.