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

CKTIS / HTML

aria-pressed — estado persistente de um botão de alternância

`aria-pressed` distingue um botão de alternância de um botão comum que executa um comando pontual.

Versão: WAI-ARIA 1.2

Sintaxe

<button aria-pressed="false">Bold</button>

Num botão, usa true, false ou mixed. Um estado ausente indica um botão comum. O estado misto pode descrever definições diferentes num grupo, não uma tecla mantida fisicamente premida.

Mantém um nome estável, como Bold, e atualiza separadamente estado e efeito visível. Um botão nativo oferece ativação básica por teclado, mas ARIA não acrescenta lógica de alternância nem estilo. Não uses esta propriedade em vez do estado assinalado de uma caixa de seleção.

O exemplo altera o peso do texto e o estado do botão numa função. O teste verifica o estado premido na árvore de acessibilidade e o peso de letra calculado de 700. Assim demonstra tanto a descrição para tecnologias de apoio como uma alteração visual real.

Exemplos

<!doctype html><meta charset="utf-8">
<style>.bold {font-weight:700} #sample:not(.bold) {font-weight:400}</style>
<button id="bold" aria-pressed="false">Bold</button><p id="sample">Selected text</p>
<output id="result"></output>
<script>
const button = document.querySelector('#bold'), sample = document.querySelector('#sample');
button.addEventListener('click', () => {
  const pressed = button.getAttribute('aria-pressed') !== 'true';
  button.setAttribute('aria-pressed', String(pressed)); sample.classList.toggle('bold', pressed);
});
button.click();
document.querySelector('#result').textContent = 'pressed=' + button.getAttribute('aria-pressed') + '; weight=' + getComputedStyle(sample).fontWeight;
</script>

Resultado

pressed=true; weight=700

O resultado corresponde ao negrito ativado. Outra ativação inverte o estado, mantendo o mesmo nome.

Fontes