CKTIS / HTML
data-*: attributi propri dell’applicazione
Conserva stato testuale senza considerarlo affidabile o segreto.
Versione: HTML Living Standard
Sintassi
<button data-item-count="2">Add</button>Gli attributi personalizzati data-* conservano informazioni per l’applicazione della pagina. Aggiungi un nome dopo il prefisso, preferibilmente minuscolo con trattini. L’interfaccia dataset converte ad esempio data-item-count nella proprietà camelCase itemCount. Leggere restituisce testo anche quando sono presenti cifre.
Converti e valida prima di calcoli o decisioni applicative. Assegnare una proprietà dataset aggiorna l’attributo corrispondente e converte i valori in stringhe. I dati sono visibili e modificabili nel browser: non custodiscono segreti né autorizzazioni server. Preferisci un attributo standard esistente se esprime già quel significato.
Il pulsante parte dal contatore due. Il gestore converte esplicitamente il testo in numero, incrementa e riscrive. Il risultato controlla dataset e l’attributo sincronizzato, evitando concatenazioni accidentali.
Esempi
<!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>Risultato
beforeType=string; after=3; attribute=3
La conversione è esplicita; l’attributo non rende numerico il valore da solo.