WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen