Dokument: anchors-Eigenschaft
Deprecated
Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.
Die schreibgeschützte anchors-Eigenschaft des Document-Interface gibt eine Liste aller Anker im Dokument zurück.
Wert
Ein HTMLCollection.
Beispiele
Grundlegende Nutzung
js
if (document.anchors.length >= 5) {
console.log("found too many anchors");
}
Erstellen eines Inhaltsverzeichnisses
Das folgende Beispiel füllt ein Inhaltsverzeichnis automatisch mit jedem Anker auf der Seite:
html
<h1>Title</h1>
<h2><a name="contents">Contents</a></h2>
<ul id="toc"></ul>
<h2><a name="plants">Plants</a></h2>
<ol>
<li>Apples</li>
<li>Oranges</li>
<li>Pears</li>
</ol>
<h2><a name="veggies">Veggies</a></h2>
<ol>
<li>Carrots</li>
<li>Celery</li>
<li>Beats</li>
</ol>
js
const toc = document.getElementById("toc");
for (const anchor of document.anchors) {
const li = document.createElement("li");
const newAnchor = document.createElement("a");
newAnchor.href = `#${anchor.name}`;
newAnchor.textContent = anchor.text;
li.appendChild(newAnchor);
toc.appendChild(li);
}
Hinweise
Aus Gründen der Rückwärtskompatibilität enthält die zurückgegebene Menge an Ankern nur diejenigen Anker, die mit dem name-Attribut erstellt wurden, nicht diejenigen, die mit dem id-Attribut erstellt wurden.
Spezifikationen
| Spezifikation |
|---|
| HTML # dom-document-anchors |