HTML DOM Document links 属性

定义和用法

links 属性返回文档中所有链接的集合。

links 属性返回 HTMLCollection。

links 属性是只读的。

集合中的链接代表拥有 href 属性的 <a> 和 <area> 元素。

另请参阅：

HTML DOM Anchor 对象

HTML DOM Area 对象

HTML <a> 标签

HTML <area> 标签

HTML 链接

HTMLCollection

HTMLCollection 是 HTML 元素的类似数组的集合（列表）。

可以通过索引访问集合中的元素（从 0 开始）。

length 属性返回集合中元素的数量。

实例

例子 1

返回文档中的链接数：

let numb = document.links.length;

亲自试一试

例子 2

获取文档中第一个链接的 URL：

let url = document.links[0].href;

亲自试一试

例子 3

获取文档中第一个链接的 URL：

let url = document.links.item(0).href;

亲自试一试

例子 4

获取 id="myLink" 元素的 URL：

let url = document.links.namedItem("myLink").href;

亲自试一试

例子 5

为文档中的第一个链接添加红色边框：

document.links[0].style.border = "5px solid red";

亲自试一试

例子 6

遍历所有链接并输出每个链接的 URL（href）：

const links = document.links;
let text = "";
for (let i = 0; i < links.length; i++) {
  text += links[i].href + "<br>";
}

亲自试一试

语法

document.links

属性

属性 描述
length 集合中元素的数量。

方法

方法 描述
[index]

返回有指定索引的元素（从 0 开始）。

如果索引超出范围，则返回 null。
item(index)

返回有指定索引的元素（从 0 开始）。

如果索引超出范围，则返回 null。
namedItem(id)

返回有指定 id 的元素。

如果 id 不存在，则返回 null。

返回值

类型 描述
对象

HTMLCollection 对象。

文档中的所有 <a> 和 <area> 元素。

按照它们在源代码中出现的顺序进行排序。

浏览器支持

document.links 是 DOM Level 1 (1998) 特性。

所有浏览器都支持它：

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
支持 9-11 支持 支持 支持 支持