Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLLabelElement : propriété htmlFor

Baseline
Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

La propriété htmlFor de l'interface HTMLLabelElement est l'identifiant de l'élément de contrôle associé au label. Elle reflète la valeur de la propriété de contenu for et est utilisée pour définir et lire cette valeur.

Valeur

Une chaîne de caractères qui contient l'identifiant de l'élément associé au contrôle.

Description

Un HTMLLabelElement doit être associé à un élément de contrôle afin que cliquer sur le label active le contrôle. L'attribut for, reflété dans la propriété htmlFor, doit contenir un id de l'élément de contrôle associé.

Note : Si cette propriété a une valeur, la propriété HTMLLabelElement.control doit référencer le même contrôle.

L'attribut htmlFor fournit un accès JavaScript à la valeur de l'attribut for. htmlFor est utilisé à la place de for pour éviter les conflits avec le mot réservé JavaScript for (ceci n'est plus strictement nécessaire, donc cela peut changer à l'avenir (angl.)).

Exemples

Utilisation simple

Dans cet exemple, la valeur de l'attribut for de l'élément <label> est username, qui est lié à l'élément <input> via son attribut id. Nous utilisons la propriété DOM htmlFor pour accéder à la valeur de l'attribut for.

html
<label for="username">Entrez votre nom d'utilisateur&nbsp;:</label>
<input id="username" name="username" type="text" />
js
document.querySelector("label").htmlFor;
// username

Spécifications

Spécification
HTML
# dom-label-htmlfor

Compatibilité des navigateurs

Voir aussi