Texto alternativo para imagens
Um arabesco decorativo e um gráfico de vendas usam ambos o elemento img, mas o alt certo para o primeiro é uma string vazia e para o segundo é uma frase completa.
Para que serve o texto alternativo
Um leitor de tela transforma uma página em fala ou braile. Quando chega a uma imagem, ele não consegue olhar os pixels, então lê o atributo alt. O mesmo texto aparece quando uma imagem não carrega, e é o que um buscador ou um navegador só de texto recebe. A WCAG 2.2 põe isso em primeiro lugar: o critério de sucesso 1.1.1 Conteúdo Não Textual, de nível A, pede que toda imagem, ícone ou gráfico que traz informação tenha uma alternativa em texto que sirva ao mesmo propósito.
As palavras-chave são "o mesmo propósito". O texto alternativo não é uma legenda nem uma lista de tudo o que aparece no quadro. Pergunte o que um leitor que enxerga tira da imagem naquele lugar e escreva isso. A foto de um pão na página inicial de uma padaria talvez precise só de "Pão de fermentação natural, fatiado". A mesma foto num artigo sobre a cor da casca talvez precise de "Pão de fermentação natural com casca escura, quase preta, e miolo aberto". Mesmo arquivo, outra função, outro texto.
Quatro casos comuns
O tutorial de imagens do W3C divide a maioria das imagens em alguns grupos. Imagens informativas, como uma foto ou um diagrama simples, recebem uma descrição curta do que mostram. Imagens decorativas, como uma linha divisória ou uma textura de fundo, recebem um alt vazio, escrito alt="", que diz à tecnologia assistiva para pulá-las. Imagens funcionais, como um logotipo que leva à página inicial ou uma lupa que envia uma busca, recebem um texto que diz o que acontece: "Corner Bakery, página inicial" ou "Buscar", e não "logotipo" ou "lupa". Imagens de texto recebem as palavras da imagem.
Deixar o atributo de fora não é o mesmo que deixá-lo vazio. Sem alt nenhum, alguns leitores de tela recorrem ao nome do arquivo, e quem ouve pode escutar algo como "IMG underscore 4032 ponto jpeg". Um alt vazio é uma escolha deliberada que diz "não há nada para ver aqui". Para um gráfico complexo, mantenha o alt curto ("Gráfico de barras das vendas mensais, descrito abaixo") e ponha os números numa tabela ou num parágrafo ao lado, onde todos possam lê-los.
Imagens que não são elementos img
As imagens também podem chegar como SVG inline ou como imagens de fundo do CSS. Um fundo do CSS não tem lugar nenhum para texto alternativo, então só deve ser usado para decoração; tudo o que traz significado pertence ao HTML. Um svg inline que é pura decoração pode ser escondido com aria-hidden="true", o que a unidade 6 explica. A WCAG não define limite de caracteres para o texto alternativo, mas o tutorial do W3C volta sempre ao mesmo conselho: seja breve e dê o que importa naquele contexto. Se você está escrevendo três frases, o conteúdo provavelmente deveria estar no texto da página, onde todos podem lê-lo.
Você pode conferir as suas próprias páginas sem programa especial. Veja o código-fonte da página e procure <img: cada resultado deve ter um atributo alt, vazio ou não. As ferramentas de desenvolvedor dos principais navegadores também têm um painel de acessibilidade que mostra o nome que cada imagem acaba recebendo. Ler esses nomes em sequência, fora de contexto, é um bom teste. Se uma lista diz "imagem, imagem, gráfico, logotipo", quem usa leitor de tela ouve exatamente isso.
| WCAG 1.1.1 | Conteúdo Não Textual, nível A: alternativas em texto para imagens com significado |
| alt="" | Decorativa: a tecnologia assistiva pula a imagem |
| Imagem funcional | Descreva a ação ou o destino |
| Imagem de texto | O alt repete as palavras da imagem |
| Alt ausente | Alguns leitores de tela leem o nome do arquivo |
| Gráfico complexo | Alt curto mais os dados num texto ou numa tabela por perto |
- O texto alternativo dá o propósito da imagem no lugar dela na página.
- Imagens decorativas recebem alt="", e não um atributo ausente.
- Links e botões feitos de imagem precisam de um alt que diga a ação.
- Dados longos ficam num texto ou numa tabela ao lado da imagem.
- Qual critério de sucesso da WCAG 2.2 trata das alternativas em texto?
- 1.1.1 Conteúdo Não Textual
- 1.4.3 Contraste (Mínimo)
- 2.1.1 Teclado
- 3.3.2 Rótulos ou Instruções
- Uma linha ondulada que só separa duas seções deve ter
- alt=""
- alt="linha ondulada"
- nenhum atributo alt
- alt="imagem"
- Uma imagem de lupa é o único conteúdo do botão de busca. Qual é o melhor alt?
- Buscar
- Lupa
- Ícone
- Lupa azul sobre branco
- O que pode acontecer quando o alt falta completamente?
- Alguns leitores de tela leem em voz alta o nome do arquivo
- A imagem fica escondida
- A página não carrega
- O navegador inventa uma descrição
- Uma imagem de banner mostra as palavras "Open 7 am to 6 pm". O alt dela deve ser
- Open 7 am to 6 pm
- Banner
- Imagem do horário de funcionamento
- alt=""
- Por que evitar começar o alt com "imagem de"?
- Os leitores de tela já dizem que é uma imagem
- Quebra o HTML
- Os buscadores proíbem
- Deixa a imagem maior
- Qual atributo guarda a alternativa em texto de uma imagem?
- Onde devem ficar os números de um gráfico detalhado?
- Numa tabela ou num texto perto do gráfico
- Todos dentro do atributo alt
- Em lugar nenhum, o gráfico basta
- No nome do arquivo
- O texto alternativo é a mesma coisa que uma legenda?
- Não, o alt substitui a imagem; a legenda é um texto visível a mais
- Sim, sempre
- Só no celular
- Só para fotos
Fontes deste curso (9)
- W3C, Web Content Accessibility Guidelines (WCAG) 2.2, W3C Recommendation first published 5 October 2023, current edition 12 December 2024 (w3.org/TR/WCAG22/, checked 2026-10-17, rechecked 2026-10-18)
- W3C WAI, What's new in WCAG 2.2 (w3.org/WAI/standards-guidelines/wcag/new-in-22/, checked 2026-10-17)
- W3C WAI, Images tutorial and alt decision tree (w3.org/WAI/tutorials/images/decision-tree/, checked 2026-10-17)
- W3C, Using ARIA (w3.org/TR/using-aria/, Discontinued Draft 24 February 2026, rules 1 to 4, checked 2026-10-17)
- W3C WAI-ARIA Authoring Practices Guide, Read Me First, "No ARIA is better than bad ARIA" (w3.org/WAI/ARIA/apg/practices/read-me-first/, checked 2026-10-17)
- MDN Web Docs, tabindex (developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/tabindex, checked 2026-10-17)
- MDN, Heading elements, accessibility notes (developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/Heading_Elements, checked 2026-10-17)
- MDN, autocomplete attribute (developer.mozilla.org/en-US/docs/Web/HTML/Reference/Attributes/autocomplete, checked 2026-10-17)
- Every code exercise was checked with a Playwright probe against a reference solution.
Data de verificação: 2026-10-17