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ó.