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

 

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

 

 

 

  • Категории: DataUtilities

    jQuery.data()

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

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

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

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

* * *

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

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

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

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

Параметры:

  • element – (элемент) Ссылка на DOM элемент, к которому необходимо привязать данные.

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

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

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

    К каждому элементу можно прикрепить на хранение сколько угодно разноименных данных, чтобы получить их потом.

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

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

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

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

Примеры:

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

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

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

Примеры:

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

[ наверх ]










 




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