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 支持 支持 支持 支持