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

CKTIS / HTML

rel — relação entre um documento e um recurso

O atributo rel especifica uma relação com um recurso ou a forma como uma ligação é processada. Aceita palavras-chave separadas por espaços em branco, cujo significado e utilização permitida dependem do elemento.

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

Sintaxe

rel="keyword1 keyword2"

rel surge em a, area, link e form; não é um atributo global. O seu valor é um conjunto não ordenado de tokens únicos separados por espaços em branco ASCII, e não por vírgulas. As palavras-chave não distinguem maiúsculas de minúsculas ASCII.

As palavras-chave permitidas dependem do elemento. Em link, stylesheet identifica uma folha de estilos externa, enquanto next identifica o documento seguinte de uma série. Sem palavras-chave reconhecidas e permitidas, link não cria ligações. Em contrapartida, a e area com href continuam a criar hiperligações normais sem rel.

Nas hiperligações, noopener desliga uma janela recém-aberta de window.opener; noreferrer também omite informações sobre a origem e implica noopener. nofollow indica falta de recomendação ou uma relação comercial — não impede a navegação nem substitui estas proteções.

O exemplo combina help e nofollow. A propriedade relList permite verificar tokens individuais sem dividir o texto do atributo.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>rel demo</title>
</head>
<body>
  <a id="reference" href="#details" rel="help nofollow">Details</a>
  <p id="details">Additional information.</p>
  <pre id="result"></pre>
  <script>
    const anchor = document.getElementById('reference');
    document.getElementById('result').textContent =
      anchor.relList.contains('help') + '\n' +
      anchor.relList.contains('nofollow');
  </script>
</body>
</html>

Resultado

true
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes