Metoda data
Metoda data permite atașarea datelor de orice
tip la elementele DOM într-un mod sigur,
permițând evitarea scurgerilor de memorie.
Putem seta mai multe valori diferite pentru
un element și le putem obține mai târziu.
Utilizarea metodei data pentru actualizarea
datelor nu afectează atributele în DOM.
Sintaxă
Așa setăm o valoare pentru un element și o cheie, după care o putem găsi mai târziu:
.data(cheie, valoare);
De asemenea, putem transmite un obiect care conține perechi cheie-valoare pentru actualizarea datelor:
.data(obiect);
Putem obține datele asociate cu primul element din colecția jQuery, transmitând doar cheia:
.data(cheie);
Fără a transmite niciun parametru, putem citi datele atașate anterior elementelor DOM. Metoda va returna un obiect JavaScript, conținând fiecare valoare ca proprietate:
.data();
Exemplu
Să setăm cu data date pentru
tag-ul p, transmitând ca prim parametru
'test' și valoarea 21 pentru al doilea. Apoi
să citim datele salvate cu cheia 'test':
<p>text</p>
$('p').data('test', 21); // aici datele sunt scrise
console.log($('p').data('test')); // va afișa numărul 21
console.log($('p').data()); // va afișa obiectul {test: 21}
Vedeți și
-
metoda
removeData,
care șterge datele dintr-un element -
metoda
hasData,
care verifică prezența datelor într-un element -
metoda
attr,
care permite obținerea și modificarea oricărui atribut al elementului -
Proprietatea JavaScript
dataset,
care permite adăugarea atributelor personalizate tag-urilor