jQuery UI API - .addClass()

Категория

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

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

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

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

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

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

.addClass( 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. Все методы классовых анимаций, включая.addClass(), позволяют задавать пользовательскую длительность анимации иeasing-функцию, а также предоставляют callback по завершении анимации.

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

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

Примеры

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

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>.addClass() 演示</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 ).addClass( "big-blue", 1000, "easeOutBounce" );
});
</script>
 
</body>
</html>

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