Μέθοδος data

Η μέθοδος data επιτρέπει τη σύνδεση δεδομένων οποιουδήποτε τύπου σε στοιχεία DOM με ασφαλή τρόπο, που αποφεύγει τις διαρροές μνήμης. Μπορούμε να ορίσουμε πολλές διαφορετικές τιμές για ένα στοιχείο και να τις ανακτήσουμε αργότερα. Η χρήση της μεθόδου data για την ενημέρωση δεδομένων δεν επηρεάζει τα χαρακτηριστικά στο DOM.

Σύνταξη

Έτσι ορίζουμε μια τιμή για ένα στοιχείο και ένα κλειδί, με το οποίο μπορεί να βρεθεί αργότερα:

.data(κλειδί, τιμή);

Μπορούμε επίσης να περάσουμε ένα αντικείμενο, που περιέχει ζεύγη κλειδιού-τιμής για την ενημέρωση δεδομένων:

.data(αντικείμενο);

Μπορούμε να ανακτήσουμε δεδομένα που σχετίζονται με το πρώτο στοιχείο στη συλλογή jQuery, περνώντας μόνο το κλειδί:

.data(κλειδί);

Χωρίς να περάσουμε καμία παράμετρο, μπορούμε να διαβάσουμε δεδομένα που είχαν προηγουμένως συσχετιστεί με στοιχεία DOM. Η μέθοδος θα επιστρέψει ένα αντικείμενο JavaScript, που περιέχει κάθε τιμή ως ιδιότητα:

.data();

Παράδειγμα

Ας χρησιμοποιήσουμε το data για να ορίσουμε δεδομένα για την ετικέτα p, περνώντας ως πρώτη παράμετρο το 'test' και την τιμή 21 για τη δεύτερη. Στη συνέχεια διαβάζουμε τα δεδομένα που αποθηκεύτηκαν με το κλειδί 'test':

<p>κείμενο</p>

$('p').data('test', 21); // εδώ τα δεδομένα εγγράφονται

console.log($('p').data('test')); // θα εμφανίσει τον αριθμό 21
console.log($('p').data()); // θα εμφανίσει το αντικείμενο {test: 21}

Δείτε επίσης

η μέθοδος removeData,
που διαγράφει δεδομένα από ένα στοιχείο
η μέθοδος hasData,
που ελέγχει την ύπαρξη δεδομένων σε ένα στοιχείο
η μέθοδος attr,
που επιτρέπει την ανάκτηση και αλλαγή οποιουδήποτε χαρακτηριστικού ενός στοιχείου
η ιδιότητα JavaScript dataset,
που επιτρέπει την προσθήκη προσαρμοσμένων χαρακτηριστικών σε ετικέτες