aboutsummaryrefslogtreecommitdiff
path: root/files/ca/web/html/element/menuitem/index.html
blob: d6dae0dfb079aee6a243234513f1d39db77095f9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
---
title: <menuitem>
slug: Web/HTML/Element/menuitem
tags:
  - Element
  - Experimental
  - HTML
  - HTML interactive elements
  - HTML5
  - Reference
  - Web
translation_of: Web/HTML/Element/menuitem
---
<div>{{HTMLRef}}{{SeeCompatTable}}</div>

<h2 id="Sumari">Sumari</h2>

<p>L'<strong>element HTML <code>&lt;menuitem&gt;</code></strong> representa un comando que un usuari és capaç d'invocar a través d'un menú emergent. Això inclou menús contextuals, així com menús que es poden adjuntar a un botó de menú.</p>

<p>Un comando es pot definir explícitament, amb una etiqueta textual i una icona opcional per descriure el seu aspecte, o bé com un comando indirecte el comportament del qual és definit per un element separat. Els comandos també poden incloure opcionalment una casella de verificació o estar agrupats per compartir els botons d'opció. (Els elements de menú per a comandos indirectes s'obtenen de caselles de verificació o botons de radi quan es defineixen contra els elements <code>&lt;input type="checkbox"&gt;</code> i <code>&lt;input type="radio"&gt;</code>.)</p>

<table class="properties">
 <tbody>
  <tr>
   <th scope="row"><a href="/en-US/docs/Web/HTML/Content_categories">Categories de contingut</a></th>
   <td>Cap.</td>
  </tr>
  <tr>
   <th scope="row">Contingut permès</th>
   <td>Cap, és un {{Glossary("empty element")}}.</td>
  </tr>
  <tr>
   <th scope="row">Omissió de l'etiqueta</th>
   <td><span id="result_box" lang="ca"><span>Ha de tenir una</span> <span>etiqueta d'inici</span> <span>i</span> <span>no</span><span> etiqueta</span> <span>de tancament</span></span> .</td>
  </tr>
  <tr>
   <th scope="row">Elements pares permesos</th>
   <td>L'element {{HTMLElement ( "menu")}}, on aquest element està en l'<em>estat del menú emergent</em>. (Si s'especifica, l'atribut <code>type</code> de l'element {{HTMLElement ( "menu")}} ha de ser <code>popup</code>; si manca, l'element principal de el {{HTMLElement ( "menu")}} ha de ser un {{HTMLElement ( "menu")}} en l'estat del <em>menú emergent</em>.</td>
  </tr>
  <tr>
   <th scope="row">Interfície DOM</th>
   <td>{{domxref("HTMLMenuItemElement")}}</td>
  </tr>
 </tbody>
</table>

<h2 id="Atributs">Atributs</h2>

<p>Aquest element inclou els <a href="/en-US/docs/Web/HTML/Global_attributes">atributs global</a>; en particular <code>title</code> pot ser utilitzat per descriure el comando, o proporcionar suggeriments d'ús.</p>

<dl>
 <dt>{{htmlattrdef("checked")}}</dt>
 <dd>Atribut booleà que indica si s'ha seleccionat el comando. Només es pot utilitzar quan l'atribut <code>type</code> és <code>checkbox</code> or <code>radio</code></dd>
 <dt>{{htmlattrdef("command")}}</dt>
 <dd>Especifica l'ID d'un element separat, que indica una ordre que s'invoca de manera indirecta. No es pot utilitzar dins d'un element de menú que també inclou els atributs <code>checked</code>, <code>disabled</code>, <code>icon</code>, <code>label</code>, <code>radiogroup</code> o <code>type</code>.</dd>
 <dt>{{htmlattrdef("default")}}</dt>
 <dd>Aquest atribut booleà indica l'ús del mateix comando que l'element menu's subjecte (tal com un <code>button</code> o <code>input</code>).</dd>
 <dt>{{htmlattrdef("disabled")}}</dt>
 <dd>Atribut booleà que indica que l'ordre no està disponible en l'estat actual. Recordeu que és diferent <code>disabled</code> que <code>hidden</code>; l'atribut <code>disabled</code> és apropiat en qualsevol context on un canvi en les circumstàncies podria fer que el comando fora rellevant.</dd>
 <dt>{{htmlattrdef("icon")}}</dt>
 <dd>URL de la imatge, que s'utilitza per proporcionar una imatge per representar el comando.</dd>
 <dt>{{htmlattrdef("label")}}</dt>
 <dd>El nom del comando com es mostra a l'usuari. Es requereix quan l'atribut <code>command</code> no està present.</dd>
 <dt>{{htmlattrdef("radiogroup")}}</dt>
 <dd>Aquest atribut especifica el nom d'un grup de comandos que s'han d'alternar com a botons d'opció quan se selecciona. Només es pot utilitzar quan l'atribut de tipus és <code>radio</code>.</dd>
 <dt>{{htmlattrdef("type")}}</dt>
 <dd>Aquest atribut indica el tipus de comandament, i pot tenir un dels tres valors.
 <ul>
  <li><code>command</code>: Un comando regular amb una acció associada. Aquest és el valor per defecte si falta.</li>
  <li><code>checkbox</code>: Representa una ordre que es pot commutar entre dos estats diferents.</li>
  <li><code>radio</code>: Representen una selecció d'un grup de comandes que es poden alternar com botons de radio.</li>
 </ul>
 </dd>
</dl>

<h2 id="Exemple">Exemple</h2>

<h3 id="Contingut_HTML">Contingut HTML</h3>

<pre class="brush: html">&lt;!-- A &lt;div&gt; element with a context menu --&gt;
&lt;div contextmenu="popup-menu"&gt;
  Right-click to see the adjusted context menu
&lt;/div&gt;

&lt;menu type="context" id="popup-menu"&gt;
  &lt;menuitem type="checkbox" onclick="toggleOption()" checked="true"&gt;Checkbox&lt;/menuitem&gt;
  &lt;menuitem type="command" label="Command" icon="icon.png" onclick="doSomething()"&gt;Checkbox&lt;/menuitem&gt;
  &lt;menuitem type="radio" name="group1" onclick="option()" checked="true"&gt;Radio button 1&lt;/menuitem&gt;
  &lt;menuitem type="radio" name="group1" onclick="option()"&gt;Radio button 2&lt;/menuitem&gt;
&lt;/menu&gt;
</pre>

<h3 id="Contingut_CSS">Contingut CSS</h3>

<pre class="brush: css">div {
  width: 300px;
  height: 80px;
  background-color: lightgreen;
}
</pre>

<h3 id="Resultat">Resultat</h3>

<p>{{EmbedLiveSample('Example', '300', '80')}}</p>

<h2 id="Especificacions">Especificacions</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Especificació</th>
   <th scope="col">Estat</th>
   <th scope="col">Comentari</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('HTML WHATWG', 'forms.html#the-menuitem-element', '&lt;menuitem&gt;')}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td> </td>
  </tr>
  <tr>
   <td>{{SpecName('HTML5.1', 'interactive-elements.html#the-menuitem-element', '&lt;menuitem&gt;')}}</td>
   <td>{{Spec2('HTML5.1')}}</td>
   <td>Definició inicial</td>
  </tr>
 </tbody>
</table>

<h2 id="Navegadors_compatibles">Navegadors compatibles</h2>

<p>{{CompatibilityTable}}</p>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Característica</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Edge</th>
   <th>Opera</th>
   <th>Safari</th>
  </tr>
  <tr>
   <td>Suport bàsic</td>
   <td>{{CompatVersionUnknown}}<sup>[1]</sup></td>
   <td>{{CompatGeckoDesktop(8)}}<sup>[2]</sup></td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatVersionUnknown}}<sup>[3]</sup></td>
   <td>{{CompatUnknown}}</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Característica</th>
   <th>Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Suport bàsic</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatGeckoMobile(8)}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<p>[1] Això s'implementa darrere de les <em>característiques de la plataforma web experimental</em> de preferència i només és compatible amb <code>type="comand"</code>.</p>

<p>[2] Només funciona per &lt;menuitems&gt; definit dins d'un element {{HTMLElement("menu")}} assignat a un element per mitjà de l'<a href="https://developer.mozilla.org/en-US/docs/HTML/Global_attributes#attr-contextmenu">atribut contextmenu</a>. A més, l'element requereix una etiqueta de tancament.</p>

<p>[3]  Això s'implementa darrere de les <em>característiques habilitades de la plataforma web experimental</em> de preferència<span lang="ca"><span> i</span> <span>només</span> <span>és compatible</span> <span>amb</span> </span><code>type="comand"</code>.</p>

<h2 id="Veure">Veure</h2>

<ul>
 <li><a href="https://hacks.mozilla.org/2011/11/html5-context-menus-in-firefox-screencast-and-code/">Menús de context HTML5 en Firefox (Screencast i Codi)</a></li>
</ul>