HTMLOutputElement

Constructeur

HTMLOutputElement()

Cre un nouvel objet HTMLOutputElement.

Proprits d'instance

Cette interface hrite aussi des proprits de son parent, HTMLElement.

HTMLOutputElement.defaultValue

Une chane de caractres reprsentant la valeur par dfaut de l'lment, initialement la chane vide.

HTMLOutputElement.form Lecture seule

Un objet HTMLFormElement indiquant le formulaire associ au contrle, refltant l'attribut HTML form s'il est dfini.

HTMLOutputElement.htmlFor Lecture seule

Un objet DOMTokenList refltant l'attribut HTML for, contenant une liste d'identifiants d'autres lments du mme document qui contribuent (ou affectent) la valeur calcule de value.

HTMLOutputElement.labels Lecture seule

Un objet NodeList d'lments HTML <label> associs l'lment.

HTMLOutputElement.name

Une chane de caractres refltant l'attribut HTML name, contenant le nom du contrle envoy avec les donnes du formulaire.

HTMLOutputElement.type Lecture seule

La chane de caractres "output".

HTMLOutputElement.validationMessage Lecture seule

Une chane de caractres reprsentant un message localis dcrivant les contraintes de validation non satisfaites (le cas chant). Chane vide si le contrle n'est pas candidat la validation de contraintes (willValidate est false), ou s'il satisfait ses contraintes.

HTMLOutputElement.validity Lecture seule

Un objet ValidityState reprsentant les tats de validit de cet lment.

HTMLOutputElement.value

Une chane de caractres reprsentant la valeur du contenu de l'lment. Se comporte comme la proprit Node.textContent.

HTMLOutputElement.willValidate Lecture seule

Retourne une valeur boolenne indiquant si l'lment est candidat la validation de contraintes. Toujours false pour les objets HTMLOutputElement.

Mthodes d'instance

Cette interface hrite aussi des mthodes de son parent, HTMLElement.

HTMLOutputElement.checkValidity()

Vrifie la validit de l'lment et retourne une valeur boolenne indiquant le rsultat du test.

HTMLOutputElement.reportValidity()

Cette mthode signale l'utilisateurice les problmes de contraintes sur l'lment, le cas chant. S'il y a des problmes, dclenche un vnement invalid sur l'lment et retourne false ; s'il n'y a pas de problme, retourne true.

Lorsque le problme est signal, l'agent utilisateur peut slectionner l'lment et faire dfiler le document ou effectuer une autre action pour attirer l'attention de l'utilisateurice. Les agents utilisateurs peuvent signaler plusieurs violations de contraintes si cet lment prsente plusieurs problmes la fois. Si l'lment n'est pas affich, l'agent utilisateur peut signaler l'erreur pour le script en cours d'excution au lieu de notifier l'utilisateurice.

HTMLOutputElement.setCustomValidity()

Dfinit un message de validit personnalis pour l'lment. Si ce message n'est pas une chane vide, l'lment prsente une erreur de validit personnalise et n'est pas valide.

Modes

Cet lment fonctionne selon deux modes : le mode par dfaut et le mode valeur.

Mode par dfaut

Initialement, l'lment est en mode par dfaut, donc le contenu de l'lment reprsente la fois la valeur de l'lment et sa valeur par dfaut.

Si l'lment est en mode par dfaut lorsque les descendants de l'lment sont modifis de quelque manire que ce soit, la proprit defaultValue est dfinie sur la valeur de la proprit textContent.

Rinitialiser le formulaire place l'lment en mode par dfaut et dfinit la proprit textContent sur la valeur de la proprit defaultValue.

Mode valeur

L'lment passe en mode valeur lorsque la proprit value est dfinie. La proprit value se comporte alors comme la proprit textContent. Lorsque l'lment est en mode valeur, la valeur par dfaut n'est accessible que via la proprit defaultValue.

Spcifications

Spcification
HTML # htmloutputelement

Compatibilit des navigateurs

Voir aussi

• L'lment HTML qui implmente cette interface : <output>.