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

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

Категории: Data , Miscellaneous › Data Storage

.data()

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

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

data ( key, value ) - прикрепляет данные к элементу...
data ( obj ) - прикрепляет данные к элементу...
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 элементе и дальнейшего использования. Заменяет собой все ранее хранимые данные, связанные с элементом.

Примечание:

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

Данный метод не может быть использован для установки данных на элементах <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());

[ наверх ]

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

.data()

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

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

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

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

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

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

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

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