longdesc 用來指向一個「詳細描述頁面」,當 alt 的空間不足以說清楚圖片或框架內容時,就用它連結到更完整的說明。以下示範讀取這個屬性。
<!DOCTYPE html>
<html>
<body>
<iframe id="myframe" src="/default.asp" longdesc="cnblogs.com">
<p>Your browser does not support iframes.</p>
</iframe>
<p>The URL of the long description is:
<script>
document.write(document.getElementById("myframe").longDesc);
</script>
<p>
</body>
</html>上述程式碼會輸出:The URL of the long description is: cnblogs.com
longdesc 在 img 與 iframe 上都是 HTML5 中已被移除的屬性(obsoleted and removed),而非僅是不建議使用。現代瀏覽器多已不支援,iframe.longDesc 可能回傳空字串,因此不應在新專案中使用。
它被移除的原因並不是這個需求不存在,而是實作上的問題:longdesc 指向的頁面不會自動呈現給使用者,多數人根本不知道它的存在;螢幕閱讀器對它的支援也普遍不佳,導致「有設定等於沒設定」。
若 iframe 或圖片的內容需要長篇描述,目前有幾種可靠做法:
1. 用 aria-describedby 指向同頁的說明段落
// HTML
<img src="chart.png" alt="2026 第一季營收下滑"
aria-describedby="chart-detail">
<p id="chart-detail">
第一季總營收較去年同期減少 8%,主要受海外訂單遞延影響……
</p>這個方式對螢幕閱讀器友善,且說明文字對所有人都可見。
2. 用普通連結明確提供「詳細說明」
<iframe id="myframe" src="/report" title="年度營收報告"></iframe> <p><a href="/report/description">閱讀本報告的文字版說明</a></p>
這是最簡單也最可靠的方式——連結所有人都看得到、都能點。
3. 為 iframe 加上 title 屬性
var frame = document.getElementById("myframe");
frame.title = "年度營收報告,含各區細節統計";iframe 的 title 是必需的,不是可選項。螢幕閱讀器在列出頁面框架時,會唸出這個 title 作為該框架的名稱;缺少它,使用者只會聽到一串無法辨識的網址。
var frame = document.getElementById("myframe");
frame.getAttribute('longdesc'); // 仍有屬性時可讀,回傳字串或 null
frame.title; // 推薦使用的替代屬性
frame.getAttribute('title');總結:longdesc 可以當作前端演進史的一個案例來理解,但實作無障礙描述時,請一律採用 aria-describedby 加上可見的說明連結。另外別忘了移除範例中的 document.write——它在文件載入後呼叫會清空整頁。