<menuitem>
==========

**HTML5.2:** Cette fonctionnalité a été supprimée des standards du Web. Bien que quelques navigateurs puissent encore la supporter, elle est en cours d'éradication. Ne l'utilisez ni dans d'anciens projets, ni dans de nouveaux. Les pages et applications Web l'utilisant peuvent cesser de fonctionner à tout moment.

L'élément HTML **`<menuitem>`** représente une commande qu'un utilisateur peut utiliser via un menu contextuel ou un menu rattaché à un bouton.

Une commande peut être définie explicitement, avec un texte et éventuellement une icône ou bien faire référence à une commande décrite dans un autre élément. Une commande peut prendre la forme d'une case à cocher ou d'un groupe de boutons radio.

Attributs
---------

Cet élément inclut également les attributs universels et notamment `title` qui peut être utilisé afin de décrire une commande ou pour fournir des indications quant à l'utilisation de celle-ci.

`checked`

Un attribut booléen qui indique si la commande est sélectionné. Cet attribut peut uniquement être utilisé lorsque l'attribut `type` vaut `checkbox` ou `radio`.

`command`

Cet attribut définit l'identifiant d'un autre élément qui indique une commande invoquée indirectement. Cet attribut ne peut pas être utilisé si les attributs `checked`, `disabled`, `icon`, `label`, `radiogroup` ou `type` sont utilisés.

`default`

Un attribut booléen qui indique la commande par défaut du menu.

`disabled`

Un attribut booléen qui indique que la commande n'est pas disponible dans l'état actuel. On notera que `disabled` est sémantiquement différent de `hidden`.

`icon`

Une URL vers image qui représente la commande.

`label`

Le nom de la commande affiché pour l'utilisateur. Cet attribut est obligatoire lorsque l'attribut `command` est absent.

`radiogroup`

Cet attribut indique le nom d'un groupe de commandes étant des boutons radio. Cet attribut peut uniquement être utilisé lorsque `type` vaut `radio`.

`type`

Cet attribut indique le type de commande dans le menu. C'est un attribut à valeur contrainte qui peut prendre une des valeurs suivantes :

* `command` : une commande associée à une action donnée. C'est la valeur par défaut de l'attribut.
* `checkbox` : une commande qui peut avoir un état parmi deux états différents.
* `radio` : une commande qui représente une sélection au sein d'un groupe de commandes qui sont des boutons radio.

Exemples
--------

### HTML


```html
<!-- Un élément <div> avec un menu contextuel -->
<div contextmenu="popup-menu">
  Effectuez un clic-droit pour voir le menu contextuel
</div>

<menu type="context" id="popup-menu">
  <menuitem type="checkbox" checked>Une case à cocher</menuitem>
  <hr />
  <menuitem
 type="command"
 label="Cette commande ne fait rien"
 icon="https://developer.mozilla.org/static/img/favicon144.png">
    Les commandes n'affichent pas leurs contenus.
  </menuitem>
  <menuitem
 type="command"
 label="Cette commande contient du JavAScript"
 onclick="alert('command clicked')">
    Les commandes n'affichent pas leurs contenus.
  </menuitem>
  <hr />
  <menuitem type="radio" radiogroup="group1">Bouton radio 1</menuitem>
  <menuitem type="radio" radiogroup="group1">Bouton radio 2</menuitem>
</menu>
```

### CSS


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

### Résultat

Résumé technique
----------------

|  |  |
| --- | --- |
| Catégories de contenu | Aucune. |
| Contenu autorisé | Aucun, c'est un élément vide. |
| Omission de balises | 
 Cet élément doit avoir une balise ouvrante et ne doit pas avoir de
 balise fermante.
  |
| Parents autorisés | 
 Un élément `<menu>` lorsque son attribut vaut
 `type` ou que cet élément `<menu>` est lui
 même le fils d'un élément `<menu`>.
  |
| Rôles ARIA autorisés | Aucun. |
| Interface DOM | `HTMLMenuItemElement` (en-US) |

Spécifications
--------------

{{Specifications}}Compatibilité des navigateurs
-----------------------------

{{Compat}}Voir aussi
----------

* `<menu>`
* Les menus contextuels HTML5 dans Firefox