scale

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.


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

Étiquettes et contributeurs liés au document

Étiquettes :
Contributeurs ayant participé à cette page : BenoitL, lmorchard, Mgjbot
Dernière mise à jour par : BenoitL,