Metoda data

Metoda data pozwala w bezpieczny sposób powiązać dane dowolnego typu z elementami DOM, co pozwala uniknąć wycieków pamięci. Możemy ustawić kilka różnych wartości dla elementu i pobrać je później. Użycie metody data do aktualizacji danych nie wpływa na atrybuty w DOM.

Składnia

W ten sposób ustawiamy wartość dla elementu oraz klucz, po którym można będzie go później znaleźć:

.data(klucz, wartość);

Możemy również przekazać obiekt, który zawiera pary klucz-wartość do aktualizacji danych:

.data(obiekt);

Można pobrać dane powiązane z pierwszym elementem w kolekcji jQuery, przekazując tylko klucz:

.data(klucz);

Nie przekazując żadnych parametrów, możemy odczytać dane wcześniej powiązane z elementami DOM. Metoda zwróci obiekt JavaScript, zawierający każdą wartość jako właściwość:

.data();

Przykład

Za pomocą data ustawmy dane dla tagu p, przekazując jako pierwszy parametr 'test' i wartość 21 dla drugiego. Następnie odczytajmy dane zapisane z kluczem 'test':

<p>tekst</p>

$('p').data('test', 21); // tutaj dane są zapisywane

console.log($('p').data('test')); // wypisze liczbę 21
console.log($('p').data()); // wypisze obiekt {test: 21}

Zobacz też

metoda removeData,
który usuwa dane z elementu
metoda hasData,
który sprawdza obecność danych w elemencie
metoda attr,
który pozwala pobrać i zmienić dowolny atrybut elementu
Właściwość JavaScript dataset,
który pozwala dodawać własne atrybuty tagom