JavaScript/DOM/HTMLOrSVGElement/dataset

Die Eigenschaft HTMLElement.dataset bietet Lese-/Schreibzugriff auf benutzerdefinierte Datenattribute (data-*) von Elementen. Sie stellt eine Map von Strings (DOMStringMap) mit einem Eintrag für jedes data-*-Attribut zur Verfügung.

Browserunterstützung
caniuse.com

Syntax

var dataset = element.dataset.

Beachten Sie: Die Eigenschaft dataset selbst kann gelesen, aber nicht direkt geschrieben werden. Stattdessen müssen alle Schreibzugriffe auf die einzelnen Eigenschaften innerhalb des Datasets erfolgen, die wiederum die Datenattribute darstellen.

Ein HTML data-*-Attribut und seine entsprechende DOM dataset.property ändern ihren gemeinsamen Namen je nachdem, wo sie gelesen oder geschrieben werden:

In HTML

• Der Attributname beginnt mit data-. Er darf nur Buchstaben, Zahlen, Bindestriche (-), Punkte (.), Doppelpunkte (:) und Unterstriche (_) enthalten. Alle ASCII-Großbuchstaben (A bis Z) werden in Kleinbuchstaben umgewandelt.

In JavaScript

• Der Eigenschaftsname eines benutzerdefinierten Datenattributs entspricht dem HTML-Attribut ohne das Präfix data- und entfernt einzelne Bindestriche (-), um den Eigenschaftsnamen in Großbuchstaben zu schreiben (camelCased).

Weblinks

• whatwg: element.dataset