文档:anchors 属性

已弃用:此特性不再推荐。虽然某些浏览器可能仍然支持它,但它可能已经从相关的网络标准中删除,可能正在删除过程中,或者可能仅为兼容性目的而保留。请避免使用它,如果可能,请更新现有代码;请参阅本页底部的兼容性表格以指导您的决策。请注意,此特性可能随时停止工作。

Document 接口的只读属性 anchors 返回文档中所有锚点的列表。

一个 HTMLCollection

示例

基本用法

js
if (document.anchors.length >= 5) {
  console.log("found too many anchors");
}

创建目录

以下示例将自动填充页面上每个锚点的目录:

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);
}

注意

出于向后兼容的原因,返回的锚点集合仅包含使用 name 属性创建的锚点,而不包含使用 id 属性创建的锚点。

规范

规范
HTML
# dom-document-anchors

浏览器兼容性