<menuitem>

概要

HTMLの menuitem 要素( <menuitem>) は、ユーザがポップアップメニュから実行できるコマンドをあらわします。This includes context menus, as well as menus that might be attached to a menu button.

A command can either be defined explicitly, with a textual label and optional icon to describe its appearance, or alternatively as an indirect command whose behavior is defined by a separate element. Commands can also optionally include a checkbox or be grouped to share radio buttons. (Menu items for indirect commands gain checkboxes or radio buttons when defined against elements <input type="checkbox"> and <input type="radio">.)

属性

この要素はグローバル属性をサポートしています。特にtitle属性はコマンドの説明やヒントを出すのに使われます。

checked

コマンドが選択されているか否かを示す論理属性。type属性がcheckboxまたはradioのときのみ使われます。

command

Specifies the ID of a separate element, indicating a command to be invoked indirectly. May not be used within a menu item that also includes the attributes checked, disabled, icon, label, radiogroup or type.

default

This Boolean attribute indicates use of the same command as the menu's subject element (such as a button or input).

disabled

Boolean attribute which indicates that the command is not available in the current state. Note that disabled is distinct from hidden; the disabled attribute is appropriate in any context where a change in circumstances might render the command relevant.

icon

Image URL, used to provide a picture to represent the command.

label

The name of the command as shown to the user. Required when a command attribute is not present.

radiogroup

This attribute specifies the name of a group of commands to be toggled as radio buttons when selected. May only be used where the type attribute is radio.

type

This attribute indicates the kind of command, and can be one of three values.

• command: A regular command with an associated action. This is the missing value default.
• checkbox: Represents a command that can be toggled between two different states.
• radio: Represent one selection from a group of commands that can be toggled as radio buttons.

Examples

HTML content

<!-- 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" onclick="toggleOption()" checked="true">Checkbox</menuitem>
  <menuitem type="command" label="Command" icon="icon.png" onclick="doSomething()">Checkbox</menuitem>
  <menuitem type="radio" name="group1" onclick="option()" checked="true">Radio button 1</menuitem>
  <menuitem type="radio" name="group1" onclick="option()">Radio button 2</menuitem>
</menu>

CSS content

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

Result

Specifications

ブラウザ実装状況

[1] This is implemented behind the preference Experimental Web Platform features and only supports type="command".

[2] Only works for <menuitems> defined within a <menu> element assigned to an element via the contextmenu attribute. Furthermore, the element requires a closing tag.

[3] This is implemented behind the preference Enable experimental Web Platform features and only supports type="command".

See also

• HTML5 context menus in Firefox (Screencast and Code)