1. Web
  2. Les API Web
  3. Document
  4. anchors

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

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

js
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 :

html
<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>
js
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

Spécification
HTML
# dom-document-anchors

Compatibilité des navigateurs

Aider à améliorer MDN

Apprendre à contribuer

Cette page a été modifiée le par les contributeur·ice·s du MDN.

AltStyle によって変換されたページ (->オリジナル) /