Spec-Zone.ru › jQuery

.removeData()

.removeData( [name ] )Возвращает: jQuery

Описание: Удалить ранее сохранённые данные.

  • версия добавлена: 1.2.3.removeData( [name ] )

    • name
      Тип: Строка
      Строка, определяющая данные для удаления.
  • версия добавлена: 1.7.removeData( [list ] )

    • list
      Тип: Массив или Строка
      Массив или строка, разделённая пробелами, определяющие данные для удаления.

Метод .removeData() позволяет удалить значения, которые были ранее установлены с помощью .data(). При вызове с именем ключа .removeData() удаляет конкретное значение. При вызове без аргументов .removeData() удаляет все значения.

Обратите внимание, что .removeData() удаляет данные только из внутренней кэшированной системы jQuery .data(), а соответствующие атрибуты элемента data- не удаляются. Поэтому последующий вызов data() повторно получит значение из атрибута data-. Чтобы предотвратить это, используйте .removeAttr() вместе с .removeData() для удаления атрибута data- также. До jQuery 1.4.3 это не было проблемой, так как data() не использовал атрибуты data-.

Начиная с jQuery 1.7, при вызове с массивом ключей или строкой, разделённой пробелами, .removeData() удаляет значение каждого ключа в этом массиве или строке.

Пример:

Установить хранилище данных для 2 имён, затем удалить одно из них.

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>removeData demo</title>
  <style>
  div {
    margin: 2px;
    color: blue;
  }
  span {
    color: red;
  }
  </style>
  <script src="https://code.jquery.com/jquery-3.7.0.js"></script>
</head>
<body>
 
<div>value1 before creation: <span></span></div>
<div>value1 after creation: <span></span></div>
<div>value1 after removal: <span></span></div>
<div>value2 after removal: <span></span></div>
 
<script>
$( "span" ).eq( 0 ).text( "" + $( "div" ).data( "test1" ) );
$( "div" ).data( "test1", "VALUE-1" );
$( "div" ).data( "test2", "VALUE-2" );
$( "span" ).eq( 1 ).text( "" + $( "div").data( "test1" ) );
$( "div" ).removeData( "test1" );
$( "span" ).eq( 2 ).text( "" + $( "div" ).data( "test1" ) );
$( "span" ).eq( 3 ).text( "" + $( "div" ).data( "test2" ) );
</script>
 
</body>
</html>

Демо:

© The jQuery Foundation and other contributors
Licensed under the MIT License.
https://api.jquery.com/removeData

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API