jQuery UI API - .switchClass()

Категория

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

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

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

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

.switchClass( removeClassName, addClassName [, duration ] [, easing ] [, complete ] )

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

.switchClass( removeClassName, addClassName [, options ] )

Параметр Type Описание
removeClassName String Одно или несколько имён классов, которые нужно удалить из атрибута class каждого совпавшего элемента, разделённых пробелами.
addClassName 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 принимает строку, и в этом случае анимация добавляется в очередь, представленную этой строкой.

.switchClass()Метод позволяет добавить класс и при этом удалить класс во время анимационного перехода.

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

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

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

Пример

Добавьте класс "blue" к выбранным элементам и удалите класс "big" из выбранных элементов.

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

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