Vos résultats de recherche

textbox

Dans cet article

« 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, 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è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.

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

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'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.

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.

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.

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

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

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 en readOnly dans des versions ultérieures. D'autres éléments utilisent la propriété readOnly. L'attribut correspondant est cependant readonly en minuscules.

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

type: Type : chaîne de caractères; Obtient et définit la valeur de l'attribut type.

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.

« 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 <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

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

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

Étiquettes et contributeurs liés au document

Étiquettes :

Contributeurs à cette page : lmorchard, BenoitL, *.Har(d)t

Dernière mise à jour par : lmorchard, 14 juin 2012 à 18:12:07