此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

document.images

基线 广泛可用

自 2018年6月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

Document 接口的只读属性 images 返回当前文档中所有 image 元素的集合。

语法

var imageCollection = document.images;

一个 HTMLCollection,提供了包含在该文档中的所有 images 元素实时的列表。集合中的每条代表了一个单 image 元素的HTMLImageElement

备注

你可以在返回的结果中使用 JavaScript 数组符号 ('[]',译注),或者item() 方法去获取集合中的每个元素。下面方法是等价的:

js
firstImage = imageCollection.item(0);

firstImage = imageCollection[0];

例子

该例是一次通过遍历图片列表找到名称为"banner.gif"的图片。

js
var ilist = document.images;
for (var i = 0; i < ilist.length; i++) {
  if (ilist[i].src == "banner.gif") {
    // 发现了 banner 图片
  }
}

规范

规范
HTML
# dom-document-images-dev

浏览器兼容性