Metoda data

Metoda data umožňuje připojit data libovolného typu k DOM prvkům bezpečným způsobem, což umožňuje vyhnout se únikům paměti. Můžeme nastavit několik různých hodnot pro prvek a získat je později. Použití metody data pro aktualizaci dat neovlivňuje atributy v DOM.

Syntaxe

Tímto způsobem nastavíme hodnotu pro nějaký prvek a klíč, pomocí kterého ho lze později najít:

.data(klíč, hodnota);

Můžeme také předat objekt, který obsahuje dvojice klíč-hodnota pro aktualizaci dat:

.data(objekt);

Data spojená s prvním prvkem v kolekci jQuery lze získat předáním pouze klíče:

.data(klíč);

Bez předání jakýchkoli parametrů můžeme přečíst data dříve spojená s DOM prvky. Metoda vrátí JavaScript objekt, obsahující každou hodnotu jako vlastnost:

.data();

Příklad

Pomocí data nastavme data pro značku p předáním 'test' jako prvního parametru a hodnoty 21 jako druhého. Poté přečtěme data uložená pod klíčem 'test':

<p>text</p>

$('p').data('test', 21); // zde se data zapisují

console.log($('p').data('test')); // vypíše číslo 21
console.log($('p').data()); // vypíše objekt {test: 21}

Viz také

metoda removeData,
která odstraňuje data z prvku
metoda hasData,
která kontroluje přítomnost dat v prvku
metoda attr,
která umožňuje získat a změnit jakýkoli atribut prvku
Vlastnost JavaScriptu dataset,
která umožňuje přidávat vlastní atributy značkám