CKTIS / HTML
data-*: anwendungseigene Attribute
Speichern Sie Zeichenkettenzustand ohne ihn als vertrauenswürdig oder geheim anzusehen.
Version: HTML Living Standard
Syntax
<button data-item-count="2">Add</button>Eigene data-*-Attribute speichern Informationen für die Anwendung der Seite. Ergänzen Sie den Präfix um einen Namen, vorzugsweise kleingeschrieben mit Bindestrichen. Die Schnittstelle dataset bildet etwa data-item-count auf die CamelCase-Eigenschaft itemCount ab. Auslesen liefert Text, auch wenn das Attribut Ziffern enthält.
Konvertieren und prüfen Sie Werte vor Berechnungen oder Geschäftsentscheidungen. Das Setzen einer dataset-Eigenschaft aktualisiert das zugehörige Attribut; zugewiesene Werte werden Zeichenketten. Nutzer können diese Daten sehen und ändern: Hier gehören weder Geheimnisse noch Serverberechtigungen hin. Verwenden Sie ein vorhandenes Standardattribut, wenn es die Bedeutung bereits ausdrückt.
Der Button beginnt mit dem Zähler zwei. Sein Handler konvertiert den Text ausdrücklich zur Zahl, erhöht sie und schreibt zurück. Der Test prüft dataset und das synchronisierte Attribut und vermeidet versehentliche Zeichenkettenverkettung.
Beispiele
<!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>Ergebnis
beforeType=string; after=3; attribute=3
Die Konvertierung ist ausdrücklich; das Attribut selbst macht seinen Wert nicht numerisch.