A propriedade HTML DOM Document images

Definição e uso

images A propriedade retorna a coleção de todos os elementos <img> do documento.

images O atributo retorna HTMLCollection.

imageO atributo s é somente leitura.

Dica:A propriedade images não retorna elementos <input> com type="image".

HTMLCollection

HTMLCollection é uma coleção de elementos HTML semelhante a um array (lista).

Os elementos na coleção podem ser acessados por índice (começando em 0).

length O atributo retorna o número de elementos na coleção.

Veja também:

Imagem

Etiqueta <img> do HTML

Tutorial de Imagem HTML

Exemplo

Exemplo 1

Número de elementos <img> no documento:

document.images.length;

Experimente você mesmo

Exemplo 2

Percore todos os elementos <img> e imprime o URL (src) de cada um:

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

Experimente você mesmo

Exemplo 3

O URL do primeiro <img> elemento é:

document.images[0].src;

Experimente você mesmo

Exemplo 4

O URL do primeiro <img> elemento é:

document.images.item(0).src;

Experimente você mesmo

Exemplo 5

O URL do elemento <img> com id="myImg" é:

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

Experimente você mesmo

Exemplo 6

Adicionar borda preta ao primeiro <img> elemento:

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

Experimente você mesmo

Sintaxe

document.images

Atributos

Atributos Descrição
length Número de elementos <img> na coleção.

Métodos

Métodos Descrição
[item(]

index

retorna o elemento com o índice especificado (começando em 0).
)item(namedItem(

index

retorna o elemento com o índice especificado (começando em 0).
se o índice estiver fora do intervalo, retorna null.senamedItem(

) se retorna o elemento com o nome especificado

do elemento. se id

Se não existir, retorna null.

Tipo Descrição
Objeto

Objeto HTMLCollection.

Todos os elementos <img> no documento.

classificadas na ordem em que aparecem no código-fonte.

Suporte do navegador

document.images é uma característica do DOM Level 1 (1998).

Todos os navegadores suportam isso:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Suporte 9-11 Suporte Suporte Suporte Suporte