O aria-pressed é um atributo de acessibilidade que informa se a função de um botão de alternância está ativa. Um leitor de tela pode apresentar esse estado junto com o nome do botão, permitindo reconhecer uma opção selecionada mesmo sem enxergar sua aparência.
O estado acompanha a função
Um botão de alternância mantém uma opção ativa ou inativa entre os acionamentos. O valor true indica a opção ativa e false indica a opção inativa. Já mixed descreve estados diferentes entre os itens controlados. A ausência do atributo, cujo valor padrão é undefined, significa que o controle não informa uma alternância por esse mecanismo.
O atributo comunica o estado às tecnologias assistivas. A aplicação continua encarregada de executar a função e atualizar a apresentação visual. Acrescentar aria-pressed ao botão não cria o comportamento de alternância, conforme explica a MDN.
Um botão Silenciar com nome estável
Este exemplo mostra a marcação inicial de um controle de áudio com o som habilitado:
<button type="button" aria-pressed="false">Silenciar</button>Ao acionar o controle, a aplicação deve silenciar o áudio e mudar o atributo para true. O nome Silenciar permanece porque o estado informa que essa função está ativa. No acionamento seguinte, o som retorna e o atributo volta para false. A marcação isolada acima não implementa essas ações.
O padrão de botão do W3C orienta essa estabilidade do nome. Você pode conferir a implementação acionando o botão pelo teclado e comparando o áudio com o estado apresentado pelo leitor de tela. Caso o atributo mude e o áudio continue igual, a interface comunica uma condição que a aplicação não executou.
Dúvidas frequentes
Perguntas frequentes sobre aria-pressed
- O valor true corresponde apenas ao instante do clique?
- O valor true indica que a função da alternância está ativa. Ele permanece depois que você solta o mouse ou a tecla e muda quando a função é desativada.
- O nome do botão deve mudar junto com o estado?
- No padrão de alternância, o nome permanece estável. Um botão Silenciar usa o estado para informar se o áudio está silenciado. Um controle que alterna o nome entre Silenciar e Ativar som pode usar um botão de ação comum, sem aria-pressed.
- Quando o valor mixed faz sentido?
- Ele descreve um conjunto com estados diferentes. Um botão Negrito pode usar mixed quando a seleção reúne texto com e sem negrito. Esse valor não indica erro nem carregamento.
Para continuar
Recursos relacionados
Documentação
MDN: estado de botões de alternância
Valores aceitos pelo aria-pressed e orientação para manter o nome do botão durante a alternância.
Abrir recursoSite de referência
Dev Side Studio: Desenvolvimento Colaborativo
O Desenvolvimento Colaborativo oferece orientação técnica ao vivo para revisar a implementação e os testes de uma interface com agentes de código.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Ao revisar um botão criado com agentes de código, você precisa conferir se a função executada corresponde ao estado informado às tecnologias assistivas.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.