Document : propriété anchors
Obsolète: Cette fonctionnalité n'est plus recommandée. Même si certains navigateurs la prennent encore en charge, elle a peut-être déjà été supprimée des standards du web, est en passe d'être supprimée ou n'est conservée qu'à des fins de compatibilité. Évitez de l'utiliser et mettez à jour le code existant si possible ; consultez le tableau de compatibilité au bas de cette page pour vous aider à prendre votre décision. Sachez que cette fonctionnalité peut cesser de fonctionner à tout moment.
La propriété en lecture seule anchors de l'interface Document retourne une liste de toutes les ancres du document.
Valeur
Un objet HTMLCollection.
Exemples
Exemple simple
if (document.anchors.length >= 5) {
console.log("a trouvé beaucoup trop d'ancres");
}
Créer une table des matières
L'exemple suivant remplit automatiquement une table des matières avec chaque ancre présente sur la page :
<h1>Titre</h1>
<h2><a name="contents">Contenus</a></h2>
<ul id="tdm"></ul>
<h2><a name="plants">Plantes</a></h2>
<ol>
<li>Pommes</li>
<li>Oranges</li>
<li>Poires</li>
</ol>
<h2><a name="veggies">Légumes</a></h2>
<ol>
<li>Carottes</li>
<li>Céleri</li>
<li>Betteraves</li>
</ol>
const tdm = document.getElementById("tdm");
for (const ancre of document.anchors) {
const li = document.createElement("li");
const nouvelleAncre = document.createElement("a");
nouvelleAncre.href = `#${ancre.name}`;
nouvelleAncre.textContent = ancre.text;
li.appendChild(nouvelleAncre);
tdm.appendChild(li);
}
Notes
Pour des raisons de rétrocompatibilité, la liste d'ancres retournée contient seulement les ancres créées avec l'attribut name, pas celles créées avec l'attribut id.
Spécification
| Specification |
|---|
| HTML # dom-document-anchors |