document.images 收錄頁面上所有的 <img> 元素,依文件出現順序排列。取索引 0 再讀 id,就是第一張圖片的 id。
<!DOCTYPE html> <html> <body> <img id="klematis lilac" border="0" src="klematis.jpg" width="148" height="112"> <img id="klematis pink" border="0" src="klematis2.jpg" width="149" height="118"> <p>Id of first image: <script> document.write(document.images[0].id); </script> </p> </body> </html>
執行結果:
Id of first image:klematis lilac
順帶說一下,範例裡的 id="klematis lilac" 其實是不合法的寫法——HTML 規範中 id 不可包含空白。瀏原意圖大概是想表達「品種 + 顏色」這種描述性資訊,那應該用 class 承載多個值,或用 data- 屬性:
<img id="img1" class="klematis lilac" data-variety="klematis" data-color="lilac" src="klematis.jpg" alt="鐵炮百合(紫丁香色)">
document.images[0].id // 第一張圖
document.images.length // 圖片總數
document.images["img1"] // 用 name 或 id 取值(舊式)
document.querySelector("img").id // 建議寫法
document.querySelectorAll("img")[0].id // 等效
只有 <img> 會被算進去。CSS 背景圖、<picture> 裡的 <source>、SVG 內的圖形、canvas 畫的內容,都不在 document.images 裡。要處理背景圖得從 getComputedStyle() 讀 background-image。
圖片可能還沒載完。如果腳本在 <head> 就執行,document.images 可能是空的,而且即使取到元素,naturalWidth 還是 0。要做跟尺寸或載入狀態相關的處理,請等事件:
window.addEventListener("load", function () {
var imgs = document.images;
for (var i = 0; i < imgs.length; i++) {
console.log(imgs[i].id, imgs[i].naturalWidth, imgs[i].complete);
}
});
實務上做圖片延遲載入(lazy loading)時,與其自己在 JS 裡算位置,不如直接用原生屬性 loading="lazy",並為每張圖補上有意義的 alt 文字——這對螢幕閱讀器使用者是必要的,純裝飾性的圖片則給 alt="" 讓輔具跳過。