HTMLAnchorElement : propriété relList
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 octobre 2018.
La propriété en lecture seule relList de l'interface HTMLAnchorElement retourne un objet DOMTokenList dynamique contenant l'ensemble des types de liens indiquant la relation entre la ressource représentée par l'élément HTML <a> et le document courant. Elle reflète l'attribut rel de l'élément HTML <a>.
Valeur
Un objet DOMTokenList dynamique.
Bien que la propriété relList elle-même soit en lecture seule dans le sens où vous ne pouvez pas remplacer l'objet DOMTokenList, vous pouvez toujours affecter directement à la propriété relList, ce qui équivaut à affecter à sa propriété value. Vous pouvez également modifier l'objet DOMTokenList en utilisant les méthodes add(), remove(), replace() et toggle().
Exemples
const ancres = document.getElementsByTagName("a");
for (const ancre of ancres) {
const list = ancre.relList;
console.log(
`Nouvel élément d'ancre trouvé avec ${list.length} types de liens dans relList.`,
);
list.forEach((valeurRel) => {
console.log(valeurRel);
});
}
Spécifications
| Spécification |
|---|
| HTML # dom-a-rellist |
Compatibilité des navigateurs
Voir aussi
- Propriété équivalente pour les éléments HTML
<area>et<link>:HTMLAreaElement.relListetHTMLLinkElement.relList. - La même liste mais sous forme de jetons séparés par des espaces dans une chaîne :
HTMLAnchorElement.rel