HTMLInputElement

Propriétés d'instance

Hérite également des propriétés de son interface parente, HTMLElement.

Certaines propriétés ne s'appliquent qu'aux types d'éléments <input> qui prennent en charge les attributs correspondants.

HTMLInputElement.align Obsolète

Une chaîne de caractères qui représente l'alignement de l'élément. On utilisera CSS à la place.

HTMLInputElement.alpha Expérimental

Un booléen qui représente l'attribut alpha de l'élément, indiquant si la composante alpha de la couleur peut être manipulée par l'utilisateur·ice et n'a pas besoin d'être complètement opaque.

HTMLInputElement.colorSpace Expérimental

Une chaîne de caractères qui représente l'attribut colorspace de l'élément, indiquant le espace colorimétrique de la couleur CSS sérialisée (sRGB ou display-p3).

HTMLInputElement.defaultValue

Une chaîne de caractères qui permet de lire ou d'écrire la valeur par défaut telle qu'originellement indiquée dans le HTML à l'origine de cet objet.

HTMLInputElement.dirName

Une chaîne de caractères qui permet de lire ou d'écrire le sens d'écriture de l'élément.

HTMLInputElement.incremental Non standard

Un booléen qui représente le mode de déclenchement de l'évènement de recherche, s'il vaut true, il est déclenché à chaque frappe, ou lors du clic sur le bouton d'annulation ; sinon, il est déclenché lors de l'appui sur Entrée.

HTMLInputElement.labels Lecture seule

Retourne une liste d'éléments HTML <label> utilisés comme libellés pour cet élément.

HTMLInputElement.list Lecture seule

Retourne l'élément ciblé par l'attribut list. Cette propriété peut valoir null si aucun élément HTML n'a été trouvé dans le même arbre.

HTMLInputElement.multiple

Un booléen qui permet de lire ou d'écrire l'attribut multiple de l'élément qui indique que plusieurs valeurs sont possibles (par exemple pour sélectionner plusieurs fichiers).

HTMLInputElement.name

Une chaîne de caractères qui permet de lire ou d'écrire l'attribut name de l'élément qui indique le nom identifiant l'élément lors de l'envoi du formulaire.

HTMLInputElement.popoverTargetAction

Permet de lire et d'écrire l'action à effectuer ("hide", "show", ou "toggle") sur une fenêtre contextuelle contrôlée par un élément <input> de type="button". Cette propriété reflète la valeur de l'attribut HTML popovertargetaction.

HTMLInputElement.popoverTargetElement

Permet de lire et d'écrire l'élément fenêtre contextuelle à contrôler via un élément <input> de type="button". Équivalent JavaScript de l'attribut HTML popovertarget.

HTMLInputElement.step

Une chaîne de caractères qui permet de lire ou d'écrire l'attribut step de l'élément. Cet attribut fonctionne avec les attributs min et max pour limiter l'incrément d'une valeur numérique ou temporelle. Elle peut être la chaîne de caractères any ou un nombre décimal positif. Si la valeur n'est pas any, le contrôle acceptera uniquement les multiples de l'incrément depuis la valeur minimale.

HTMLInputElement.type

Une chaîne de caractères qui permet de lire ou d'écrire type de l'élément qui indique le type de contrôle à afficher. Voir la documentation de type pour les valeurs possibles.

HTMLInputElement.useMap Obsolète

Une chaîne de caractères qui représente une carte d'images côté client.

HTMLInputElement.value

Une chaîne de caractères qui permet de lire ou d'écrire la valeur contenue dans le contrôle. Si l'utilisatrice ou l'utilisateur saisit une valeur différente de la valeur attendue, cette propriété pourra renvoyer une chaîne vide.

HTMLInputElement.valueAsDate

Un objet Date qui permet de lire ou d'écrire la valeur de l'élément interprétée comme une date, ou null si la conversion n'est pas possible.

HTMLInputElement.valueAsNumber

Une valeur numérique double qui retourne la valeur de l'élément interprété dans l'ordre comme : une valeur temporelle, un nombre, ou NaN si la conversion est impossible

Propriétés d'instance relatives au formulaire parent

HTMLInputElement.form Lecture seule

Retourne la référence à l'élément <form> parent.

HTMLInputElement.formAction

Une chaîne de caractères qui permet de lire ou d'écrire l'attribut formaction de l'élément, qui contient l'URI d'un programme traitant les informations envoyées avec l'élément. Cet attribut HTML surcharge l'attribut action du formulaire parent.

HTMLInputElement.formEnctype

Une chaîne de caractères qui permet de lire ou d'écrire l'attribut formenctype de l'élément, qui contient le type de contenu utilisé pour envoyer le formulaire au serveur. Cet attribut HTML surcharge l'attribut enctype du formulaire parent.

HTMLInputElement.formMethod

Une chaîne de caractères qui permet de lire ou d'écrire l'attribut formmethod de l'élément, qui contient la méthode HTTP utilisée par le navigateur pour envoyer le formulaire. Cet attribut HTML surcharge l'attribut method du formulaire parent.

HTMLInputElement.formNoValidate

Un booléen qui permet de lire ou d'écrire l'attribut formnovalidate de l'élément, qui indique que le formulaire n'a pas à être validé lors de l'envoi. Cet attribut HTML surcharge l'attribut novalidate du formulaire parent.

HTMLInputElement.formTarget

Une chaîne de caractères qui permet de lire ou d'écrire l'attribut formtarget de l'élément, qui contient un nom ou un mot-clé indiquant où afficher la réponse reçue après l'envoi du formulaire. Cet attribut HTML surcharge l'attribut target du formulaire parent.

Propriétés d'instance qui s'appliquent à tous les éléments <input> qui ne sont pas masqués

HTMLInputElement.disabled

Un booléen qui permet de lire ou d'écrire l'attribut disabled de l'élément, qui indique qu'on ne peut pas interagir avec le contrôle. La valeur du champ ne sera pas envoyée avec le formulaire. Voir aussi readonly.

HTMLInputElement.required

Un booléen qui permet de lire ou d'écrire l'attribut required de l'élément, qui indique que le champ doit être renseigné avant de pouvoir envoyer le formulaire.

HTMLInputElement.validationMessage Lecture seule

Une chaîne de caractères qui retourne un message localisé qui décrit les éventuelles contraintes de validation qu'il doit respecter. Cette propriété aura la chaîne vide comme valeur si le contrôle ne participe pas à la validation des contraintes (c'est-à-dire si willValidate vaut false), ou s'il respecte les contraintes. Cette valeur peut être définie avec la méthode setCustomValidity().

HTMLInputElement.validity Lecture seule

Retourne un objet ValidityState qui traduit l'état de validité courant de l'élément.

HTMLInputElement.willValidate Lecture seule

Un booléen qui indique si l'élément participe à la validation des contraintes. Il vaut false si au moins une condition empêche la validation de contrainte, incluant : l'attribut type qui vaut hidden, reset, ou button, la présence d'un ancêtre <datalist>, ou la propriété disabled à true.

Propriétés d'instance seulement pour les éléments de type checkbox et radio

HTMLInputElement.checked

Un booleén qui permet de lire ou d'écrire l'état actuel de l'élément.

HTMLInputElement.defaultChecked

Un booléen qui permet de lire ou d'écrire l'état par défaut du bouton radio ou de la case à cocher, tel qu'initialement indiqué en HTML par l'attribut default.

HTMLInputElement.indeterminate

Un booléen qui indique si la case à cocher ou le bouton radio est dans un état indéterminé. Pour les cases à cocher, cela se traduit par une case grisée d'une certaine façon (la case n'est ni cochée ni décochée). Cette propriété n'affecte pas la valeur de l'attribut checked, et cliquer sur la case à cocher la passera à false (décochée).

Propriétés d'instance seulement pour les éléments de type image

HTMLInputElement.alt

Une chaîne de caractères qui permet de lire ou d'écrire l'attribut alt de l'élément, qui contient le texte alternatif à utiliser à la place de l'image.

HTMLInputElement.height

Une chaîne de caractères qui permet de lire ou d'écrire l'attribut height de l'élément, qui définit la hauteur de l'image affichée sur le bouton.

HTMLInputElement.src

Une chaîne de caractères qui permet de lire ou d'écrire l'attribut src de l'élément, qui définit l'URI d'un emplacement d'image à afficher sur le bouton graphique.

HTMLInputElement.width

Une chaîne de caractères qui permet de lire ou d'écrire l'attribut width de l'élément, qui définit la largeur de l'image affichée sur le bouton.

Propriétés d'instance seulement pour les éléments de type file

HTMLInputElement.accept

Une chaîne de caractères qui permet de lire ou d'écrire l'attribut accept de l'élément, qui contient une liste de types de fichier, séparés par des virgules, qu'on peut sélectionner.

HTMLInputElement.capture

Une chaîne de caractères qui représente l'attribut capture de l'élément, indiquant la méthode d'entrée de capture média dans les contrôles de téléchargement de fichiers.

HTMLInputElement.files

Un objet FileList qui permet de manipuler la liste des objets File qui représente les fichiers sélectionnés pour le téléversement.

HTMLInputElement.webkitdirectory Non standard

Un booléen qui retourne la valeur de l'attribut webkitdirectory de l'élément. S'il vaut true, cela indique que l'interface du sélecteur de fichier n'acceptera que les répertoires (plutôt que les fichiers).

HTMLInputElement.webkitEntries Non standard

Un tableau FileSystemEntry qui décrit les fichiers ou répertoires actuellement sélectionnés.

Propriétés d'instance qui s'appliquent aux éléments visibles contenant du texte ou des nombres

HTMLInputElement.autocomplete

Une chaîne de caractères qui permet de lire ou d'écrire l'attribut autocomplete de l'élément, qui indique si la valeur du contrôle peut être automatiquement complétée par le navigateur.

HTMLInputElement.max

Une chaîne de caractères qui permet de lire ou d'écrire l'attribut max de l'élément, qui contient la valeur maximale (numérique ou temporelle) de la valeur pour ce champ. Cette valeur ne doit pas être inférieure à la valeur minimale portée par l'attribut min.

HTMLInputElement.maxLength

Une valeur numérique de type unsigned long qui permet de lire ou d'écrire l'attribut maxlength de l'élément, qui contient le nombre maximal de caractères (exprimés en codets Unicode) que doit contenir la valeur.

HTMLInputElement.min

Une chaîne de caractères qui permet de lire ou d'écrire l'attribut min de l'élément, qui contient la valeur minimale (numérique ou temporelle) de la valeur pour ce champ. Cette valeur ne doit pas être supérieure à la valeur maximale portée par l'attribut max.

HTMLInputElement.minLength

Une valeur numérique de type unsigned long qui permet de lire ou d'écrire l'attribut maxlength de l'élément, qui contient le nombre minimal de caractères (exprimés en codets Unicode) que doit contenir la valeur.

HTMLInputElement.pattern

Une chaîne de caractères qui permet de lire ou d'écrire l'attribut pattern de l'élément, qui contient une expression rationnelle contre laquelle la valeur du contrôle est testée. On utilisera l'attribut title afin de décrire le motif à respecter. Cet attribut s'applique uniquement lorsque l'attribut type vaut text, search, tel, url, ou email.

HTMLInputElement.placeholder

Une chaîne de caractères qui permet de lire ou d'écrire l'attribut placeholder de l'élément, qui contient une indication fournie à l'utilisatrice ou à l'utilisateur quant à ce qui peut être saisi dans le contrôle. Le texte d'indication ne doit pas contenir de retour chariot ou de passage à la ligne. Cet attribut s'applique uniquement lorsque l'attribut type vaut text, search, tel, url, ou email.

HTMLInputElement.readOnly

Un booléen qui permet de lire ou d'écrire l'attribut readonly de l'élément, qui indique qu'il n'est pas possible de modifier la valeur du contrôle. Cet attribut est ignoré si l'attribut type vaut hidden, range, color, checkbox, radio, file, ou button.

HTMLInputElement.selectionDirection

Une chaîne de caractères qui permet de lire ou d'écrire la direction selon laquelle la sélection est effectuée. Les valeurs possibles sont : forward (la sélection a été effectuée dans le sens d'écriture de la locale courante), backward (le sens opposé), ou none (la direction est inconnue).

HTMLInputElement.selectionEnd

Une valeur numérique de type unsigned long qui permet de lire ou d'écrire l'indice de fin pour le texte sélectionné. Lorsqu'il n'y a aucune sélection, cette propriété retourne le décalage du caractère qui suit immédiatement le curseur pour le champ texte actuel.

HTMLInputElement.selectionStart

Une valeur numérique de type unsigned long qui permet de lire ou d'écrire l'indice de début pour le text sélectionné. Lorsqu'il n'y a aucune sélection, cette propriété retourne la position du curseur de saisie à l'intérieur de l'élément <input>.

HTMLInputElement.size

Une valeur numérique de type unsigned long qui permet de lire ou d'écrire l'attribut size de l'élément, qui contient la taille visuelle du contrôle. La valeur est exprimée en pixels à moins que type vaille text ou password, auquel cas il s'agit du nombre de caractères. Cet attribut s'applique uniquement lorsque l'attribut type vaut text, search, tel, url, email, ou password.

Méthodes d'instance

Hérite également des méthodes de son interface parente, HTMLElement.

HTMLInputElement.checkValidity()

Retourne un booléen qui vaut false si l'élément est candidat à la validation des contraintes et ne respecte pas ses contraintes. Dans ce cas, il déclenche également un évènement invalid sur l'élément. Il retourne true si l'élément n'est pas candidat à la validation des contraintes, ou s'il respecte ses contraintes.

HTMLInputElement.reportValidity()

Exécute la méthode checkValidity() et, si celle‑ci retourne faux (contrôle invalide ou absence de l'attribut motif), signale à l'utilisateur·ice que le contrôle est invalide de la même manière que lors de l'envoi d'un formulaire.

HTMLInputElement.select()

Sélectionne tout le texte de l'élément de saisie et lui donne la sélection afin que l'utilisateur·ice puisse ensuite remplacer l'intégralité de son contenu.

HTMLInputElement.setCustomValidity()

Définit un message de validité personnalisé pour l'élément. Si ce message n'est pas la chaîne vide, l'élément souffre d'une erreur de validité personnalisée et n'est pas valide.

HTMLInputElement.setRangeText()

Remplace une plage de texte de l'élément de saisie par un nouveau texte.

HTMLInputElement.setSelectionRange()

Sélectionne une plage de texte dans l'élément de saisie (mais ne lui donne pas la sélection).

HTMLInputElement.showPicker()

Affiche le sélecteur du navigateur pour la date, l'heure, la couleur et les fichiers.

HTMLInputElement.stepDown()

Décrémente la valeur value de (step * n), où n vaut 1 par défaut si non défini.

HTMLInputElement.stepUp()

Incrémente la valeur value de (step * n), où n vaut 1 par défaut si non défini.

Évènements

Hérite également des évènements de son interface parente, HTMLElement.

Pour écouter ces évènements, utilisez addEventListener() ou affectez un gestionnaire d'évènements à la propriété oneventname de cette interface :

L'évènement cancel

Déclenché lorsque l'utilisateur·ice annule la boîte de dialogue du sélecteur de fichiers via la touche Échap ou le bouton d'annulation, ou lorsqu'il·elle re‑sélectionne les mêmes fichiers précédemment sélectionnés.

L'évènement invalid

Déclenché lorsqu'un élément ne respecte pas ses contraintes lors de la validation des contraintes.

L'évènement search Non standard

Déclenché lorsqu'une recherche est initiée sur un <input> de type="search".

L'évènement select

Déclenché lorsqu'une portion de texte a été sélectionnée.

L'évènement selectionchange

Déclenché lorsque la sélection du texte à l'intérieur d'un élément <input> a changé.

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'élément HTML implémentant cette interface : <input>