document.links 回傳文檔中所有擁有 href 屬性的 <a> 與 <area> 元素組成的 **HTMLCollection** (即時集合)。本文示範如何取得第一個連結的 id 屬性,並延伸相關操作。
const firstLinkId = document.links[0]?.id; // 可選鏈防報錯
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>第一個連結 ID</title>
</head>
<body>
<h1>sharejs.com</h1>
<img src="planets.gif" width="145" height="126" alt="Planets" usemap="#planetmap">
<map name="planetmap">
<area id="sun" shape="rect" coords="0,0,82,126" href="sun.htm" alt="Sun">
<area id="mercury" shape="circle" coords="90,58,3" href="mercur.htm" alt="Mercury">
<area id="venus" shape="circle" coords="124,58,8" href="venus.htm" alt="Venus">
</map>
<p><a id="javascript" href="/js/">JavaScript Tutorial</a></p>
<p>第一個連結/區域 ID:<span id="output"></span></p>
<script>
const firstLink = document.links[0];
document.getElementById('output').textContent = firstLink ? firstLink.id : '無連結';
</script>
</body>
</html>
輸出:sun (因 <area> 在 DOM 順序上先於 <a>)。
| 特性 | 說明 |
|---|---|
| 元素類型 | <a href>、<area href> (映射圖熱點) |
| 集合類型 | HTMLCollection (即時、類陣列、不可疊代器) |
| 順序 | 文檔順序 (DFS 深度優先) |
| 長度 | document.links.length |
| 索引存取 | document.links[i] |
| 名稱存取 | document.links['name'] (對應 name 或 id) |
const urls = Array.from(document.links).map(a => a.href);
console.log(urls);
Array.from(document.links).forEach(a => {
if (a.hostname !== location.hostname) {
a.target = '_blank';
a.rel = 'noopener noreferrer';
}
});
const observer = new MutationObserver(() => {
const newLinks = [...document.links].filter(l => !l.dataset.processed);
newLinks.forEach(l => { l.dataset.processed = '1'; /* 初始化 */ });
});
observer.observe(document.body, { childList: true, subtree: true });
| 集合 | 包含元素 | 即時性 | 典型用途 |
|---|---|---|---|
| document.links | <a href>, <area href> | 即時 | 導航、外連處理、站點地圖 |
| document.anchors | <a name> (錨點,**已棄用**,HTML5 改用 id) | 即時 | 舊式頁內跳轉 |
| document.querySelectorAll('a[href]') | <a href> (不含 area) | 靜態快照 | 現代選擇器、需篩選屬性 |
<a> **無 href 不計入** document.links (如 <a name="anchor"> 或純 JS 觸發器)。id 可能為空字串,link.id 回傳 "",非 null。Array.from() 轉陣列再處理。document.links 中。document.links[0].id 即可取得文檔順序第一個超連結/熱點區域的 ID。現代開發推薦 document.querySelector('a[href], area[href]') 語意更明確、回傳單一元素、支援複雜選擇器。理解 HTMLCollection 即時特性與 <area> 也屬於 links 集合,能避免「以為第一個是 <a> 實際是 <area>」的誤區。