HTMLOutputElement

Propriétés d'instance

Cette interface hérite aussi des propriétés de son parent, HTMLElement.

HTMLOutputElement.defaultValue

Une chaîne de caractères représentant la valeur par défaut de l'élément, initialement la chaîne vide.

HTMLOutputElement.form Lecture seule

Un objet HTMLFormElement indiquant le formulaire associé au contrôle, reflétant l'attribut HTML form s'il est défini.

HTMLOutputElement.htmlFor Lecture seule

Un objet DOMTokenList reflétant l'attribut HTML for, contenant une liste d'identifiants d'autres éléments du même document qui contribuent (ou affectent) la valeur calculée de value.

HTMLOutputElement.labels Lecture seule

Un objet NodeList d'éléments HTML <label> associés à l'élément.

HTMLOutputElement.name

Une chaîne de caractères reflétant l'attribut HTML name, contenant le nom du contrôle envoyé avec les données du formulaire.

HTMLOutputElement.type Lecture seule

La chaîne de caractères "output".

HTMLOutputElement.validationMessage Lecture seule

Une chaîne de caractères représentant un message localisé décrivant les contraintes de validation non satisfaites (le cas échéant). Chaîne vide si le contrôle n'est pas candidat à la validation de contraintes (willValidate est false), ou s'il satisfait ses contraintes.

HTMLOutputElement.validity Lecture seule

Un objet ValidityState représentant les états de validité de cet élément.

HTMLOutputElement.value

Une chaîne de caractères représentant la valeur du contenu de l'élément. Se comporte comme la propriété Node.textContent.

HTMLOutputElement.willValidate Lecture seule

Retourne une valeur booléenne indiquant si l'élément est candidat à la validation de contraintes. Toujours false pour les objets HTMLOutputElement.

Méthodes d'instance

Cette interface hérite aussi des méthodes de son parent, HTMLElement.

HTMLOutputElement.checkValidity()

Vérifie la validité de l'élément et retourne une valeur booléenne indiquant le résultat du test.

HTMLOutputElement.reportValidity()

Cette méthode signale à l'utilisateur·ice les problèmes de contraintes sur l'élément, le cas échéant. S'il y a des problèmes, déclenche un évènement invalid sur l'élément et retourne false ; s'il n'y a pas de problème, retourne true.

Lorsque le problème est signalé, l'agent utilisateur peut sélectionner l'élément et faire défiler le document ou effectuer une autre action pour attirer l'attention de l'utilisateur·ice. Les agents utilisateurs peuvent signaler plusieurs violations de contraintes si cet élément présente plusieurs problèmes à la fois. Si l'élément n'est pas affiché, l'agent utilisateur peut signaler l'erreur pour le script en cours d'exécution au lieu de notifier l'utilisateur·ice.

HTMLOutputElement.setCustomValidity()

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

Modes

Cet élément fonctionne selon deux modes : le mode par défaut et le mode valeur.

Mode par défaut

Initialement, l'élément est en mode par défaut, donc le contenu de l'élément représente à la fois la valeur de l'élément et sa valeur par défaut.

Si l'élément est en mode par défaut lorsque les descendants de l'élément sont modifiés de quelque manière que ce soit, la propriété defaultValue est définie sur la valeur de la propriété textContent.

Réinitialiser le formulaire place l'élément en mode par défaut et définit la propriété textContent sur la valeur de la propriété defaultValue.

Mode valeur

L'élément passe en mode valeur lorsque la propriété value est définie. La propriété value se comporte alors comme la propriété textContent. Lorsque l'élément est en mode valeur, la valeur par défaut n'est accessible que via la propriété defaultValue.

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'élément HTML qui implémente cette interface : <output>.