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, empty, emptytext, hidespinbuttons, increment, label, max, maxlength, min, multiline, newlines, onchange, oninput, preference, readonly, rows, size, spellcheck, tabindex, timeout, type, value, wrap, wraparound
- Propriétés
- accessibleType, clickSelectsAll, decimalPlaces, decimalSymbol, defaultValue, disabled, editor, emptyText, increment, inputField, label, max, maxLength, min, readOnly, selectionEnd, selectionStart, size, spinButtons, tabIndex, textLength, timeout, type, value, valueNumber, wrapAround
- Méthodes
- decrease, increase, reset, select, setSelectionRange
- Classes de style
- plain
Exemples
<vbox> <label control="your-name" value="Enter your name:"/> <textbox id="your-name" value="John"/> </vbox>
Attributs
-
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ènementcommand
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"/>
-
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 etInfinity
pour les boîtes numériques
-
min
- Type : entier
- La valeur minimum que peut prendre l'élément. La valeur par défaut est 0.
-
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'unprefwindow
. 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.
-
rows
- Type : entier
- Le nombre de lignes à afficher dans l'élément. Si l'élément contient plus que ce nombre de lignes, une barre de défilement apparaitra afin que l'utilisateur puisse consulter les autres lignes. Pour obtenir le nombre réel de lignes dans l'élément, utilisez la méthode
getRowCount
.
-
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
-
accessibleType
- Type : entier
- Une valeur indiquant le type d'objet d'accessibilité pour l'élément.
-
defaultValue
- Type : chaîne de caractères
- Définit et obtient la valeur par défaut d'une boîte de texte.
-
readonly
- Type : booléen
-
Si définie à
true
, l'utilisateur ne peut pas modifier la valeur de l'élément. -
Cette propriété toute en minuscules n'est utilisée qu'avec l'élément
preference
et sera peut-être renommée enreadOnly
dans des versions ultérieures. D'autres éléments utilisent la propriétéreadOnly
. L'attribut correspondant est cependantreadonly
en minuscules.
Méthodes
-
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.
-
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.
-
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.
-
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 <var>début</var> est le premier caractère de la sélection et l'argument <var>fin</var> 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.
Interwiki Language Links
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.
-
plain
- This class causes the element to be displayed with no border or margin.
Sujets liés
- Interfaces
- nsIAccessibleProvider, nsIDOMXULTextboxElement