|
|
Варианты работы функции jQuery.data() в зависимости от переданных ей параметров:
-
-
* * *
Синтаксис и описание:
Добавлено в jQuery 1.2.3jQuery.data( element, key, value )-
Функция прикрепляет к указанному элементу произвольные именованные данные, переданные ей в качестве входных параметров. Если в хранилище элемента уже имеются данные с указанным именем, то значение обновляется (перезаписывается). (См. также метод .data())
Параметры:
element – (элемент) Ссылка на DOM элемент, к которому необходимо привязать данные. key – (строка) Название, имя данных, которые необходимо связать с элементом (добавить или обновить). value – (Любой тип данных JavaScript, включая массив или объект) Новое значение данных для установки и хранения при DOM-узле.
-
Примечание:
К каждому элементу можно прикрепить на хранение сколько угодно разноименных данных, чтобы получить их потом.
-
Примечание:
Данный метод не может быть использован для установки данных на элементах <object>, <applet> и <embed>.
-
Примечание:
Удалить с элемента хранящиеся данные можно с помощью функции jQuery.removeData() или .removeData().
Примеры:
-
Прикрепить несколько различных данных к элементу <body> для хранения, потом получить их через некоторое время.
jQuery.data(document.body, 'foo', 52);
jQuery.data(document.body, 'bar', 'test');
// ...
alert(jQuery.data( document.body, 'foo' )); // 52
alert(jQuery.data( document.body, 'bar' )); // test
alert(jQuery.data( document.body )); // {foo: 52, bar: 'test'}
[ наверх ]
* * *
Добавлено в jQuery 1.2.3jQuery.data( element, key )Добавлено в jQuery 1.4jQuery.data( element )-
Функция возвращает данные с именем key, находящиеся в хранилище указанного элемента. Если таковых нет, то возвращается пустая строка. Если входные параметры опущены, функция возвращает все хранимые при элементе данные в виде объекта JavaScript. (См. также метод .data())
Возвращаемое значение: Строка или объект JavaScript.
Параметры:
element – (элемент) Ссылка на DOM элемент, данные связанные с которым необходимо получить. key – (строка) Имя хранимых данных, которые необходимо получить.
Примеры:
-
// Вывести значение данных с именем 'foo' элемента <body>.
// Потом вывести все данные, связанные с элементом <body>.
alert(jQuery.data( document.body, 'foo' ));
alert(jQuery.data( document.body ));
[ наверх ]
|
|
