这是
实验性技术
检查
浏览器兼容性表格
要小心谨慎在生产中使用这之前。
HTML
<menu>
element
represents a group of commands that a user can perform or activate. This includes both list menus, which might appear across the top of a screen, as well as
context menus
, such as those that might appear underneath a button after it has been clicked.
| 内容类别 |
流内容
. If the element's children include at least one
<li>
元素：
Palpable content
.
|
|---|---|
| 准许内容 |
If the element is in the
list menu
state:
flow content
, or alternatively, zero or more occurrences of
<li>
,
<script>
，和
<template>
. (
list menu
is the default state, unless the parent element is a
<menu>
在
context menu
state.)
If the element is in the
context menu
state: zero or more occurrences, in any order, of
|
| Tag omission | None, both the starting and ending tag are mandatory. |
| Permitted parents | Any element that accepts flow content . |
| Implicit ARIA role |
list
|
| Permitted ARIA roles |
directory
,
group
,
listbox
,
menu
,
menubar
,
none
,
presentation
,
radiogroup
,
tablist
,
toolbar
or
tree
|
| DOM 接口 |
HTMLMenuElement
|
此元素包括 全局属性 .
label
<menu>
在
context menu
状态。
type
context
: 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
menu
attribute of a
<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>
元素。
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
<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.
<menu>
and
<ul>
elements both represent an unordered list of items. The key difference is that
<ul>
primarily contains items for display, whilst
<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.
Context menus
consist of a
<menu>
element which contains
<menuitem>
elements for each selectable option in the menu,
<menu>
elements for submenus within the menu, and
<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
contextmenu
attribute or, for
button-activated menus
attached to
<button>
elements, the
menu
属性。
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
<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.
弃用
This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the
兼容性表格
at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
<!-- 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;
}
Menu buttons haven't been implemented in any known browsers yet. The
type
属性在
<menu>
element is now obsolete.
<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>
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>
| 规范 | 状态 | 注释 |
|---|---|---|
|
HTML 实时标准
The definition of '<menu>' in that specification. |
实时标准 | No change from latest snapshot, 未知 |
|
HTML 5.1
The definition of '<menu>' in that specification. |
推荐 |
| 桌面 | 移动 | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
menu
实验性
|
Chrome 不支持 No | Edge 不支持 ≤18 — 79 | Firefox 完整支持 8 | IE 不支持 No | Opera 不支持 No | Safari 不支持 No | WebView Android 不支持 No | Chrome Android 不支持 No |
Firefox Android
完整支持
8
注意事项
|
Opera Android 不支持 No | Safari iOS 不支持 No | Samsung Internet Android 不支持 No |
Menus on
<button>
element
实验性
|
Chrome 不支持 No | Edge 不支持 No | Firefox 不支持 No | IE 不支持 No | Opera 不支持 No | Safari 不支持 No | WebView Android 不支持 No | Chrome Android 不支持 No | Firefox Android 不支持 No | Opera Android 不支持 No | Safari iOS 不支持 No | Samsung Internet Android 不支持 No |
<hr>
creates a separator
实验性
|
Chrome 不支持 No | Edge 不支持 No | Firefox 完整支持 51 | IE 不支持 No | Opera 不支持 No | Safari 不支持 No | WebView Android 不支持 No | Chrome Android 不支持 No | Firefox Android 完整支持 51 | Opera Android 不支持 No | Safari iOS 不支持 No | Samsung Internet Android 不支持 No |
label
实验性
|
Chrome 不支持 No | Edge 不支持 No | Firefox 完整支持 8 | IE 不支持 No | Opera 不支持 No | Safari 不支持 No | WebView Android 不支持 No | Chrome Android 不支持 No |
Firefox Android
完整支持
8
注意事项
|
Opera Android 不支持 No | Safari iOS 不支持 No | Samsung Internet Android 不支持 No |
完整支持
不支持
实验。期望将来行为有所改变。
见实现注意事项。
<ol>
,
<ul>
,
<li>
,
<hr>
, and the obsolete
<dir>
.
contextmenu
global attribute
can be used on an element to refer to the
id
的
menu
with
type="context"
.