Document: anchors property
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("DOM")}}
The **anchors** read-only property of the {{domxref("Document")}} interface returns a list of all of the anchors in the document.
Value
An {{domxref("HTMLCollection")}}.
Examples
Basic usage
js
if (document.anchors.length >= 5) {
console.log("found too many anchors");
}Creating a table of contents
The following is an example that auto populates a Table of Contents with every anchor on the page:
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);
}{{EmbedLiveSample("Creating a table of contents", "", 500)}}
Notes
For reasons of backwards compatibility, the returned set of anchors only contains those anchors created with the name attribute, not those created with the id attribute.
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}