XUL:textbox

Un article de MDC.

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

Un champ dans lequel l'utilisateur peut entrer du texte. Il est similaire à l'élément HTML input. Par défaut, une seule ligne de texte est affichée. L'attribut multiline peut être spécifié pour afficher un champ multiligne.

Vous trouverez plus d'informations dans le Tutoriel XUL.

Attributs

cols, decimalplaces, disabled, textbox.empty, emptytext, hidespinbuttons, increment, textbox.label, max, maxlength, min, multiline, newlines, textbox.onchange, oninput, preference, readonly, rows, size, spellcheck, tabindex, timeout, textbox.type, textbox.value, wrap, wraparound

Propriétés

accessibleType, clickSelectsAll, decimalPlaces, decimalSymbol, defaultValue, disabled, editor, emptyText, increment, inputField, textbox.label, max, maxLength, min, readOnly, selectionEnd, selectionStart, size, spinButtons, tabIndex, textLength, timeout, type, textbox.value, valueNumber, wrapAround

Méthodes

decrease, increase, reset, select, setSelectionRange

Classes de style

plain

[modifier] Exemples

<vbox>
<label control="your-name" value="Enter your name:"/>
<textbox id="your-name" value="John"/>
</vbox>

[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

XUL:Attributs:cols XUL:Attributs:decimalplaces

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.

XUL:Attributs:textbox.empty XUL:Attributs:emptytext XUL:Attributs:hidespinbuttons

increment Nouveau dans Firefox 3

Type : entier

La quantité dont l'attribut value change lorsque l'on clique sur les flèches. La valeur par défaut est 1.

XUL:Attributs:textbox.label

max Nouveau dans Firefox 3

Type : entier

La valeur maximum que peut prendre l'élément number box. La valeur par défaut est Infinity.

XUL:Attributs:maxlength

min Nouveau dans Firefox 3

Type : entier

La valeur minimum que peut prendre l'élément number box. La valeur par défaut est 0.

XUL:Attributs:multiline XUL:Attributs:newlines XUL:Attributs:textbox.onchange XUL:Attributs:oninput

preference

Type : id d'élément

Connecte l'élément à une préférence (élément preference) correspondante. Cet attribut n'a d'effet qu'utilisé au sein d'un prefwindow. La valeur de la préférence sera mise à jour pour correspondre à la propriété value de l'élément.

readonly

Type : booléen

Si défini à true, l'utilisateur ne peut pas modifier la valeur de l'élément. Cependant, celle-ci peut toujours être modifiée par un script.

XUL:Attributs:rows XUL:Attributs:size XUL:Attributs:spellcheck

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.

XUL:Attributs:timeout XUL:Attributs:textbox.type XUL:Attributs:textbox.value XUL:Attributs:wrap XUL:Attributs:wraparound

[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

XUL:Propriétés:accessibleType XUL:Propriétés:clickSelectsAll XUL:Propriétés:decimalPlaces XUL:Propriétés:decimalSymbol

defaultValue Nouveau dans Firefox 3

Type : chaîne de caractères

Définit et obtient la valeur par défaut d'une boîte de texte.

disabled

Type : booléen

Obtient et définit la valeur de l'attribut disabled.

XUL:Propriétés:editor XUL:Propriétés:emptyText

increment

Type : entier

Obtient et définit la valeur de l'attribut increment.

XUL:Propriétés:inputField XUL:Propriétés:textbox.label

max

Type : entier

Obtient et définit la valeur de l'attribut max.

XUL:Propriétés:maxLength

min

Type : entier

Obtient et définit la valeur de l'attribut min.

readOnly

Type : booléen

Si définie à true, permet à l'utilisateur de modifier la valeur de l'élément.

XUL:Propriétés:selectionEnd XUL:Propriétés:selectionStart XUL:Propriétés:size XUL:Propriétés:spinButtons

tabIndex

Type : entier

Obtient et définit la valeur de l'attribut tabindex.

XUL:Propriétés:textLength XUL:Propriétés:timeout

type

Type : chaîne de caractères

Obtient et définit la valeur de l'attribut type.

XUL:Propriétés:textbox.value XUL:Propriétés:valueNumber XUL:Propriétés:wrapAround

[modifier] Méthodes

decrease()

Type de retour : aucune valeur de retour

Diminue la valeur de la boîte numérique de la valeur de l'incrément.

increase()

Type de retour : aucune valeur de retour

Augmente la valeur de la boîte numérique de la valeur de l'incrément.

reset()

Type de retour : aucune valeur renvoyée

Réinitialise la préférence à sa valeur par défaut.

Pour un élément textbox, la liste de transactions d'annulation est également vidée (Gecko 1.9).

select()

Type retourné : aucune valeur retournée

Sélectionne l'intégralité du texte d'une boîte texte.

« Accueil de la référence XUL

setSelectionRange( début, fin )

Type retourné : aucune valeur retournée

Cette méthode sélectionne une portion de texte dans une zone de texte (textbox ou textarea) où l'argument début est le premier caractère de la sélection et l'argument fin le dernier caractère de la sélection.

Renseigner les deux arguments avec la même valeur équivaut à déplacer le curseur d'écriture sans rien sélectionner.

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

[modifier] Classes de style

Les classes suivantes peuvent être utilisées pour styler l'élément. Ces classes devraient être utilisées au lieu de changer le style de l'élément directement, car elles s'accorderont plus naturellement avec le thème sélectionné par l'utilisateur.

Modèle:XULStyleInc

[modifier] Sujets liés

Interfaces

nsIAccessibleProvider, nsIDOMXULTextboxElement