data-metodi
Metodi data mahdollistaa minkä tahansa tyyppisen
tiedon liittämisen DOM-elementteihin turvallisella
tavalla, mikä estää muistivuotoja.
Voimme asettaa useita eri arvoja
elementille ja hakea ne myöhemmin.
Metodin data käyttäminen tietojen
päivittämiseen ei vaikuta DOM:n attribuutteihin.
Syntaksi
Näin asetamme elementille arvon ja avaimen, jolla sitä voidaan myöhemmin etsiä:
.data(avain, arvo);
Voimme myös välittää objektin, joka sisältää avain-arvo-parit tietojen päivittämiseksi:
.data(objekti);
Voimme hankkia jQuery-kokoelman ensimmäiseen elementtiin liitetyt tiedot välittämällä vain avaimen:
.data(avain);
Emme välittämällä parametreja, voimme lukea aiemmin DOM-elementteihin liitetyt tiedot. Metodi palauttaa JavaScript-objektin, joka sisältää jokaisen arvon ominaisuutena:
.data();
Esimerkki
Asetetaan data:n avulla tiedot
p-tagille välittämällä ensimmäisenä parametrina
'test' ja arvo 21 toisena. Sitten
luemme avaimella 'test' tallennetut tiedot:
<p>teksti</p>
$('p').data('test', 21); // tässä tiedot kirjoitetaan
console.log($('p').data('test')); // tulostaa numeron 21
console.log($('p').data()); // tulostaa objektin {test: 21}
Katso myös
-
metodi
removeData,
joka poistaa tiedot elementistä -
metodi
hasData,
joka tarkistaa onko elementissä tietoja -
metodi
attr,
joka mahdollistaa minkä tahansa elementin attribuutin hakemisen ja muuttamisen -
JavaScript-ominaisuus
dataset,
joka mahdollistaa omien attribuuttien lisäämisen tageille