Attention : Le contenu de ces pages n'a pas été mis à jour depuis longtemps. Il est probablement obsolète pour Firefox 4.0/Gecko 4.0 et supérieur. Pour du contenu plus récent, allez consulter developer.mozilla.org.

Textbox

Champ de texte permettant à l'utilisateur de rentrer du texte. Ce contrôle est similaire à l'élément <input type="edit"> de l'HTML.

Attributs de la balise

disabled

Si cet attribute est à « true », le contrôle est désactivé, c'est à dire qu'il va généralement se déssiner en grisé, et qu'il n'est pas utilisable. Omettre cet attribut revient toujours à activer le contrôle.

focused

Si cet attribut est à « true », le contrôle a le focus, et réciproquement.

maxlength

Le nombre maximum de caractères autorisés à être entrés.

multiline

Autorise le contrôle à gérer le multi-ligne. Lorsque l'utilisateur appuiera sur ENTRÉE, le contrôle créera alors une nouvelle ligne.

oninput

Cette évenement est envoyé lorsque l'utilisateur change le texte de la textbox. Cet évènement est seulement appelé si le texte affiché change, il n'est donc pas appelé lors de l'appui de touche non affichable.

readonly

Si à « true », l'utilisateur ne peux plus changer la valeur de la textbox. Mais cette valeur reste modifiable par un script.

size

Le nombre de caractères affichables dans la textbox.

type

Il existe plusieurs valeurs possibles :

password
pour créer un champ de type mot de passe, cachant ce qui est tapé
autocomplete
pour créer une textbox gérant l'autocomplétion
text
pour une textbox standard

value

La valeur par défaut entrée dans la textbox. Cet attribut retient la valeur par défaut et n'est pas modifié lorsque l'utilisateur entre du texte. Pour récupérer la nouvelle valeur, il faut utiliser la propriété « value ».

ontextentered

Utile pour appeler une fonction qui sera exécuter lors de la sélection d'un valeur dans la liste déroulante générer par les textbox de type "autocomplete". La fonction sera aussi appelée si la textbox a le focus et que la toucher entrer est pressée.

wrap

Propriétés Javascript

controllers

disabled

Récupère et fixe la valeur de l'attribut disabled.

maxlength

Récupère et fixe la valeur de l'attribut maxlength.

readonly

Récupère et fixe la valeur de l'attribut readonly.

selectionEnd

Récupère ou fixe la fin de la sélection de texte. Utilisée en conjonction avec selectionStart, cette valeur représente l'index du caractère après la sélection. Si cette valeur est équale à selectionStart, alors aucun texte n'est sélectionné, mais la valeur indique la position du curseur dans la textbox.

selectionStart

Récupère ou fixe le début de la sélection de texte. Utilisée en conjonction avec selectionEnd, cette valeur représente l'index du premier caractère de la sélection.

size

Récupère et fixe la valeur de l'attribut size.

textLength

Contient la taille du texte saisie dans la textbox. Cette propriété est en lecture seule.

type

Récupère et fixe la valeur de l'attribut type.

value

Récupère et fixe la valeur de l'attribut value.

Méthodes Javascript

setSelectionRange ( start , end )

Fixe la sélection courante.

;start: index du premier caractère de la sélection ;end: index du caractère juste après la fin de la sélection

Fixer les deux arguments à la même valeur place le curseur à cette position.

Description complète

Références

http://www.xulplanet.com/references/elem(..)

Bogues

  1. Lorsque l'attribut multiline est à true la valeur de l'élément n'apparait pas. La solution consiste pour l'instant à définir la valeur avec Javascript. http://bugzilla.mozilla.org/show_bug.cgi(..) (devrait être résolu dans Mozilla 1.6)

Copyright © 2003-2013 association xulfr, 2013-2016 Laurent Jouanneau - Informations légales.

Mozilla® est une marque déposée de la fondation Mozilla.
Mozilla.org™, Firefox™, Thunderbird™, Mozilla Suite™ et XUL™ sont des marques de la fondation Mozilla.