A data metódus

A data metódus bármilyen típusú adatokat köthet DOM elemekhez biztonságos módon, ezzel elkerülve a memóriaszivárgásokat. Több különböző értéket is beállíthatunk egy elemhez, és később lekérhetjük azokat. A data metódus használata az adatok frissítéséhez nincs hatással a DOM attribútumokra.

Szintaxis

Így állítunk be egy értéket egy elemhez egy kulcs alapján, amellyel később megtalálhatjuk:

.data(kulcs, érték);

Átadhatunk egy objektumot is, amely kulcs-érték párokat tartalmaz az adatok frissítéséhez:

.data(objektum);

Lekérhetjük a jQuery gyűjtemény első eleméhez társított adatokat, ha csak a kulcsot adjuk meg:

.data(kulcs);

Ha nem adunk meg paramétereket, akkor a korábban a DOM elemekhez társított adatokat kérhetjük le. A metódus egy JavaScript objektumot ad vissza, amely minden értéket tulajdonságként tartalmaz:

.data();

Példa

Állítsunk be adatokat a p tag számára a data használatával, úgy, hogy az első paraméterként 'test'-ot, a másodiknak pedig a 21 értéket adjuk meg. Ezután olvassuk vissza a 'test' kulccsal elmentett adatokat:

<p>szöveg</p>

$('p').data('test', 21); // itt az adatokat elmentjük

console.log($('p').data('test')); // kiírja a 21 számot
console.log($('p').data()); // kiírja a {test: 21} objektumot

Lásd még

a removeData metódus,
amely eltávolítja az adatokat egy elemből
a hasData metódus,
amely ellenőrzi, hogy vannak-e adatok egy elemben
a attr metódus,
amely lehetővé teszi bármely attribútum lekérését és módosítását
a JavaScript dataset tulajdonság,
amely lehetővé teszi saját attribútumok hozzáadását a tag-ekhez