diff options
Diffstat (limited to 'files/fr/archive/mozilla/xul/menu/index.html')
| -rw-r--r-- | files/fr/archive/mozilla/xul/menu/index.html | 196 |
1 files changed, 196 insertions, 0 deletions
diff --git a/files/fr/archive/mozilla/xul/menu/index.html b/files/fr/archive/mozilla/xul/menu/index.html new file mode 100644 index 0000000000..2a78b15497 --- /dev/null +++ b/files/fr/archive/mozilla/xul/menu/index.html @@ -0,0 +1,196 @@ +--- +title: menu +slug: Archive/Mozilla/XUL/menu +tags: + - Éléments_XUL +translation_of: Archive/Mozilla/XUL/menu +--- +<div class="noinclude"><span class="breadcrumbs XULRef_breadcrumbs"> + « <a href="/fr/docs/Référence_XUL">Accueil de la référence XUL</a> [ + <a href="#Exemples">Exemples</a> | + <a href="#Attributs">Attributs</a> | + <a href="#Propri.C3.A9t.C3.A9s">Propriétés</a> | + <a href="#M.C3.A9thodes">Méthodes</a> | + <a href="#Sujets_li.C3.A9s">Sujets liés</a> ] +</span></div> <p>Un élément, tout à fait semblable à un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/button" title="button">button</a></code>, qui est placé dans un élément <code><a href="/fr/docs/Mozilla/Tech/XUL/menubar" title="menubar">menubar</a></code>. Lorsque l'utilisateur clique sur l'élément <code>menu</code>, le <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code> enfant du menu sera affiché. Cet élément est également utilisé pour créer des sous-menus. +</p><p>Vous trouverez plus d'informations dans le <a href="fr/Tutoriel_XUL/Barres_de_menus_simples">Tutoriel XUL</a>. +</p> +<dl><dt> Attributs +</dt><dd> <a href="#a-acceltext">acceltext</a>, <a href="#a-accesskey">accesskey</a>, <a href="#a-allowevents">allowevents</a>, <a href="#a-command">command</a>, <a href="#a-crop">crop</a>, <a href="#a-disabled">disabled</a>, <a href="#a-image">image</a>, <a href="#a-label">label</a>, <a href="#a-menuactive">menuactive</a>, <a href="#a-open">open</a>, <a href="#a-sizetopopup">sizetopopup</a>, <a href="#a-tabindex">tabindex</a>, <a href="#a-value">value</a> +</dd></dl> +<dl><dt> Propriétés +</dt><dd> <a href="#p-accessibleType">accessibleType</a>, <a href="#p-accessKey">accessKey</a>, <a href="#p-command">command</a>, <a href="#p-menuitem.control">control</a>, <a href="#p-crop">crop</a>, <a href="#p-disabled">disabled</a>, <a href="#p-image">image</a>, <a href="#p-itemCount">itemCount</a>, <a href="#p-label">label</a>, <a href="#p-labelElement">labelElement</a>, <a href="#p-menupopup">menupopup</a>, <a href="#p-menu.open">open</a>, <a href="#p-parentContainer">parentContainer</a>, <a href="#p-selected">selected</a>, <a href="#p-tabIndex">tabIndex</a>, <a href="#p-value">value</a> +</dd></dl> +<dl><dt> Méthodes +</dt><dd> <a href="#m-appendItem">appendItem</a>, <a href="#m-getIndexOfItem">getIndexOfItem</a>, <a href="#m-getItemAtIndex">getItemAtIndex</a>, <a href="#m-insertItemAt">insertItemAt</a>, <a href="#m-removeItemAt">removeItemAt</a> +</dd></dl> +<h3 id="Exemple" name="Exemple"> Exemple </h3> +<pre> <menubar id="sample-menubar"> + <menu id="file-menu" label="Fichier"> + <menupopup id="file-popup"> + <menuitem label="Nouveau"/> + <menuitem label="Ouvrir"/> + <menuitem label="Enregistrer"/> + <menuseparator/> + <menuitem label="Quitter"/> + </menupopup> + </menu> + <menu id="edit-menu" label="Édition"> + <menupopup id="edit-popup"> + <menuitem label="Annuler"/> + <menuitem label="Rétablir"/> + </menupopup> + </menu> + </menubar> +</pre> +<h3 id="Attributs" name="Attributs"> Attributs </h3> +<p> +</p><div id="a-acceltext"> + +<dl> + <dt> + <code id="a-acceltext"><a href="http://api/fr/docs/Mozilla/Tech/XUL/Attributs/acceltext">acceltext</a></code></dt> + <dd> + Type : <i>chaîne de caractères</i></dd> + <dd> + Texte qui apparaîtra à côté du label d'un <code><a href="/fr/docs/Mozilla/Tech/XUL/menu" title="menu">menu</a></code> pour indiquer la touche de raccourci (accélérateur) à utiliser pour invoquer la commande. Si cette valeur est définie, elle écrase une clé assignée dans l'attribut <code>key</code>. Cet attribut ne s'applique pas aux menus directement sur la Barre de menus (<code>menubar</code>).</dd> +</dl> +</div> +<div id="a-accesskey"> + +<dl><dt> <code id="a-accesskey"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/accesskey">accesskey</a></code></dt> +<dd> Type : <i>caractère</i> +</dd><dd> Cet attribut doit être une lettre utilisée comme touche de raccourci. Cette lettre doit être un des caractères apparaissant dans l'attribut <code><code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code></code> de l'élément. </dd></dl> +<h4 id="Exemple" name="Exemple"> Exemple </h4> +<div class="float-right"><img alt="Image:XUL_ref_accesskey_attr.png"></div> +<pre><vbox> + <label value="Entrez votre nom" accesskey="e" control="myName"/> + <textbox id="myName"/> + <button label="Annuler" accesskey="n"/> + <button label="OK" accesskey="O"/> +</vbox> +</pre> +<h4 id="Voir_.C3.A9galement" name="Voir_.C3.A9galement"> Voir également </h4> +<p>Les attributs <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> et <code id="a-acceltext"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/acceltext">acceltext</a></code> +</p> +</div> +<div id="a-allowevents"> + +<dl><dt> <code id="a-allowevents"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/allowevents">allowevents</a></code> +</dt><dd> Type : <i>booléen</i> +</dd><dd> Si défini à <code>true</code>, les évènements sont passés aux enfants de l'élément. Dans le cas contraire, ils ne sont passés qu'à l'élément lui-même. +</dd></dl> + + +</div> +<div id="a-crop"> + +<dl><dt> <code id="a-crop"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/crop">crop</a></code> +</dt><dd> Type : <i>une des valeurs ci-dessous</i> +</dd><dd> Si le label de l'élément est trop long pour être contenu dans son espace donné, le texte sera tronqué du côté indiqué par l'attribut <code>crop</code>. Une ellipse (…) sera utilisée à la place du texte tronqué. Si la direction de la boîte est inversée, le tronquage l'est également. +</dd></dl> +<ul><li> <code>start</code> : Le texte sera tronqué du côté gauche. +</li><li> <code>end</code> : Le texte sera tronqué du côté droit. +</li><li> <code>left</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Le texte sera tronqué du côté gauche. +</li><li> <code>right</code> : <span title="Cette API obsolète ne doit plus être utilisée, mais elle peut continuer à fonctionner."><i class="icon-thumbs-down-alt"> </i></span> Le texte sera tronqué du côté droit. +</li><li> <code>center</code> : Le texte sera tronqué en son milieu, en affichant le début et la fin normalement. +</li><li> <code>none</code> : Le texte ne sera pas tronqué avec une ellipse. Cependant il sera simplement coupé là où il est trop large. Le côté dépend de l'alignement CSS. +</li></ul> + + +</div> +<div id="a-disabled"> + +<dl><dt> <code id="a-disabled"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/disabled">disabled</a></code> +</dt><dd> Type : <i>booléen</i> +</dd><dd> Indique si l'élément est ou non désactivé. Si cette valeur est définie à <code>true</code>, l'élément est désactivé. Les éléments désactivés sont habituellement affichés avec leur texte grisé. Si l'élément est désactivé, il ne répond pas aux actions de l'utilisateur, il ne peut pas recevoir le focus, et l'évènement <code>command</code> ne se déclenchera pas. </dd></dl> +<p><br> +</p> +<div class="float-right"><img alt="Image:XUL_ref_attr_disabled.png"></div> +<pre><!-- La case à cocher active/désactive le bouton --> +<checkbox label="Enable button" + onclick="document.getElementById('buttRemove').disabled = this.checked"/> +<button id="buttRemove" label="Remove All" disabled="true"/> +</pre> +</div> +<div id="a-label"> + +<dl><dt> <code id="a-label"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/label">label</a></code> +</dt><dd> Type : <i>chaîne de caractères</i> +</dd><dd> Le label qui apparaîtra sur l'élément. S'il n'est pas spécifié, aucun texte n'apparaîtra. +</dd></dl> + + +</div> +<div id="a-menuactive"> + +</div> +<div id="a-open"> + +<dl><dt> <code id="a-open"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/open">open</a></code> +</dt><dd> Type : <i>booléen</i> +</dd><dd> Pour les boutons de <code id="a-type"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/type">type</a></code> <code>menu</code>, l'attribut <code>open</code> est défini à <code>true</code> lorsque le menu est ouvert. L'attribut <code>open</code> n'est pas présent si le menu est fermé. +</dd></dl> + + +</div> +<div id="a-sizetopopup"> + +</div> +<div id="a-value"> + +<dl><dt> <code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code> +</dt><dd> Type : <i>chaîne</i> +</dd><dd> Cet attribut chaîne permet d'associer une valeur de données avec un élément. Il n'est destiné à aucune utilisation particulière, mais vous pouvez y accéder avec un script pour votre usage propre.. +</dd></dl> + + +</div> + +<h3 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s"> Propriétés </h3> +<p> +</p><div id="p-accessibleType"> +<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/accessibleType">accessibleType</a></span></code> +</dt><dd> Type : <i>entier</i> +</dd><dd> Une valeur indiquant le type d'objet d'accessibilité pour l'élément. +</dd></dl> +</div> +<div id="p-menuitem.control"></div> +<div id="p-itemCount"></div> +<div id="p-menupopup"></div> +<div id="p-menu.open"></div> +<div id="p-parentContainer"></div> +<div id="p-value"> +<dl><dt> <code><span><a href="https://developer.mozilla.org/fr/docs/XUL/Propri%C3%A9t%C3%A9s/value">value</a></span></code> +</dt><dd> Type : <i>chaîne</i> +</dd><dd> Obtient et définit la valeur de l'attribut <code id="a-value"><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Attributs/value">value</a></code>. +</dd></dl> + +</div> + +<h3 id="M.C3.A9thodes" name="M.C3.A9thodes"> Méthodes </h3> +<table style="border: 1px solid rgb(204, 204, 204); margin: 0 0 10px 10px; padding: 0 10px; background: rgb(238, 238, 238); float: right; width: 250px;"> +<tbody> +<tr> +<td> +<p><strong>Héritées de XUL element</strong><br> +<small> <span id="m-blur"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/blur">blur</a></code></span>, <span id="m-click"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/click">click</a></code></span>, <span id="m-doCommand"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/doCommand">doCommand</a></code></span>, <span id="m-focus"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/focus">focus</a></code></span>, <span id="m-getElementsByAttribute"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/getElementsByAttribute">getElementsByAttribute</a></code></span> <span id="m-getElementsByAttributeNS"><code><a href="https://developer.mozilla.org/fr/docs/Mozilla/Tech/XUL/Méthodes/getElementsByAttributeNS">getElementsByAttributeNS</a></code></span></small></p> <p><strong>Héritées de DOM element</strong><br> +<small> <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.addEventListener">addEventListener()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.appendChild">appendChild()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.dispatchEvent">dispatchEvent()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.getAttribute">getAttribute()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.getAttributeNode">getAttributeNode()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.getAttributeNodeNS">getAttributeNodeNS()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.getAttributeNS">getAttributeNS()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.getElementsByTagName">getElementsByTagName()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.getElementsByTagNameNS">getElementsByTagNameNS()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.hasAttribute">hasAttribute()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.hasAttributeNS">hasAttributeNS()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.hasAttributes">hasAttributes()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.hasChildNodes">hasChildNodes()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.insertBefore">insertBefore()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.isSupported">isSupported()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.normalize">normalize()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.removeAttribute">removeAttribute()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.removeAttributeNode">removeAttributeNode()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.removeAttributeNS">removeAttributeNS()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.removeChild">removeChild()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.removeEventListener">removeEventListener()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.replaceChild">replaceChild()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.setAttribute">setAttribute()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.setAttributeNode">setAttributeNode()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.setAttributeNodeNS">setAttributeNodeNS()</a></code>, <code><a href="https://developer.mozilla.org/fr/docs/DOM/element.setAttributeNS">setAttributeNS()</a></code></small></p> + +</td> +</tr> +</tbody> +</table> + + + + + + +<h3 id="Sujets_li.C3.A9s" name="Sujets_li.C3.A9s"> Sujets liés </h3> +<dl><dt> Éléments +</dt><dd> <code><a href="/fr/docs/Mozilla/Tech/XUL/menubar" title="menubar">menubar</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menulist" title="menulist">menulist</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menupopup" title="menupopup">menupopup</a></code>, <code><a href="/fr/docs/Mozilla/Tech/XUL/menuseparator" title="menuseparator">menuseparator</a></code> +</dd></dl> +<dl><dt> Interfaces +</dt><dd> <a href="fr/NsIAccessibleProvider">nsIAccessibleProvider</a>, <a href="fr/NsIDOMXULContainerElement">nsIDOMXULContainerElement</a>, <a href="fr/NsIDOMXULContainerItemElement">nsIDOMXULContainerItemElement</a>, <a href="fr/NsIDOMXULSelectControlItemElement">nsIDOMXULSelectControlItemElement</a> +</dd></dl> |