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

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

HTMLInputElement.alpha

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

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

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

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'utilisateur·ice saisit une valeur différente de la valeur attendue, cette propriété peut retourner une chaîne de caractères 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 n'est 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é a la chaîne de caractères 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 booléen qui permet de lire ou d'écrire l'état actuel de l'élément.