Dokument: anchors-Eigenschaft

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

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

Specification
HTML
# dom-document-anchors

Browser-Kompatibilität