jQuery UI API - .removeClass()

Категория

Эффекты | Ядро эффектов | Переопределения методов

Использование

Описание:Во время анимации изменений стиля удаляет указанный класс из каждого элемента в наборе совпавших элементов.

Возвращает:jQuery

.removeClass( className [, duration ] [, easing ] [, complete ] )

Parameters Type Описание Default
className String Одно или несколько имён классов, которые нужно удалить из атрибута class каждого совпавшего элемента, разделённых пробелами.
duration Число или строка Строка или число, указывающее, как долго будет выполняться анимация. 400
easing String Строка, указывающая функциюeasing, которую нужно использовать. swing
complete Function() Функция, которая вызывается после завершения анимации.

.removeClass( className [, options ] )

Parameters Type Описание
className String Одно или несколько имён классов, которые нужно удалить из атрибута class каждого совпавшего элемента, разделённых пробелами.
options Object Все параметры анимации. Все свойства необязательны.
  • duration(По умолчанию:400)
    Тип: Number или String
    Описание: строка или число, задающее длительность выполнения анимации.
  • easing(По умолчанию:swing)
    Тип: String
    Описание: строка, указывающая функциюeasing, которую нужно использовать.
  • complete
    Тип: Function()
    Описание: функция, вызываемая после завершения анимации.
  • children(По умолчанию:false)
    Тип: Boolean
    Описание: Указывает, должна ли анимация применяться ко всем потомкам выбранных элементов. Эту возможность следует использовать с осторожностью, поскольку определение того, является ли элемент потомком анимации, обходится дорого и растёт линейно с числом потомков.
  • queue(По умолчанию:true)
    Тип: Boolean или String
    Описание: логическое значение, указывающее, следует ли помещать анимацию в очередь эффектов. Если false, анимация начнётся немедленно.Начиная с jQuery 1.7параметр queue также принимает строку; в этом случае анимация добавляется в очередь, представленную этой строкой.

Подобно встроенным переходам CSS, анимации классов jQuery UI обеспечивают плавный переход из одного состояния в другое, при этом все детали изменения стилей обрабатываются через CSS без необходимости в JavaScript. Все методы анимации классов, включая.removeClass()позволяют задавать пользовательскую длительность анимации иeasingфункции плавности, а также предоставляют обратный вызов по завершении анимации.

Не все стили можно анимировать. Например, анимация фонового изображения. Любой стиль, который невозможно анимировать, будет изменён в конце анимации.

Этот плагин расширяет встроенный метод jQuery.removeClass(). Если jQuery UI не загружен, вызов.removeClass()метода не завершится ошибкой напрямую, потому что метод существует в jQuery. Однако ожидаемое поведение не произойдёт.

Примеры

Удаляет класс "big-blue" у выбранных элементов.

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>.removeClass() 演示</title>
  <link rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css">
  <style>
  div {
    width: 100px;
    height: 100px;
    background-color: #ccc;
  }
  .big-blue {
    width: 200px;
    height: 200px;
    background-color: #00f;
  }
  </style>
  <script src="//code.jquery.com/jquery-1.10.2.js"></script>
  <script src="//code.jquery.com/ui/1.10.4/jquery-ui.js"></script>
</head>
<body>
 
<div class="big-blue"></div>
 
<script>
$( "div" ).click(function() {
  $( this ).removeClass( "big-blue", 1000, "easeInBack" );
});
</script>
 
</body>
</html>

Другие расширения