<menuitem>

已弃用 HTML5.2: 不再推荐使用该特性。虽然一些浏览器仍然支持它,但也许已从相关的 web 标准中移除,也许正准备移除或出于兼容性而保留。请尽量不要使用该特性,并更新现有的代码;参见本页面底部的兼容性表格以指导你作出决定。请注意,该特性随时可能无法正常工作。

用户可以通过HTML <menuitem> 元素生成一个弹出式菜单。这包括上下文菜单,以及按钮可能附带的菜单。

这个标签可以被显式定义,带有文本标签和可选图标来描述其外观,或者作为一个间接命令,其行为由一个单独的元素定义。命令还可以选择包含复选框或分组共享单选按钮。(<input type="checkbox"><input type="radio">

内容类别 (en-US) None.
允许的内容 None,这是一个空元素
标签省略 必须有开始标签和结束标签。
允许的父元素 The <menu> element, where that element is in the popup menu state. (If specified, the type attribute of the <menu> element must be popup; if missing, the parent element of the <menu> must itself be a <menu> in the popup menu state.)
允许的 ARIA roles None
DOM 接口 HTMLMenuItemElement (en-US)

属性

该标签支持全局属性;特别地, title 常常用来描述命令,或者提供有用的注释。

checked

布尔值,指示是否选择了命令。只能作为属性使用在 checkboxradio 中。

command

指定一个单独元素的 ID,指示要间接调用的命令。在包含属性的菜单项中也不能使用。checkeddisablediconlabelradiogrouptype

default

布尔值,表示使用与菜单主题元素相同的命令。(如 buttoninput)。

disabled

布尔值,表示命令在当前状态下不可用。请注意,禁用与隐藏不同;禁用的属性适用于任何环境变化可能导致命令相关的上下文中。

icon

图片 URL,用于提供图片来表示命令。

label

展示给用户一个命令的名字,当 command 属性不存在时是必须的。

radiogroup

此属性指定要切换为单选按钮时,选定的一组命令的名称。只能作为 radio 的属性使用。

type

这个属性指定命令的类型,可以为以下三个命令之一。

  • command:有关联动作的常规命令。这是缺少时的值默认值。
  • checkbox:代表一个命令可以在两个不同状态之间的切换。
  • radio:代表一组单选按钮,可切换为命令中的一个选择。

例子

HTML

<!-- 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 type="checkbox" checked>Checkbox</menuitem>
  <hr>
  <menuitem type="command" label="This command does nothing" icon="https://developer.mozilla.org/static/img/favicon144.png">
    Commands don't render their contents.
  </menuitem>
  <menuitem type="command" label="This command has javascript" onclick="alert('command clicked')">
    Commands don't render their contents.
  </menuitem>
  <hr>
  <menuitem type="radio" radiogroup="group1">Radio Button 1</menuitem>
  <menuitem type="radio" radiogroup="group1">Radio Button 2</menuitem>
</menu>

CSS

div {
  width: 300px;
  height: 80px;
  background-color: lightgreen;
}

结果

规范

不属于任何现行的规范。

浏览器兼容性

BCD tables only load in the browser

参见