data ක්රමය
data ක්රමය මගින් ඕනෑම ආකාරයේ දත්ත DOM මූලද්රව්යවලට ආරක්ෂිත ආකාරයෙන් බැඳිය හැක,
මෙය මතක කාන්දු වීම වැළැක්වීමට ඉඩ සලසයි.
අපට මූලද්රව්යයක් සඳහා විවිධ අගයන් කිහිපයක් පිහිටුවීමට සහ පසුව ඒවා ලබා ගැනීමට හැකිය.
data ක්රමය භාවිතයෙන් දත්ත යාවත්කාලීන කිරීම DOM හි ගුණාංග (attributes) මත බලපාන්නේ නැත.
වාක්ය රීතිය
මෙහිදී අපි මූලද්රව්යයකට අගයක් සහ යතුරක් පිහිටුවන්නෙමු, පසුව එම යතුර භාවිතයෙන් එය සොයාගත හැකිය:
.data(යතුර, අගය);
දත්ත යාවත්කාලීන කිරීම සඳහා යතුර-අගය යුගල අඩංගු වස්තුවක් ද අපට යැවිය හැකිය:
.data(වස්තුව);
jQuery එකතුවේ පළමු මූලද්රව්යය සමඟ බැඳුණු දත්ත ලබා ගත හැක්කේ යතුර පමණක් යවමින්:
.data(යතුර);
පරාමිති කිසිවක් නොයවන විට, අපට කලින් DOM මූලද්රව්ය සමඟ බැඳුණු දත්ත කියවිය හැකිය. ක්රමය එක් එක් අගය ගුණාංගයක් ලෙස අඩංගු JavaScript වස්තුවක් ප්රතිදානය කරයි:
.data();
නිදර්ශනය
data භාවිතයෙන්
p ටැගය සඳහා දත්ත පිහිටුවමු,
පළමු පරාමිතිය ලෙස
'test' සහ දෙවන පරාමිතිය සඳහා අගය 21 යවමින්. ඉන්පසු
'test' යතුර සමඟ සුරක්ෂිත කර ඇති දත්ත කියවමු:
<p>text</p>
$('p').data('test', 21); // මෙහි දත්ත ලියා ඇත
console.log($('p').data('test')); // අංකය 21 ප්රදර්ශනය කරයි
console.log($('p').data()); // වස්තුව {test: 21} ප්රදර්ශනය කරයි
මේවාත් බලන්න
-
removeDataක්රමය,
මූලද්රව්යයකින් දත්ත ඉවත් කරයි -
hasDataක්රමය,
මූලද්රව්යයක දත්ත පවතිනවාද යන්න පරීක්ෂා කරයි -
attrක්රමය,
මූලද්රව්යයේ ඕනෑම ගුණාංගයක් (attribute) ලබා ගැනීමට සහ වෙනස් කිරීමට ඉඩ සලසයි -
JavaScript ගුණය
dataset,
ටැගවලට ඔබේම ගුණාංග (custom attributes) එක් කිරීමට ඉඩ සලසයි
