Um nome que as tecnologias assistivas podem usar
O aria-label é um atributo que fornece um nome acessível a um elemento cujo papel permite nomeação. Esse nome identifica o elemento para tecnologias assistivas, como leitores de tela. Num botão que mostra apenas um ícone, ele pode comunicar a ação que o desenho representa.
O navegador calcula o nome acessível a partir do conteúdo e das associações do elemento. Um botão com o texto “Enviar” já pode receber esse nome do próprio conteúdo. O aria-label é útil quando não há um texto adequado para essa identificação e pode substituir o nome que viria do conteúdo do botão.
Nomear um botão que mostra um X
O botão deste exemplo apresenta um X na tela e recebe o nome acessível “Fechar aviso”:
<button type="button" aria-label="Fechar aviso"> <span aria-hidden="true">×</span></button>O aria-hidden="true" retira o desenho do cálculo do nome. O aria-label identifica o botão para a tecnologia assistiva, mas não implementa a ação de fechar o aviso. Você ainda precisa programar essa ação e conferir o nome exposto na árvore de acessibilidade do navegador.
Correspondência com o texto visível
Quando o controle já possui um texto visível adequado, preserve a nomeação pelo HTML ou associe esse texto com aria-labelledby. Um campo de formulário pode usar um label associado. Acrescentar um nome diferente do que aparece na tela pode dificultar o uso por comando de voz.
O atributo nomeia o controle, mas não corrige a sua semântica ou o comportamento pelo teclado. Um elemento genérico com aria-label não adquire as funções de um botão. O guia de nomes acessíveis da W3C detalha a escolha da técnica conforme o elemento.
Dúvidas frequentes
Perguntas frequentes sobre aria-label
- O aria-label acrescenta texto visível à página?
- O texto do atributo participa do nome acessível e não aparece visualmente na página. Instruções necessárias para compreender a interface também precisam de uma apresentação visível adequada.
- Posso aplicar aria-label a qualquer elemento?
- O papel do elemento precisa permitir um nome acessível. Um botão admite essa nomeação, mas elementos com papéis que a proíbem não devem receber aria-label.
- Qual é a diferença para aria-labelledby?
- O aria-label contém o texto do nome. O aria-labelledby referencia os IDs dos elementos que fornecem esse texto e tem precedência quando as duas formas válidas estão presentes.
Para continuar
Recursos relacionados
Documentação
MDN: nomes acessíveis com aria-label
Explicação do nome acessível, dos papéis que admitem o atributo e da preferência por um texto visível que já identifique o controle.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
Sessão de desenvolvimento colaborativo para revisar controles de interface com orientação técnica ao vivo.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A revisão de uma interface criada com agentes inclui conferir o nome acessível dos controles e sua correspondência com as ações apresentadas na tela.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.