Metoda .data() ne permite să citim datele asociate anterior cu elementele DOM. Putem prelua mai multe valori distincte pentru un singur element, una câte una, sau ca un set:
|
1
2
3
4
5
6
7
|
|
Apelarea .data() fără parametri returnează un obiect JavaScript care conține fiecare valoare stocată ca proprietate. Obiectul poate fi utilizat direct pentru a obține valorile datelor (dar rețineți că numele proprietăților care conțineau inițial liniuțe vor fi fost modificate așa cum este descris mai jos).
De la jQuery 3, fiecare secvență de două caractere „-” (U+002D) urmată de o literă ASCII minusculă într-o cheie este înlocuită cu versiunea majusculă a literei, în aliniere cu API-ul setului de date HTML. O instrucțiune precum $( "body" ).data( { "my-name": "aValue" } ).data(); va returna { myName: "aValue" }.
Atributele data-* HTML5 data-*
De la jQuery 1.4.3, atributele data-* sunt utilizate pentru a inițializa datele jQuery. Atributele data-* ale unui element sunt recuperate prima dată când metoda data() este invocată asupra acestuia, iar apoi nu mai sunt accesate sau modificate (toate valorile sunt stocate intern de către jQuery).
Se face orice încercare de a converti valoarea de șir de caractere a atributului într-o valoare JavaScript (aceasta include booleeni, numere, obiecte, matrici și null). Un șir de caractere este convertit într-un număr numai dacă acest lucru nu modifică reprezentarea sa (de exemplu, șirul „100” este convertit în numărul 100, dar „1E02” și „100.000” sunt lăsate ca șiruri de caractere deoarece valoarea lor numerică de 100 se serializează în „100”). Atunci când un șir de caractere începe cu „{” sau „[„, se utilizează jQuery.parseJSON pentru a-l analiza; acesta trebuie să respecte o sintaxă JSON validă, inclusiv nume de proprietăți cotate. Un șir de caractere care nu poate fi analizat ca valoare JavaScript nu este convertit.
Pentru a prelua o valoare de atribut data-* ca șir de caractere neconvertit, utilizați metoda attr().
De la jQuery 1.6, liniuțele din numele atributelor data-* au fost procesate în aliniere cu API-ul de set de date HTML.
De exemplu, având în vedere următorul HTML:
|
1
|
|
Următoarele comparații sunt toate adevărate:
|
1
2
3
4
|
|