Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

HTMLImageElement.alt — texto alternativo da imagem

HTMLImageElement.alt lê e define o texto que substitui uma imagem. A propriedade reflete o atributo alt; uma cadeia vazia e a ausência do atributo não significam o mesmo.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

image.alt
image.alt = "Replacement text";

HTMLImageElement.alt é uma propriedade DOMString gravável que reflete o atributo alt de um elemento img. A leitura devolve o respetivo valor e a atribuição atualiza o atributo. Se o atributo não existir, a leitura devolve "".

O texto deve substituir o significado da imagem no contexto, em vez de apenas descrever o seu aspeto. Para uma imagem decorativa ou que repete informação próxima, utiliza image.alt = "". A ausência do atributo não equivale a um valor vazio. alt não é uma dica de contexto como title.

O exemplo distingue a ausência do atributo de um valor vazio através de hasAttribute("alt") e demonstra a alteração visível com getAttribute("alt"). Executa-o num navegador: trata-se de uma interface do DOM HTML, não de uma funcionalidade da linguagem ECMAScript. A presença do Node 24 no repositório não comprova a disponibilidade desta interface.

Exemplos

const image = document.createElement("img");
console.log(JSON.stringify([image.alt, image.hasAttribute("alt")]));

image.alt = "Orange cat sleeping";
console.log(image.getAttribute("alt"));

image.alt = "";
console.log(JSON.stringify([image.alt, image.hasAttribute("alt")]));

Resultado

["",false]
Orange cat sleeping
["",true]

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes