Справочник API
.data() в jQuery
Содержание статьи
-
Категории: Data , Miscellaneous › Data Storage
Cвязывает произвольные именованные данные с элементами набора jQuery или возвращает хранимые при элементе данные в виде объекта JavaScript.
Варианты работы команды .data() в зависимости от переданных ей параметров:
* * *
Синтаксис и описание:
Добавлено в jQuery 1.2.3.data( key, value )
Добавлено в jQuery 1.4.data( obj )
-
Связывает произвольные именованные данные, полученные в качестве входного(ых) параметра(ов) с элементами набора jQuery. (См. также функцию jQuery.data())
Возвращаемое значение: (бъект) Набор jQuery.
Параметры:
key – (строка) Название, имя данных, которые необходимо отдать на хранение элементу (добавить или обновить).
value – (Любой тип данных JavaScript, включая массив или объект) Новое значение данных для установки и хранения при DOM-узле.
obj – (объект) Набор пар {'имя данных key':'значение данных value',..} для размещения в хранилище при DOM элементе и дальнейшего использования. Заменяет собой все ранее хранимые данные, связанные с элементом.
-
Примечание:
К любому элементу можно присоединить (передать на хранение) сколько угодно разноименных данных, чтобы получить их потом. Одноименные данные перезаписываются. Но, если в качестве аргумента метод получает объект, то все данные хранящиеся на элементе заменяются на новые.
-
Примечание:
Данный метод не может быть использован для установки данных на элементах <object>, <applet> и <embed>.
-
Примечание:
Удалить с элемента хранящиеся данные можно с помощью функции .removeData() или jQuery.removeData().
Примеры:
-
Прикрепить различные данные к элементу <body> для хранения, потом получить их через некоторое время.
$('body').data('foo', 52); $('body').data('bar', { myType: 'test', count: 40 }); // ... $('body').data('foo'); // 52 $('body').data(); // {foo: 52, bar: { myType: 'test', count: 40 }} -
Внимание: при установке данных {one: 1, two: 2} уже имеющиеся у элемента <body> данные с именем 'foo' удаляются.
$('body').data('foo', 52); // ... $('body').data({one: 1, two: 2}); // ... $('body').data('foo'); // undefined $('body').data(); // {one: 1, two: 2}
* * *
Добавлено в jQuery 1.2.3.data( key )
Добавлено в jQuery 1.4.data( )
-
Команда .data(key) возвращает данные с именем key, находящиеся в хранилище соответствующего элемента набора jQuery. Если таковых нет, то возвращается пустая строка. При вызове без параметров метод возвращает все хранимые при элементе данные в виде объекта JavaScript. (См. также функцию jQuery.data())
Возвращаемое значение: Строка или объект JavaScript.
Параметры:
key – (строка) Имя хранящихся данных, которые необходимо получить.
-
Примечание:
Удалить с элемента хранящиеся данные можно с помощью функций .removeData() и jQuery.removeData().
Примеры:
-
// Вывести значение данных с именем 'foo' элемента <body>. // Затем вывести все данные, связанные с элементом <body>. alert($('body').data('foo')); alert($('body').data());