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

CKTIS / HTML

aria-current — elemento atual de um conjunto

`aria-current` assinala a página, o passo ou outro elemento atual dentro de um conjunto relacionado.

Versão: WAI-ARIA 1.2

Sintaxe

<a href="/courses" aria-current="page">Courses</a>

Os tokens permitidos são page, step, location, date, time, true e false. Um valor ausente, vazio ou undefined significa que não é atual; um token desconhecido não vazio é tratado como verdadeiro. Ainda assim, escolhe um token válido e específico.

Assinala um elemento como atual em cada conjunto. Não é um separador selecionado nem o foco do teclado: não substitui aria-selected e não efetua navegação. Fornece também uma indicação visível que não dependa apenas da cor.

O exemplo move a marca de Home para Courses e remove a anterior. Impede propositadamente a navegação para mostrar a atualização; numa aplicação, a marca deve corresponder à página realmente apresentada. O teste confirma exatamente uma ligação atual.

Exemplos

<!doctype html><meta charset="utf-8">
<nav aria-label="Sections"><a href="/" aria-current="page">Home</a> <a id="courses" href="/courses">Courses</a></nav>
<output id="result"></output>
<script>
const links = [...document.querySelectorAll('nav a')];
links.forEach(link => link.addEventListener('click', event => {
  event.preventDefault();
  links.forEach(other => other.removeAttribute('aria-current'));
  link.setAttribute('aria-current', 'page');
}));
document.querySelector('#courses').click();
const current = document.querySelectorAll('[aria-current="page"]');
document.querySelector('#result').textContent = 'current=' + current[0].textContent + '; count=' + current.length;
</script>

Resultado

current=Courses; count=1

A demonstração local não abre outra página. Verifica a mudança da marca, não um sistema completo de encaminhamento.

Fontes