Функция jQuery.data() связывает произвольные данные с заданным элементом или возвращает хранимые при данном элементе данные в виде объекта JavaScript.

Главная » jQuery API » jQuery.data()

Категории: Data , Utilities

jQuery.data()

Сязывает произвольные данные с заданным элементом или возвращает хранимые при данном элементе данные в виде объекта JavaScript.

Варианты работы функции jQuery.data() в зависимости от переданных ей параметров:

data ( element, key, value ) - прикрепляет данные к элементу...
data ( element [, key ] ) - возвращает данные, хранящиеся на элементе...

* * *

Синтаксис и описание:

Добавлено в jQuery 1.2.3jQuery.data( element, key, value )
Функция прикрепляет к указанному элементу произвольные именованные данные, переданные ей в качестве входных параметров. Если в хранилище элемента уже имеются данные с указанным именем, то значение обновляется (перезаписывается). (См. также метод .data())

Возвращаемое значение: (бъект) Набор jQuery.

Параметры:

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 – (строка) Имя хранимых данных, которые необходимо получить.

Примечание:

Удалить с элемента хранящиеся данные можно с помощью функций jQuery.removeData(), .removeData().

Примеры:

// Вывести значение данных с именем 'foo' элемента <body>.
// Потом вывести все данные, связанные с элементом <body>.
 
alert(jQuery.data( document.body, 'foo' ));
alert(jQuery.data( document.body ));

[ наверх ]

www.jQueryBook.ru - jQuery документация

jQuery.data()

Сязывает произвольные данные с заданным элементом или возвращает хранимые при данном элементе данные в виде объекта JavaScript.

data ( element, key, value ) - прикрепляет данные к элементу...

data ( element [, key ] ) - возвращает данные, хранящиеся на элементе...

Добавлено в jQuery 1.2.3jQuery.data( element, key, value )

Добавлено в jQuery 1.2.3jQuery.data( element, key )

Добавлено в jQuery 1.4jQuery.data( element )