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

 

Сегодня: 06 декабря 2016 года, Вторник
Раздел API на стадии наполнения...

 

 

 

  • Категории: DataMiscellaneousData Storage

    .data()

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

* * *

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

  • Добавлено в 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> для хранения, потом получить их через некоторое время.

    $('body').data('foo', 52);
    $('body').data('bar', { myType: 'test', count: 40 });
    
    // ...
    
    $('body').data('foo'); // 52
    $('body').data(); // {foo: 52, bar: { myType: 'test', count: 40 }}
  2. Внимание: при установке данных {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 – (строка) Имя хранящихся данных, которые необходимо получить.

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

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

Примеры:

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

[ наверх ]










 




Справочник по jQuery JavaScript API на русском языке