CKTIS / HTML
data-*: eigen toepassingsattributen
Bewaar tekstuele toestand zonder die als vertrouwd of geheim te behandelen.
Versie: HTML Living Standard
Syntax
<button data-item-count="2">Add</button>Eigen data-*-attributen bewaren informatie voor de toepassing van de pagina. Voeg een naam na het voorvoegsel toe, bij voorkeur kleine letters met koppeltekens. De interface dataset koppelt bijvoorbeeld data-item-count aan de camelCase-eigenschap itemCount. Uitlezen geeft tekst, ook wanneer er cijfers staan.
Converteer en valideer vóór berekeningen of bedrijfsbeslissingen. Een dataset-eigenschap instellen werkt het bijbehorende attribuut bij en maakt waarden tot strings. Gebruikers kunnen de gegevens zien en wijzigen: bewaar er geen geheimen of serverrechten. Gebruik een bestaand standaardattribuut wanneer dat de betekenis al uitdrukt.
De knop begint met teller twee. De handler zet tekst expliciet om naar een getal, verhoogt het en schrijft terug. Het resultaat controleert dataset en het gesynchroniseerde attribuut zonder onbedoeld strings samen te voegen.
Voorbeelden
<!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>Resultaat
beforeType=string; after=3; attribute=3
De omzetting is expliciet; het attribuut maakt zijn waarde niet vanzelf numeriek.