XUL:scale

Un article de MDC.

« 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 horizontal 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 à vertical.

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 PagePréc et PageSuiv pour incrémenter ou décrémenter la valeur d'une page, telle que spécifiée par l'attribut pageincrement. Les touches Origine et Fin 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,

[modifier] Exemples

Échelle horizontale :

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

Échelle verticale :

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

[modifier] Attributs

Hérités de XUL element align, allowevents, allownegativeassertions, class, coalesceduplicatearcs, collapsed, container, containment, context, contextmenu, datasources, dir, empty, equalsize, flags, flex, height, hidden, id, insertafter, insertbefore, left, maxheight, maxwidth, menu, minheight, minwidth, mousethrough, observes, ordinal, orient, pack, persist, popup, position, preference-editable, querytype, ref, removeelement, sortDirection, sortResource, sortResource2, statustext, style, template, tooltip, tooltiptext, top, uri, wait-cursor, width

dir

Type : une des valeurs ci-dessous

La direction dans laquelle les éléments enfants de l'élément seront placés.

• normal : Les valeurs de l'échelle sont triées de gauche à droite (pour les échelles horizontales) ou de haut en bas (pour les échelles verticales).
• 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).

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.

increment

Type : entier

La quantité dont l'attribut curpos (pour les barres de défilement) ou value (pour les boîtes numériques) 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 scale. La valeur par défaut est 0.

max

Type : entier

La valeur maximum que peut prendre l'élément scale. La valeur par défaut est 100.

pageincrement

Type : entier

La quantité dont la valeur de l'attribut value change lorsque les touches PagePréc ou PageSuiv sont pressé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..

[modifier] Propriétés

Héritées de XUL element align, allowEvents, boxObject, builder, className, collapsed, contextMenu, controllers, currentItem, database, datasources, dir, flex, height, hidden, id, left, listBoxObject, maxHeight, maxWidth, menu, minHeight, minWidth, observes, ordinal, orient, pack, persist, ref, resource, statusText, style, tooltip, tooltipText, top, value, width Héritées de DOM element attributes, childNodes, cloneNode, firstChild, lastChild, localName, namespaceURI, nextSibling, nodeName, nodeType, nodeValue, ownerDocument, parentNode, prefix, previousSibling, tagName

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.

[modifier] 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 l'échelle 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 l'échelle 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.

[modifier] Sujets liés

Interfaces

nsIDOMXULControlElement