scale

« Accueil de la référence XUL [ Exemples | Attributs | Propriétés | Méthodes | Sujets liés ]

Un élément scale (parfois appelé slider) permet à l'utilisateur de sélectionner une valeur dans un intervalle. Une barre affichée horizontalement ou verticalement lui permet de choisir une valeur en glissant une poignée sur la barre.

Utilisez l'attribut orient pour spécifier l'orientation de l'échelle. La valeur par défaut est <tt>horizontal</tt> qui affiche une barre horizontale. Les valeurs inférieures sont à gauche et les valeurs supérieurs à droite. Pour utiliser une échelle verticale, définissez l'attribut orient à <tt>vertical</tt>.

L'utilisateur peut utiliser les touches fléchées du clavier pour incrémenter ou décrémenter la valeur d'une unité, ou les touches <kbd>PagePréc</kbd> et <kbd>PageSuiv</kbd> pour incrémenter ou décrémenter la valeur d'une page, telle que spécifiée par l'attribut pageincrement. Les touches <kbd>Origine</kbd> et <kbd>Fin</kbd> définissent respectivement la valeur au minimum et au maximum. Un évènement change sera déclenché par l'élément chaque fois que sa valeur est modifiée.

Attributs: dir, disabled, increment, max, min, pageincrement, tabindex, value

Propriétés: disabled, max, min, increment, pageIncrement, tabIndex, value,

Méthodes: decrease, decreasePage, increase, increasePage,

Exemples

Échelle horizontale :

<scale min="1" max="10"/>

Image:Controlguide-scale.png

Échelle verticale :

<scale min="1" max="10" orient="vertical"/>

Attributs

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.

<!-- 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"/>

increment: Type : entier; La quantité dont l'attribut value (pour les boîtes numériques et les échelles) or curpos<magic name="\"PAGENAME\"/"> (pour les barres de défilement) </magic> change lorsque l'on clique sur les flèches. La valeur par défaut est 1.

min: Type : entier; La valeur minimum que peut prendre l'élément. La valeur par défaut est 0.

max: Type : entier; La valeur maximum que peut prendre l'élément scale ou number box. La valeur par défaut est 100 pour les éléments scale et Infinity pour les boîtes numériques

pageincrement: Type : entier; La quantité de laquelle la valeur de l'attribut curpos ou value change lorsque l'utilisateur clique dans la colonne de la barre de défilement (la zone dans laquelle le curseur de la barre se déplace), ou lorsque les touches PgUp ou PgDown sont utilisées. La valeur par défaut est 10.

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.

value: Type : chaîne; 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..

Propriétés

disabled: Type : booléen; Obtient et définit la valeur de l'attribut disabled.

increment: Type : entier; Obtient et définit la valeur de l'attribut increment.

min: Type : entier; Obtient et définit la valeur de l'attribut min.

max: Type : entier; Obtient et définit la valeur de l'attribut max.

pageIncrement: Type : entier; Obtient et définit la valeur de l'attribut pageincrement.

tabIndex: Type : entier; Obtient et définit la valeur de l'attribut tabindex.

value: Type : chaîne; Obtient et définit la valeur de l'attribut value.

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()

decrease(): Type de retour : aucune valeur de retour; Diminue la valeur de<magic name="\"PAGENAME\"/"> la boîte numérique l'échelle, l'échelle ou la boîte numérique</magic> de la valeur de l'incrément.

decreasePage(): Type de retour : aucune valeur de retour; Diminue la valeur de l'échelle de la valeur de pageIncrement.

increase(): Type de retour : aucune valeur de retour; Augmente la valeur de <magic name="\"PAGENAME\"/">la boîte numérique, XUL:scale = l'échelle, l'échelle ou la boîte numérique</magic> de la valeur de l'incrément.

increasePage(): Type de retour : aucune valeur de retour; Augmente la valeur de l'échelle de la valeur de pageIncrement.

Sujets liés

Interfaces: nsIDOMXULControlElement