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

CKTIS / HTML

elemento HTML: data

O elemento de dados associa conteúdo visível legível por pessoas a uma forma para máquinas escolhida pelo autor.

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

Sintaxe

<data value="SKU-042">Blue mug</data>

data exige o atributo value; HTMLDataElement.value reflete-o como cadeia e não analisa automaticamente identificador, número ou outro formato.

Quando o valor é data ou hora, o elemento adequado é time com datetime, não o data genérico.

O elemento não é um atributo personalizado data-*: esses atributos preenchem dataset, enquanto data liga semanticamente o seu texto a um valor.

O exemplo conta produtos com querySelectorAll(), compara textContent com value e verifica que dataset fica vazio.

Exemplos

<!doctype html>
<meta charset="utf-8">
<ul id="products">
  <li><data id="mug" value="SKU-042">Blue mug</data></li>
  <li><data value="SKU-107">Steel bottle</data></li>
</ul>
<output id="result"></output>
<script>
const products = document.querySelector("#products");
const mug = document.querySelector("#mug");
document.querySelector("#result").textContent = `items=${products.querySelectorAll("data").length}; machine=${mug.value}; human=${mug.textContent}; tag=${mug.tagName}; customData=${Object.keys(mug.dataset).length}`;
</script>

Resultado

items=2; machine=SKU-042; human=Blue mug; tag=DATA; customData=0

O resultado confirma dois produtos visíveis e o identificador SKU do primeiro; não valida unicidade nem sintaxe do valor.

Fontes