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

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

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

2. data ( obj ) - прикрепляет данные к элементу...

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

* * *

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

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

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

· Связывает произвольные именованные данные, полученные в качестве входного(ых) параметра(ов) с элементами набора jQuery. (См. также функцию jQuery.data())

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

Параметры:

· key – (строка) Название, имя данных, которые необходимо отдать на хранение элементу (добавить или обновить).

· value – (Любой тип данных JavaScript, включая массив или объект) Новое значение данных для установки и хранения при DOM-узле.

· obj – (объект) Набор пар {'имя данных key':'значение данных value',..} для размещения в хранилище при DOM элементе и дальнейшего использования. Заменяет собой все ранее хранимые данные, связанные с элементом.

1. Примечание:

К любому элементу можно присоединить (передать на хранение) сколько угодно разноименных данных, чтобы получить их потом. Одноименные данные перезаписываются. Но, если в качестве аргумента метод получает объект, то все данные хранящиеся на элементе заменяются на новые.

2. Примечание:

Данный метод не может быть использован для установки данных на элементах <object>, <applet> и <embed>.

3. Примечание:

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

Примеры:

1. Прикрепить различные данные к элементу <body> для хранения, потом получить их через некоторое время.
2. $('body').data('foo', 52);3. $('body').data('bar', { myType: 'test', count: 40 });4. 5. // ...6. 7. $('body').data('foo'); // 52 $('body').data(); // {foo: 52, bar: { myType: 'test', count: 40 }}
8. Внимание: при установке данных {one: 1, two: 2} уже имеющиеся у элемента <body> данные с именем 'foo' удаляются.

9. $('body').data('foo', 52);10. 11.// ...12. 13.$('body').data({one: 1, two: 2});14. 15.// ...16. 17.$('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 – (строка) Имя хранящихся данных, которые необходимо получить.

1. Примечание:

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

Примеры:
1. // Вывести значение данных с именем 'foo' элемента <body>.2. // Затем вывести все данные, связанные с элементом <body>.3. 4. alert($('body').data('foo'));5. alert($('body').data());
· .after()