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

CKTIS / HTML

termo ou valor HTML: id

O atributo `id` atribui um identificador usado por fragmentos de URL, relações HTML e ARIA, seletores e API DOM.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

<section id="chapter-1">…</section>

Um valor id tem de ser não vazio, não conter espaços ASCII e ser único entre todos os identificadores na árvore do elemento. A correspondência é exata: maiúsculas, minúsculas e cada caráter do valor importam.

Nomes simples e estáveis como #chapter-1 funcionam bem em endereços e seletores. Outros carateres permitidos podem exigir CSS.escape() antes de construir um seletor; nunca insiras diretamente um valor não fiável numa consulta CSS.

Mudar o identificador pode quebrar uma etiqueta for, uma referência aria-labelledby ou uma ligação href="#chapter-1". Duplicados não são conformes e tornam resultados de API ambíguos; componentes dinâmicos também têm de manter unicidade.

O exemplo segue uma ligação href="#chapter-1" através de document.querySelector(), lê o id correspondente e confirma a quantidade 1. Demonstra uma relação de fragmento conforme com um único destino.

Exemplos

<!doctype html><meta charset="utf-8"><a id="jump" href="#chapter-1">Jump</a><section id="chapter-1">Chapter</section><output id="result"></output><script>const target=document.querySelector(jump.hash);result.textContent=`hash=${jump.hash}; target=${target.id}; matches=${document.querySelectorAll(jump.hash).length}`;</script>

Resultado

hash=#chapter-1; target=chapter-1; matches=1

O exemplo executado verifica que o hash da ligação seleciona exatamente um elemento com o identificador correspondente.

Fontes