HTML DOM Document images 属性

定义和用法

images 属性返回文档中所有 <img> 元素的集合。

images 属性返回 HTMLCollection。

images 属性是只读的。

提示：images 属性不返回 type="image" 的 <input> 元素。

HTMLCollection

HTMLCollection 是 HTML 元素的类似数组的集合（列表）。

可以通过索引访问集合中的元素（从 0 开始）。

length 属性返回集合中元素的数量。

另请参阅：

Image

HTML <img> 标签

HTML 图像教程

实例

例子 1

文档中 <img> 元素的数量：

document.images.length;

亲自试一试

例子 2

遍历所有 <img> 元素，并输出每个元素的 URL (src)：

const myImages = document.images;
let text = "";
for (let i = 0; i < myImages.length; i++) {
  text += myImages[i].src + "<br>";
}

亲自试一试

例子 3

第一个 <img> 元素的 URL 是：

document.images[0].src;

亲自试一试

例子 4

第一个 <img> 元素的 URL 是：

document.images.item(0).src;

亲自试一试

例子 5

id="myImg" 的 <img> 元素的 URL 是：

document.images.namedItem("myImg").src;

亲自试一试

例子 6

为第一个 <img> 元素添加黑色边框：

document.images[0].style.border = "10px dotted black";

亲自试一试

语法

document.images

属性

属性 描述
length 集合中 <img> 元素的数量。

方法

方法 描述
[index]

返回有指定索引的元素（从 0 开始）。

如果索引超出范围，则返回 null。
item(index)

返回有指定索引的元素（从 0 开始）。

如果索引超出范围，则返回 null。
namedItem(id)

返回有指定 id 的元素。

如果 id 不存在，则返回 null。

返回值

类型 描述
对象

HTMLCollection 对象。

文档中的所有 <img> 元素。

按照它们在源代码中出现的顺序进行排序。

浏览器支持

document.images 是 DOM Level 1 (1998) 特性。

所有浏览器都支持它：

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
支持 9-11 支持 支持 支持 支持