mozilla
Vos résultats de recherche

    button

    Un bouton qui peut être activé par l'utilisateur. Des gestionnaires d'évènements peuvent être utilisés pour capturer des évènements souris, claviers ou autres. Un bouton est typiquement affiché sous la forme d'un rectangle gris en relief. Le label d'un bouton peut être spécifié à l'aide de l'attribut label ou en plaçant du contenu dans l'élément button.

    Vous trouverez plus d'informations dans le Tutoriel XUL.

    Attributs
    accesskey, autoCheck, checkState, checked, command, crop, dir, disabled, dlgtype, group, icon, image, label, open, orient, tabindex, type
    Propriétés
    accessKey, accessibleType, autoCheck, checkState, checked, command, crop, dir, disabled, dlgType, group, image, label, open, orient, tabIndex, type

    Exemples

    Image:XUL_ref_button.png
    <button label="Appuyez"
            oncommand="alert('Vous avez appuyé.');"/>
    

    Attributs

    accesskey
    Type : caractère
    Cet attribut doit être une lettre utilisée comme touche de raccourci. Cette lettre doit être un des caractères apparaissant dans l'attribut label de l'élément.

    Exemple

    Image:XUL_ref_accesskey_attr.png
    <vbox>	
      <label value="Entrez votre nom" accesskey="e" control="myName"/>
      <textbox id="myName"/>
      <button label="Annuler" accesskey="n"/>
      <button label="OK" accesskey="O"/>
    </vbox>
    

    Voir également

    Les attributs label et acceltext

    checked
    Type : booléen
    Indique si l'élément est coché ou non.
    Utilisez hasAttribute() pour déterminer si cet attribut est défini plutôt que getAttribute().
    Pour les boutons, l'attribut type doit etre mis à checkbox ou à radio pour qu'un effet soit perceptible.
    command
    Type : id d'élément
    Défini à la valeur de l'id d'un élément command observé par l'élément.
    crop
    Type : une des valeurs ci-dessous
    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 crop. 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.
    • start : Le texte sera tronqué du côté gauche.
    • end : Le texte sera tronqué du côté droit.
    • left : Le texte sera tronqué du côté gauche.
    • right : Le texte sera tronqué du côté droit.
    • center : Le texte sera tronqué en son milieu, en affichant le début et la fin normalement.
    • none : 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.
    dir
    Type : une des valeurs ci-dessous
    La direction dans laquelle les éléments enfants de l'élément seront placés.
    • normal : <magic name="\"PAGENAME\"/">Les valeurs de l'échelle sont triées de gauche à droite (pour les échelles horizontales) ou de haut en bas (pour les échelles verticales)., Les éléments sont placés de gauche à droite ou de haut en bas dans l'ordre dans lequel ils apparaissent dans le code XUL.)</magic>
    • reverse : Les valeurs de l'échelle sont triées de droite à gauche (pour les échelles horizontales) ou de bas en haut (pour les échelles verticales)., Les éléments sont placés de droite à gauche ou de bas en haut. C'est le contraire de l'ordre dans lequel ils apparaissent dans le code XUL.)

     

    disabled
    Type : booléen
    Indique si l'élément est ou non désactivé. Si cette valeur est définie à true, 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 command ne se déclenchera pas.


    Image:XUL_ref_attr_disabled.png
    <!-- 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"/>
    
    image
    Type : URL d'une image
    L'URL de l'image devant apparaître sur l'élément. Si cet attribut est vide ou omis, aucune image n'apparaîtra. La position de l'image est déterminée par les attributs dir et orient.
    label
    Type : chaîne de caractères
    Le label qui apparaîtra sur l'élément. S'il n'est pas spécifié, aucun texte n'apparaîtra.
    open
    Type : booléen
    Pour les boutons de type menu, l'attribut open est défini à true lorsque le menu est ouvert. L'attribut open n'est pas présent si le menu est fermé.
    orient
    Type : une des valeurs ci-dessous
    Utilisé pour spécifier si les enfants de l'élément sont orientés horizontalement ou verticalement. La valeur par défaut dépend de l'élément. Il est également possible d'utiliser la propriété de style -moz-box-orient.
    • horizontal : Les éléments enfants de l'élément sont placés les uns à côté des autres sur une ligne dans l'ordre de leur apparition dans le code source XUL.
    • vertical : Les éléments enfants de l'élément sont placés les uns en dessous des autres sur une colonne dans l'ordre de leur apparition dans le code source XUL.
    tabindex
    Type : entier
    L'ordre de tabulation de l'élément. L'ordre de tabulation est l'ordre dans lequel le focus se déplace lorsque l'utilisateur appuie sur la touche « tab ». Les éléments dont le tabindex est plus haut se trouvent plus tard dans la séquence de tabulation.

    Propriétés

    accessKey
    Type : caractère
    Obtient et définit la valeur de l'attribut accesskey.


    accessibleType
    Type : entier
    Une valeur indiquant le type d'objet d'accessibilité pour l'élément.
    crop
    Type : chaîne de caractères
    Obtient et définit la valeur de l'attribut crop.
    dir
    Type : chaîne de caractères
    Obtient et définit la valeur de l'attribut dir.
    disabled
    Type : booléen
    Obtient et définit la valeur de l'attribut disabled.
    image
    Type : URL d'image
    Obtient et définit la valeur de l'attribut image.
    label
    Type : chaîne de caractères
    Obtient et définit la valeur de l'attribut label.
    open
    Type : booléen
    Obtient et définit la valeur de l'attribut open.
    orient
    Type : chaîne de caractères
    Obtient et définit la valeur de l'attribut orient.
    tabIndex
    Type : entier
    Obtient et définit la valeur de l'attribut tabindex.
    type
    Type : chaîne de caractères
    Obtient et définit la valeur de l'attribut type.

    Méthodes

    Héritées de XUL element
    blur, click, doCommand, focus, getElementsByAttribute

    Héritées de DOM element
    addEventListener(), appendChild(), dispatchEvent(), getAttribute(), getAttributeNode(), getAttributeNodeNS(), getAttributeNS(), getElementsByTagName(), getElementsByTagNameNS(), hasAttribute(), hasAttributeNS(), hasAttributes(), hasChildNodes(), insertBefore(), isSupported(), normalize(), removeAttribute(), removeAttributeNode(), removeAttributeNS(), removeChild(), removeEventListener(), replaceChild(), setAttribute(), setAttributeNode(), setAttributeNodeNS(), setAttributeNS()

    Sujets liés

    Interfaces
    nsIAccessibleProvider, nsIDOMXULButtonElement

    Étiquettes et contributeurs liés au document

    Étiquettes : 
    Contributors to this page: BenoitL, lmorchard
    Dernière mise à jour par : lmorchard,