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

CKTIS / HTML

aria-selected — seleção num componente composto

`aria-selected` descreve a seleção de um elemento, como separador, opção ou célula interativa, de acordo com o seu papel.

Versão: WAI-ARIA 1.2

Sintaxe

<button role="tab" aria-selected="true">Preview</button>

Usa true ou false em papéis que suportam seleção. A ausência da propriedade pode significar que o elemento não é selecionável. Não é a página atual nem o próprio foco: aria-current tem outro significado.

Para seleção múltipla, configura também o modelo de seleção do contentor. O estado por si só não seleciona dados, oculta painéis nem gere o teclado. Atualiza aspeto, foco e seleção segundo o padrão escolhido, sem os equiparar automaticamente.

O exemplo de separadores ativa Preview, atualiza ambos os estados e altera a visibilidade dos painéis. Uma seta move o foco sem alterar a seleção; a ativação é separada. O teste verifica a árvore de acessibilidade, os painéis e essa distinção entre foco e seleção.

Exemplos

<!doctype html><meta charset="utf-8">
<div role="tablist" aria-label="Editor views">
<button id="edit" role="tab" aria-selected="true" aria-controls="editor">Edit</button>
<button id="view" role="tab" aria-selected="false" aria-controls="preview" tabindex="-1">Preview</button></div>
<section id="editor" role="tabpanel" aria-labelledby="edit">Editor content</section>
<section id="preview" role="tabpanel" aria-labelledby="view" hidden>Preview content</section>
<output id="result"></output>
<script>
const tabs = [...document.querySelectorAll('[role=tab]')];
tabs.forEach((tab, i) => {
  tab.addEventListener('click', () => tabs.forEach(other => {
    const selected = other === tab;
    other.setAttribute('aria-selected', String(selected)); other.tabIndex = selected ? 0 : -1;
    document.getElementById(other.getAttribute('aria-controls')).hidden = !selected;
  }));
  tab.addEventListener('keydown', event => {
    if (event.key === 'ArrowRight' || event.key === 'ArrowLeft') {
      event.preventDefault(); tabs[1 - i].focus();
    }
  });
});
document.querySelector('#view').click();
document.querySelector('#result').textContent = 'selected=' + document.querySelector('[aria-selected=true]').textContent + '; firstHidden=' + document.querySelector('#editor').hidden + '; secondHidden=' + document.querySelector('#preview').hidden;
</script>

Resultado

selected=Preview; firstHidden=true; secondHidden=false

É um exemplo de ativação manual de separadores. As setas movem o foco; clicar ou ativar o botão muda o painel.

Fontes