jQuery.data()

посл. ред. 04.01.2017

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

Все данные, установленные с помощью данной функции, привязаны только к конкретному элементу и гарантированно не приводят к утечке памяти. Все данные полностью удалятся в случае удаления элемента jQuery-методами или когда пользователь покинет текущую страницу.

Устанавливаемые данные представляют собой пару имя, значение. Имя задаётся в виде строки, по которой впоследствии можно получить эти данные. Устанавливаемое значение может иметь любой тип данных JavaScript, кроме undefined.

Варианты использования

jQuery.data(элемент, имя, значение) => JavaScript: Привязывает к переданному элементу указанные данные. Возвращает установленное значение.
jQuery.data(элемент, имя) => JavaScript: Возвращает ранее привязанные к элементу данные по указанному имени. Если данных с указанным именем не существует, функция возвращает пустую строку.
jQuery.data(элемент) => Object: Возвращает в виде объекта все данные, привязанные к элементу. В результат включаются не только пользовательские данные, но и внутренние, установленные библиотекой jQuery.

Примеры

<html>
<head>
  <title>Функции библиотеки jQuery</title>
  <script type="text/javascript" src="js/jquery.js"></script>
</head>
<body>
</body>
</html>
 
<script>
var body = document.body;

$.data(body, 'background', 'teal'); /* установленны данные с именем 'background' */
body.style.background = $.data(body, 'background'); /* получены данные с именем 'background' */
console.log($.data(body)); /* объект {background: 'teal'} */
</script>