jQuery UI API - .toggleClass()

Категория

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

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

Описание:При анимации изменений стиля добавляйте или удаляйте один или несколько классов для каждого элемента в наборе совпавших элементов, в зависимости от того, существует ли класс, и от значения параметра switch.

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

.toggleClass( className [, switch ] [, duration ] [, easing ] [, complete ] )

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

.toggleClass( className [, switch ] [, options ] )

Parameters Type Описание
ClassName String Одно или несколько имен классов для переключения у каждого элемента в наборе совпавших элементов, разделенных пробелами.
switch Boolean Логическое значение, указывающее, следует ли добавить или удалить класс.
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. Все методы анимации классов, включая.toggleClass(), позволяют задавать пользовательскую длительность анимации иeasingфункцию плавности, а также предоставляют функцию обратного вызова по завершении анимации.

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

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

Пример

Переключить класс "big-blue" для выбранных элементов.

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>.toggleClass() 演示</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></div>
 
<script>
$( "div" ).click(function() {
  $( this ).toggleClass( "big-blue", 1000, "easeOutSine" );
});
</script>
 
</body>
</html>

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