Propriedade alt da imagem

Objeto Image do DOM HTML

Definição e uso

alt Propriedade que define ou retorna o valor Propriedade alt do valor.

Se a imagem não puder ser exibida por alguma razão (por exemplo, por causa da lentidão da conexão, erro no atributo src ou uso de leitores de tela), esta propriedade necessária Propriedade alt Define o texto alternativo da imagem.

Nota:Quando o mouse estiver sobre o elemento <img>, o Internet Explorer exibirá o valor da propriedade alt como uma dica de ferramenta. De acordo com a especificação HTML, isso não é um comportamento correto. Todos os outros navegadores seguem a especificação e exibem o texto alternativo apenas quando a imagem não puder ser exibida.

Dica:Se você deseja criar uma dica de ferramenta para a imagem, use o global Atributo title.

Exemplo

Exemplo 1

Retornar o texto alternativo da imagem:

var x = document.getElementById("myImg").alt;

Experimente você mesmo

Exemplo 2

Alterar o texto alternativo da imagem:

document.getElementById("myImg").alt = "Beijing Scenery";

Experimente você mesmo

Sintaxe

Retornar a propriedade alt:

imageObject.alt

Definir a propriedade alt:

imageObject.alt = text

Valor do atributo

Valor Descrição
text

Define o texto alternativo da imagem.

Guia de texto alternativo:

  • Se a imagem contiver informações, o texto deve descrever a imagem
  • Se a imagem estiver dentro de um elemento <a>, o texto deve explicar a posição do link
  • Se a imagem é usada apenas para decorar, use alt=""

Detalhes técnicos

Retorno: Valor de string, representando o texto alternativo da imagem.

Suporte ao navegador

Chrome Edge Firefox Safari Opera
Chrome Edge Firefox Safari Opera
Suporte Suporte Suporte Suporte Suporte

Páginas relacionadas

Manual de referência do HTML:Atributo alt do <img> do HTML

Objeto Image do DOM HTML