menuitem要素

1.仕様

menuitem

メニュー項目 (menu item)

HTML5.1 で追加, HTML5.2 で廃止の要素です。
以下の説明では、HTML Living Standard での解釈を想定して記述しています。

種類

空要素

任意のコンテンツを持つことができない要素です。

カテゴリ

なし

使用できるコンテキスト

<menu>要素に 0個以上

<menu>要素に 0個以上を そのコンテンツとして、使用できます。

コンテンツモデル

何もない

要素のコンテンツモデルが「何もない」の場合、要素にはテキストノード (要素間の空白以外) と要素ノードが含まれていてはなりません。

タグの省略

終了タグはありません。

コンテンツ属性

グローバル属性 他

type属性

コマンドの種類

label属性

ユーザーに見えるラベル

icon属性

コマンドのアイコン

disabled属性

コマンドまたはコントロールが無効かどうか

checked属性

コマンドまたはコントロールがチェックされているかどうか

radiogroup属性

ラジオボタングループとして扱うコマンドのグループ名

default属性

コマンドをデフォルトコマンドとしてマークする

title属性

コマンドを説明するヒント

DOM インターフェイス

HTMLMenuItemElement

1. [Exposed=Window]
2. interface HTMLMenuItemElement : HTMLElement {
3. lastReviewed;
4. [HTMLConstructor] constructor();
5.  
6. [CEReactions] attribute DOMString type;
7. [CEReactions] attribute DOMString label;
8. [CEReactions] attribute DOMString icon;
9. [CEReactions] attribute boolean disabled;
10. [CEReactions] attribute boolean checked;
11. [CEReactions] attribute DOMString radiogroup;
12. [CEReactions] attribute boolean boolean default;
13. };

HTMLElement

1. [Exposed=Window]
2. interface HTMLElement : Element {
3. [HTMLConstructor] constructor();
4.  
5. // metadata attributes
6. [CEReactions] attribute DOMString title;
7. [CEReactions] attribute DOMString lang;
8. [CEReactions] attribute boolean translate;
9. [CEReactions] attribute DOMString dir;
10.  
11. // user interaction
12. [CEReactions] attribute (boolean or unrestricted double or DOMString)? hidden;
13. [CEReactions] attribute DOMString inert;
14. undefined click();
15. [CEReactions] attribute DOMString accessKey;
16. readonly attribute DOMString accessKeyLabel;
17. [CEReactions] attribute boolean draggable;
18. [CEReactions] attribute boolean spellcheck;
19. [CEReactions] attribute DOMString writingSuggestions;
20. [CEReactions] attribute DOMString autocapitalize;
21.  
22. [CEReactions] attribute [LegacyNullToEmptyString] DOMString innerText;
23. [CEReactions] attribute [LegacyNullToEmptyString] DOMString outerText;
24.  
25. ElementInternals attachInternals();
26.  
27. // The popover API
28. undefined showPopover();
29. undefined hidePopover();
30. boolean togglePopover(optional boolean force);
31. [CEReactions] attribute DOMString? popover;
32. };
33.  
34. HTMLElement includes GlobalEventHandlers;
35. HTMLElement includes ElementContentEditable;
36. HTMLElement includes HTMLOrSVGElement;

Element

1. [Exposed=Window]
2. interface Element : Node {
3. readonly attribute DOMString? namespaceURI;
4. readonly attribute DOMString? prefix;
5. readonly attribute DOMString localName;
6. readonly attribute DOMString tagName;
7.  
8. [CEReactions] attribute DOMString id;
9. [CEReactions] attribute DOMString className;
10. [SameObject, PutForwards=value] readonly attribute DOMTokenList classList;
11. [CEReactions, Unscopable] attribute DOMString slot;
12.  
13. boolean hasAttributes();
14. [SameObject] readonly attribute NamedNodeMap attributes;
15. sequence<DOMString> getAttributeNames();
16. DOMString? getAttribute(DOMString qualifiedName);
17. DOMString? getAttributeNS(DOMString? namespace, DOMString localName);
18. [CEReactions] undefined setAttribute(DOMString qualifiedName, DOMString value);
19. [CEReactions] undefined setAttributeNS(DOMString? namespace, DOMString qualifiedName, DOMString value);
20. [CEReactions] undefined removeAttribute(DOMString qualifiedName);
21. [CEReactions] undefined removeAttributeNS(DOMString? namespace, DOMString localName);
22. [CEReactions] boolean toggleAttribute(DOMString qualifiedName, optional boolean force);
23. boolean hasAttribute(DOMString qualifiedName);
24. boolean hasAttributeNS(DOMString? namespace, DOMString localName);
25.  
26. Attr? getAttributeNode(DOMString qualifiedName);
27. Attr? getAttributeNodeNS(DOMString? namespace, DOMString localName);
28. [CEReactions] Attr? setAttributeNode(Attr attr);
29. [CEReactions] Attr? setAttributeNodeNS(Attr attr);
30. [CEReactions] Attr removeAttributeNode(Attr attr);
31.  
32. ShadowRoot attachShadow(ShadowRootInit init);
33. readonly attribute ShadowRoot? shadowRoot;
34.  
35. Element? closest(DOMString selectors);
36. boolean matches(DOMString selectors);
37. boolean webkitMatchesSelector(DOMString selectors); // legacy alias of .matches
38.  
39. HTMLCollection getElementsByTagName(DOMString qualifiedName);
40. HTMLCollection getElementsByTagNameNS(DOMString? namespace, DOMString localName);
41. HTMLCollection getElementsByClassName(DOMString classNames);
42.  
43. [CEReactions] Element? insertAdjacentElement(DOMString where, Element element); // legacy
44. undefined insertAdjacentText(DOMString where, DOMString data); // legacy
45. };

GlobalEventHandlers

1. interface mixin GlobalEventHandlers {
2. attribute EventHandler onabort;
3. attribute EventHandler onauxclick;
4. attribute EventHandler onbeforeinput;
5. attribute EventHandler onbeforematch;
6. attribute EventHandler onbeforetoggle;
7. attribute EventHandler onblur;
8. attribute EventHandler oncancel;
9. attribute EventHandler oncanplay;
10. attribute EventHandler oncanplaythrough;
11. attribute EventHandler onchange;
12. attribute EventHandler onclick;
13. attribute EventHandler onclose;
14. attribute EventHandler oncontextlost;
15. attribute EventHandler oncontextmenu;
16. attribute EventHandler oncontextrestored;
17. attribute EventHandler oncopy;
18. attribute EventHandler oncuechange;
19. attribute EventHandler oncut;
20. attribute EventHandler ondblclick;
21. attribute EventHandler ondrag;
22. attribute EventHandler ondragend;
23. attribute EventHandler ondragenter;
24. attribute EventHandler ondragleave;
25. attribute EventHandler ondragover;
26. attribute EventHandler ondragstart;
27. attribute EventHandler ondrop;
28. attribute EventHandler ondurationchange;
29. attribute EventHandler onemptied;
30. attribute EventHandler onended;
31. attribute OnErrorEventHandler onerror;
32. attribute EventHandler onfocus;
33. attribute EventHandler onformdata;
34. attribute EventHandler oninput;
35. attribute EventHandler oninvalid;
36. attribute EventHandler onkeydown;
37. attribute EventHandler onkeypress;
38. attribute EventHandler onkeyup;
39. attribute EventHandler onload;
40. attribute EventHandler onloadeddata;
41. attribute EventHandler onloadedmetadata;
42. attribute EventHandler onloadstart;
43. attribute EventHandler onmousedown;
44. [LegacyLenientThis] attribute EventHandler onmouseenter;
45. [LegacyLenientThis] attribute EventHandler onmouseleave;
46. attribute EventHandler onmousemove;
47. attribute EventHandler onmouseout;
48. attribute EventHandler onmouseover;
49. attribute EventHandler onmouseup;
50. attribute EventHandler onpaste;
51. attribute EventHandler onpause;
52. attribute EventHandler onplay;
53. attribute EventHandler onplaying;
54. attribute EventHandler onprogress;
55. attribute EventHandler onratechange;
56. attribute EventHandler onreset;
57. attribute EventHandler onresize;
58. attribute EventHandler onscroll;
59. attribute EventHandler onscrollend;
60. attribute EventHandler onsecuritypolicyviolation;
61. attribute EventHandler onseeked;
62. attribute EventHandler onseeking;
63. attribute EventHandler onselect;
64. attribute EventHandler onslotchange;
65. attribute EventHandler onstalled;
66. attribute EventHandler onsubmit;
67. attribute EventHandler onsuspend;
68. attribute EventHandler ontimeupdate;
69. attribute EventHandler ontoggle;
70. attribute EventHandler onvolumechange;
71. attribute EventHandler onwaiting;
72. attribute EventHandler onwebkitanimationend;
73. attribute EventHandler onwebkitanimationiteration;
74. attribute EventHandler onwebkitanimationstart;
75. attribute EventHandler onwebkittransitionend;
76. attribute EventHandler onwheel;
77. };

ElementContentEditable

1. interface mixin ElementContentEditable {
2. [CEReactions] attribute DOMString contentEditable;
3. [CEReactions] attribute DOMString enterKeyHint;
4. readonly attribute boolean isContentEditable;
5. [CEReactions] attribute DOMString inputMode;
6. };

HTMLOrSVGElement

1. interface mixin HTMLOrSVGElement {
2. [SameObject] readonly attribute DOMStringMap dataset;
3. attribute DOMString nonce; // intentionally no [CEReactions]
4.  
5. [CEReactions] attribute boolean autofocus;
6. [CEReactions] attribute long tabIndex;
7. undefined focus(optional FocusOptions options = {});
8. undefined blur();
9. };

ARIA in HTML

暗黙的="No" ARIAロール="menuitem" aria-* 属性="GlobalAny"

暗黙的な ARIAセマンティクスがありませんが、意味はあり、この意味は、ARIA によって提供されず、ARIA のユーザーに公開されていないロール、状態、プロパティで表現される可能性があります。
ARIA in HTML に、この要素の記述はありません。HTML5.1 に記されている仕様です。

作成者が要素に指定してもよい ARIAロール値は、menuitem です。

グローバル aria-* 属性と、許可されたロールに適用される任意の aria-* 属性が記述できます。

レンダリング

ブロックボックス

リスト

1. menuitem {
2. display: list-item;
3. text-align: match-parent;
4. unicode-bidi: isolate;
5. }
6. menuitem[type=checkbox i], menuitem[type=radio i] {
7. display: inline-block;
8. }

CSS を大雑把に読むと、 ブロックレベルのブロックコンテナボックス(ブロックボックス)を生成します。(マーカーの分のコンテナボックスも生成します。) などになります。

説明

menuitem要素は、ユーザーがポップアップメニュー (コンテキストメニュー) から呼び出すことができるコマンドを表します。

menuitem要素は、ユーザーがポップアップメニュー(コンテキストメニュー)から呼び出すことができるコマンドを表します。
type, label, icon, disabled, checked, radiogroupの一つ以上を使うmenuitem要素は、新しいコマンドを定義します。
HTML5.1 で提案されただけで、HTML Living Standard で採用されておらず、対応しているブラウザもはないと思います。

1. <!DOCTYPE html>
2. <html lang="ja">
3. <head>
4. <meta charset="utf-8">
5. <title>menuitem要素の例 - (Example of menuitem element) | 離珠のHTMLでしぃ！</title>
6. <meta name="author" content="コータン (KOUTAN)">
7. <link rel="icon" href="../favicon.ico" type="image/vnd.microsoft.icon">
8. </head>
9. <body>
10. <h1>menuitem要素の例</h1>
11. <img src="../Img/G01/cafeboard_106l.gif" alt="Cafe board" contextmenu="imiCmmenu">
12. <menu type="context" id="imiCmmenu">
13. <menuitem label="Pet the kittens" onclick="kittens.pet()">
14. <menuitem label="Cuddle with the kittens" onclick="kittens.cuddle()">
15. <menu label="Feed the kittens">
16. <menuitem label="Fish" onclick="kittens.feed(fish)">
17. <menuitem label="Chicken" onclick="kittens.feed(chicken)">
18. </menu>
19. </menu>
20. <p>HTML5.1 にある例示されているソースコードを用いた提示です。
対応しているブラウザーはないと思うのですが、一応の提示です。</p>
21. <p>提示するにあたり、画像とかIDとかは、あえて変えています。</p>
22. <a style="word-break: break-all" href="https://www.w3.org/TR/2016/REC-html51-20161101/interactive-elements.html#example-e5c085bb" target="_top">https://www.w3.org/TR/2016/REC-html51-20161101/interactive-elements.html#example-e5c085bb</a>
23. </body>
24. </html>

このサンプルへのリンクです。
(./exmenuitem.htm)

参照元

参照元

• HTML Living Standard. 16.2 Non-conforming features (最終更新日 2025年8月29日)
• HTML 5.3 W3C 初公開ワーキングドラフト. 11.2. Non-conforming features (W3Cワーキングドラフト、2017年12月14日)
• HTML 5.2 W3C 勧告. 11.2. Non-conforming features (W3C勧告、2017年12月14日)
• HTML 5.1 W3C 勧告. 4.11.4. The menuitem element (W3C勧告、2016年11月1日)
• <menuitem> - HTML: ハイパーテキストマークアップ言語 | MDN

JSONデータ

JSON形式での、データのイメージです。

1. {
2. "menuitem": {
3. "group": "Lists",
4. "element": "- X EMPTY -- menu item. (Void elements.) [None] --",
5. "attlist": {
6. "%Global;": "",
7. "type": "CDATA #IMPLIED -- Type of command --",
8. "label": "CDATA #IMPLIED -- User-visible label --",
9. "icon": "CDATA #IMPLIED -- Icon for the command --",
10. "disabled": "(disabled) #IMPLIED -- Whether the command or control is disabled --",
11. "checked": "(checked) #IMPLIED -- Whether the command or control is checked --",
12. "radiogroup": "CDATA #IMPLIED -- Name of group of commands to treat as a radio button group --",
13. "default": "(default) #IMPLIED -- Mark the command as being a default command --",
14. },
15. "summary": "メニュー項目 (menu item)",
16. "point": "ユーザーがポップアップメニュー (コンテキストメニュー) から呼び出すことができるコマンドを表します。",
17. "description": [
18. "ユーザーがポップアップメニュー(コンテキストメニュー)から呼び出すことができるコマンドを表します。",
19. "type, label, icon, disabled, checked, radiogroupの一つ以上を使うmenuitem要素は、新しいコマンドを定義します。",
20. "HTML5.1 で提案されただけで、HTML Living Standard で採用されておらず、対応しているブラウザもはないと思います。",
21. ],
22. "elementKind": "Void",
23. "categories": "None",
24. "canUsedContexts": "menu (menuitem)*",
25. "contentModel": "%Nothing",
26. "tagOmission": [
27. "-",
28. "X",
29. ],
30. "rendering": [
31. "Lists",
32. "Bidirectional",
33. ],
34. "domInterface": "HTMLMenuItemElement",
35. "contentAttributes": {
36. "type": "コマンドの種類",
37. "label": "ユーザーに見えるラベル",
38. "icon": "コマンドのアイコン",
39. "disabled": "コマンドまたはコントロールが無効かどうか",
40. "checked": "コマンドまたはコントロールがチェックされているかどうか",
41. "radiogroup": "ラジオボタングループとして扱うコマンドのグループ名",
42. "default": "コマンドをデフォルトコマンドとしてマークする",
43. "title": "コマンドを説明するヒント",
44. },
45. "reference": [
46. {
47. "title": "HTML Living Standard. 16.2 Non-conforming features. Last Updated 29 August 2025",
48. "href": "https://html.spec.whatwg.org/multipage/obsolete.html#non-conforming-features",
49. "heading": "HTML Living Standard. 16.2 Non-conforming features",
50. "sub": "最終更新日 2025年8月29日",
51. },
52. {
53. "title": "HTML 5.3 W3C Working Draft. 11.2. Non-conforming features. W3C First Public Working Draft, 14 December 2017",
54. "href": "https://www.w3.org/TR/2017/WD-html53-20171214/obsolete.html#non-conforming-features",
55. "heading": "HTML 5.3 W3C 初公開ワーキングドラフト. 11.2. Non-conforming features",
56. "sub": "W3Cワーキングドラフト、2017年12月14日",
57. },
58. {
59. "title": "HTML 5.2 W3C Recommendation. 11.2. Non-conforming features. W3C Recommendation, 14 December 2017.",
60. "href": "https://www.w3.org/TR/2017/REC-html52-20171214/obsolete.html#non-conforming-features",
61. "heading": "HTML 5.2 W3C 勧告. 11.2. Non-conforming features",
62. "sub": "W3C勧告、2017年12月14日",
63. },
64. {
65. "title": "HTML 5.1 W3C Recommendation. 4.11.4. The menuitem element. W3C Recommendation, 1 November 2016.",
66. "href": "https://www.w3.org/TR/2016/REC-html51-20161101/interactive-elements.html#the-menuitem-element",
67. "heading": "HTML 5.1 W3C 勧告. 4.11.4. The menuitem element",
68. "sub": "W3C勧告、2016年11月1日",
69. },
70. {
71. "title": "MDN Web Docs. HTML <menuitem>",
72. "href": "https://developer.mozilla.org/ja/docs/Web/HTML/Element/menuitem",
73. "heading": "<menuitem> - HTML: ハイパーテキストマークアップ言語 | MDN",
74. },
75. ],
76. "version": {
77. "first": "HTML5.1",
78. "latest": "HTML5.1",
79. },
80. "lastReviewed": "2025-08-31",
81. "obsoleteAttributes": [
82. ],
83. }
84. }

注意: 簡易に描画する為に、各項目の後ろに , を付与しています。JSON の形式では、末尾の項目の後には , は付けません。

最終確認日

2025-08-31

2.使用できるコンテキスト

3.コンテンツモデル

4.コンテンツ属性

1. <img src="../Img/G01/cafeboard_106l.gif" alt="Cafe board" contextmenu="XMNCM400">
2. <menu type="context" id="XMNCM400">
3. <menuitem label="sample01" onclick="alert('さんぷる０')">
4. </menu>

この雛型の 3 行目の<menuitem>要素を置き換えてデモとしています。

雛型を元に複数の例示を併記しているので、ID は、それぞれ書き換えて一意にしています。

例示は、ただソースコードをそのまま記述しただけであり、<menuitem>要素に対応しているブラウザーは現在はないと思います。

例示では空要素の<menuitem>要素として記述していますが、対応していない要素で通常要素として処理されているようです。

尚、<img>要素にあるcontextmenu属性は、HTML5.1 で追加, HTML5.2 で廃止のグローバル属性です。contextmenu属性は、要素のコンテキストメニューを指定します。値は、同じホームサブツリー内のtype属性がポップアップメニュー状態である<menu>要素のIDでなければなりません。

type属性

1. <menuitem type="command" label="sample01" onclick="alert('さんぷる１')">

type属性 は、コマンドの種類を示します。関連するアクションを持つ通常のコマンドか、トグル可能な状態やオプションか、アイテムのリストから1つのアイテムを選択するかのいずれかです。

type属性は、次のキーワード(keywords)と状態(states)を持つ列挙属性(enumerated attribute)です。

command

この要素は、関連するアクションを持つ通常のコマンドを表す。

checkbox

この要素は、トグルできる状態やオプションを表します。

radio

この要素は、アイテムのリストから1つのアイテムを選択することを表します。

列挙属性と呼ばれる一部の属性は、有限の状態セットを取ります。このような属性の状態は、属性の値、各属性の仕様で指定されたキーワード/状態マッピングのセット、および属性の仕様で指定できる 2 つの特殊な状態を組み合わせることによって生成されます。これらの特殊な状態は、無効な値のデフォルトと欠落した値のデフォルトです。
この属性の欠落値のデフォルトは command の状態です。

label属性

1. <menuitem type="command" label="sample01" onclick="alert('さんぷる２')">

label属性 は、ユーザーに表示されるコマンド名を与える。この属性が指定された場合、その値は空文字列であってはなりません。

icon属性

1. <menuitem type="command" icon="../Img/G01/hatena01k.gif" onclick="alert('さんぷる３')">

icon属性 は、コマンドを表す画像を与えます。属性が指定された場合、属性の値は空白で囲まれた有効なURLでなければなりません。属性の値が空文字列でない場合、アイコンの絶対URLを取得するには、属性の値を要素からの相対値で解決しなければなりません。属性が存在しないか、属性値が空文字列であるか、属性値の解析に失敗した場合、アイコンは存在しません。

disabled属性

1. <menuitem type="command" label="sample01" disabled onclick="alert('さんぷる４')">

disabled属性 は、ブーリアン属性で、存在する場合、現在の状態ではコマンドが使用できないことを示す。

checked属性

1. <menuitem type="checkbox" label="checkbox01" checked>
2. <menuitem type="command" label="sample01" disabled onclick="alert('さんぷる５')">

checked属性 は、ブーリアン属性で、存在すればコマンドが選択されていることを示します。type属性がCheckbox状態かRadio状態でない限り、この属性は省略されなければなりません。

radiogroup属性

1. <menuitem type="radio" label="radio01" radiogroup="group01">
2. <menuitem type="radio" label="radio02" radiogroup="group01">
3. <menuitem type="command" label="sample01" disabled onclick="alert('さんぷる６')">

radiogroup属性 は、type属性が値 「radio 」であるコマンドに対して、コマンド自身がトグルされる時にトグルされるコマンドのグループの名前を与えます。名前のスコープは親要素の子リストです。type属性がRadio状態でない限り、属性は省略されなければなりません。指定された場合、属性の値は空でない文字列でなければなりません。

title属性

1. <menuitem type="command" label="sample01" title="これはソースコードの例示です。" onclick="alert('さんぷる８')">

title属性 は、グローバル属性ですが、この要素に関する特別なセマンティクスがあります。title属性は、コマンドを説明するヒントを与えます。

5.DOM インターフェイス

この例示のmenuitemのラベルは、 "〇〇"です。

---

---

1. <img src="../Img/G01/cafeboard_106l.gif" alt="Cafe board" contextmenu="XMNCM501">
2. <menu type="context" id="XMNCM501">
3. <menuitem type="command" label="sample01" onclick="alert('さんぷる５０１ａ')"></menuitem>
4. <menuitem type="command" label="sample02" onclick="alert('さんぷる５０１ｂ')"></menuitem>
5. <menuitem type="command" label="sample03" onclick="alert('さんぷる５０１ｃ')"></menuitem>
6. </menu>
7. <p>この例示のmenuitemのラベルは、
8. "<code id="JCD501">〇〇</code>"です。</p>
9. <script>
10. document.addEventListener("DOMContentLoaded", function() {
11. let _llJsMenuitem = document.querySelectorAll("menu[id='XMNCM501'] > menuitem");
12. let _lsJsText = '';
13. for (var _lnJsIdx = 0; _lnJsIdx < _llJsMenuitem.length; _lnJsIdx++) {
14. _lsJsText = _lsJsText + _llJsMenuitem[_lnJsIdx].getAttribute("label") + ' ';
15. }
16. document.getElementById("JCD501").textContent = _lsJsText;
17. });
18. </script>

menuitemの一覧から、label属性の値を取得する例です。例示で表示する為に、HTML文書の読み込みと解析が終了した時に処理するコードとしています。また、ブラウザが対応してない要素で空要素であるという事から、検証用として通常要素の様に閉じタグを記述しています。

6.アクセシビリティ

7.レンダリング

8.気を付ける点