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

CKTIS / HTML

data-*: atributos próprios da aplicação

Guarde estado textual sem o considerar fiável ou secreto.

Versão: HTML Living Standard

Sintaxe

<button data-item-count="2">Add</button>

Os atributos personalizados data-* guardam informações para a aplicação da página. Acrescente um nome ao prefixo, preferencialmente em minúsculas com hífenes. A interface dataset converte, por exemplo, data-item-count na propriedade camelCase itemCount. A leitura devolve texto, mesmo quando o atributo contém algarismos.

Converta e valide antes de cálculos ou decisões de negócio. Atribuir uma propriedade dataset atualiza o atributo correspondente e transforma valores em cadeias. Os dados são visíveis e alteráveis no navegador: não guardam segredos nem autorizações do servidor. Prefira um atributo padrão existente quando já expressa o significado.

O botão começa com o contador dois. O processador converte explicitamente texto em número, incrementa e grava. O resultado verifica dataset e o atributo sincronizado, evitando concatenação acidental.

Exemplos

<!doctype html><meta charset="utf-8">
<button id="add" data-item-count="2">Add</button><output id="result"></output><script>
const button = document.querySelector('#add'), beforeType = typeof button.dataset.itemCount;
button.addEventListener('click', () => { button.dataset.itemCount = String(Number(button.dataset.itemCount) + 1); });
button.click();
document.querySelector('#result').textContent = 'beforeType=' + beforeType + '; after=' + button.dataset.itemCount + '; attribute=' + button.getAttribute('data-item-count');
</script>

Resultado

beforeType=string; after=3; attribute=3

A conversão é explícita; o atributo não torna o valor numérico por si só.

Fontes