Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti