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

CKTIS / HTML

meta — metadados de um documento HTML

O elemento meta regista metadados como a descrição de uma página e uma declaração de codificação. Também pode especificar diretivas pragma ou propriedades de microdados. O seu significado depende do atributo escolhido.

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

Sintaxe

<meta charset="utf-8">
<meta name="description" content="Page description">
<meta http-equiv="refresh" content="30">
<div itemscope>
  <meta itemprop="name" content="Example">
</div>

meta descreve um documento em vez de criar conteúdo visível. É um elemento vazio: em HTML, não tem conteúdo nem etiqueta de fecho. Normalmente, fica em head; a variante com itemprop também é permitida onde se espera conteúdo de frase.

Indica exatamente um dos atributos name, http-equiv, charset ou itemprop. name identifica metadados como description; http-equiv seleciona uma diretiva pragma; charset declara a codificação; itemprop identifica uma propriedade de microdados. content é obrigatório nas três variantes diferentes de charset e tem de ser omitido com charset.

Utiliza charset="utf-8" e guarda efetivamente o ficheiro como UTF-8. A declaração completa tem de caber nos primeiros 1024 bytes. Um documento só pode ter uma declaração de codificação baseada em meta; não combines charset com a alternativa http-equiv="content-type". Em XML, o atributo charset não tem efeito.

http-equiv não é um substituto geral dos cabeçalhos HTTP. O atributo media só pode ser utilizado com name="theme-color". Um documento pode conter, no máximo, uma entrada description.

O exemplo lê o content da descrição e apresenta-o num parágrafo. O próprio elemento meta não apresenta esse texto.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="description" content="A metadata demonstration.">
  <title>Metadata example</title>
</head>
<body>
  <p id="result"></p>
  <script>
    const description = document.querySelector('meta[name="description"]');
    document.getElementById('result').textContent = description.content;
  </script>
</body>
</html>

Resultado

A metadata demonstration.

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