diff options
Diffstat (limited to 'files/ca/web/html/element/menuitem/index.html')
-rw-r--r-- | files/ca/web/html/element/menuitem/index.html | 192 |
1 files changed, 192 insertions, 0 deletions
diff --git a/files/ca/web/html/element/menuitem/index.html b/files/ca/web/html/element/menuitem/index.html new file mode 100644 index 0000000000..d6dae0dfb0 --- /dev/null +++ b/files/ca/web/html/element/menuitem/index.html @@ -0,0 +1,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><menuitem></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><input type="checkbox"></code> i <code><input type="radio"></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"><!-- 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> +</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', '<menuitem>')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td> </td> + </tr> + <tr> + <td>{{SpecName('HTML5.1', 'interactive-elements.html#the-menuitem-element', '<menuitem>')}}</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 <menuitems> 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> |