CKTIS / HTML
data-*: atributos propios de la aplicación
Almacena estado textual sin considerarlo fiable ni secreto.
Versión: HTML Living Standard
Sintaxis
<button data-item-count="2">Add</button>Los atributos personalizados data-* guardan información para la aplicación de la página. Añade un nombre tras el prefijo, preferiblemente en minúsculas con guiones. La interfaz dataset convierte, por ejemplo, data-item-count en la propiedad camelCase itemCount. Leerla devuelve texto, incluso cuando contiene dígitos.
Convierte y valida antes de calcular o tomar decisiones de negocio. Asignar una propiedad dataset actualiza el atributo correspondiente y convierte valores en cadenas. Estos datos son visibles y modificables en el navegador: no sirven para secretos ni autorización del servidor. Usa un atributo estándar existente si ya expresa el significado.
El botón comienza con el contador dos. Su manejador convierte explícitamente el texto en número, lo incrementa y lo guarda. El resultado comprueba dataset y el atributo sincronizado, evitando concatenaciones accidentales.
Ejemplos
<!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
La conversión es explícita; el atributo no convierte su valor en numérico por sí mismo.