jQuery метод .queue()
Определение и применение
jQuery метод .queue() отображает или манипулирует очередью функций, которые должны быть выполнены у выбранных элементов.
Каждый элемент может иметь от одной до нескольких очередей функций, присоединенных к нему jQuery. В большинстве
приложений используется только одна очередь (называемая "fx"). Очереди позволяют асинхронно вызывать
последовательность действий над элементом без остановки выполнения программы. Типичным примером этого является вызов
нескольких методов анимации для элемента подряд (например, скрытие элемента, а затем отображение, длина очереди
анимаций в этом случае составит равной двум).
jQuery синтаксис:
Синтаксис 1.2:
// отображение очереди
$( selector ).queue()
$( selector ).queue( queue )
// манипулирование очередью
$( selector ).queue( queue, newQueue )
$( selector ).queue( queue, callback( goNext ) )queue - String
newQueue - Array
callback - Function( Function goNext )
Добавлен в версии jQuery
1.2Значения параметров
| Параметр | Описание |
|---|---|
| queue | Строковое значение, определяющее имя очереди, в которой необходимо остановить анимацию. По умолчанию используется очередь стандартных эффектов fx. Необязательный параметр. |
| newQueue | Массив функций для замены текущего содержимого очереди. |
| callback | Функция обратного вызова, которая добавляет в конец текущей очереди новую функцию. Функция принимает один аргумент, который позволяет выполнить метод .dequeu() на текущей функции для продолжения цепочки (необходим вызов внутри функции - наименованиеАргумента()). Вы можете запустить метод .dequeu() в ручную, поэтому аргумент не является обязательным. Функция обратного вызова выполняется один раз для каждого элемента в наборе jQuery. |
Пример использования
Пример использования jQuery метода .queue() (отображение очереди)
Нажмите , затем выполните действие из пояснения. Измените JavaScript и запустите пример ещё раз. В редакторе используется jQuery 4.0.0.
index.html
<div></div>
main.js
$(document).ready(function () {
function animate() {
$('div')
.animate({ width: '30%' }, 2000)
.animate({ width: '50%' }, 2000)
.animate({ width: '70%' }, 2000)
.animate({ width: '90%' }, 2000, animate)
}
function showQueueLength() {
var queueLength = $('div').queue().length // параметр "fx" по умолчанию
$('div').text('Длина очереди: ' + queueLength)
setTimeout(showQueueLength, 100)
}
animate()
showQueueLength()
})
style.css
div {
width: 80px;
height: 80px;
border: 2px solid orange;
margin-top: 50px;
}
Нажмите , чтобы запустить пример.
В этом примере мы при загрузке документа запускаем следующие две функии:
- Функция animate, которая с помощью методов .animate() поочередно запускает четыре различных анимации, которые увеличивают ширину элемента, длительностью 2 секунды каждая и по завершению четветртой вызываем функцию animate вновь.
-
Функция showQueueLength, которая с помощью метода .queue() получает длину очереди функций,
которые должны быть выполнены у выбранных элементов
<div>. Обратите внимание, что метод использовался без параметра (значение по умоланию "fx"). Затем с помощью метода .text() добавляем элементу<div>новое текстовое содержимое - значение, которое определяет длину очереди, и с помощью функции setTimeout запускаем функцию showQueueLength через 100 миллисекунд.
Рассмотрим следующий пример в котором с помощью метода .queue() мы научимся манипулировать очередью:
Пример использования jQuery метода .queue() (манипулирование очередью)
Нажмите , затем выполните действие из пояснения. Измените JavaScript и запустите пример ещё раз. В редакторе используется jQuery 4.0.0.
index.html
<button class="start">start</button>
<div></div>
main.js
$(document).ready(function () {
function animate() {
$('div')
.css('width', '80px')
.animate({ width: '30%' }, 2000)
.queue(function (go) {
$(this).css('border-color', 'violet')
go() // или $(this).dequeue(), если без параметра
})
.animate({ width: '50%' }, 2000)
.queue(function (go) {
$(this).css('border-color', 'green')
go() // или $(this).dequeue(), если без параметра
})
.animate({ width: '70%' }, 2000)
.queue(function (go) {
$(this).css('border-color', 'orange')
go() // или $(this).dequeue(), если без параметра
})
.animate({ width: '90%' }, 2000)
}
$('.start').click(function () {
animate()
})
})
style.css
div {
width: 80px;
height: 80px;
border: 2px solid orange;
margin-top: 50px;
}
Нажмите , чтобы запустить пример.
В этом примере мы разместили в документе один элемент
<div>
и одну кнопку (элемент
<button>), для которой назначили обработчик события "click" (клик левой кнопкой мыши).
При нажатии на неё вызываем функцию, которая запускает функцию animate, которая с помощью методов
.animate()
поочередно запускает четыре различных анимации, которые увеличивают ширину элемента, длительностью
2 секунды каждая. Обратите внимание, что мы между методов
.animate()
используем методы .queue() благодаря которым манипулируем очередью функций, которые должны быть выполнены у
выбранных элементов, изменяя при этом цвет границ элемента с помощью метода
.css(). В качестве параметра метода .queue() передается функция, которая добавляет в конец текущей очереди новую
функцию при вызове. Вы можете обойтись без этого параметра и вызывать метод .dequeue() напрямую - $(
this ).dequeue().
Рассмотрим следующий пример в котором методу .queue() мы передадим новый массив функций:
Пример использования jQuery метода .queue() (создание новой очереди)
Нажмите , затем выполните действие из пояснения. Измените JavaScript и запустите пример ещё раз. В редакторе используется jQuery 4.0.0.
index.html
<button class="start">start</button>
<button class="new">new queue</button>
<div></div>
main.js
$(document).ready(function () {
function animateWidth() {
$('div')
.animate({ width: '30%' }, 500)
.animate({ width: '50%' }, 500)
.animate({ width: '70%' }, 500)
.animate({ width: '90%' }, 500, animateWidth)
}
function animateHeight() {
$('div')
.animate({ height: '30%' }, 500)
.animate({ height: '50%' }, 500)
.animate({ height: '70%' }, 500)
.animate({ height: '90%' }, 500, animateHeight)
}
$('.start').click(function () {
animateWidth()
})
$('.new').click(function () {
var newQueue = [animateHeight] // массив с одной функцией
$('div').queue(newQueue) // значение первого параметра по умолчанию "fx"
})
})
style.css
body {
height: 250px;
}
div {
width: 80px;
height: 80px;
border: 2px solid orange;
margin-top: 50px;
}
Нажмите , чтобы запустить пример.
В этом примере мы разместили в документе один элемент
<div>
и две кнопки (элемент
<button>), для которых назначили обработчик события "click" (клик левой кнопкой мыши).
- Первая кнопка запускает функцию animate, которая с помощью методов .animate() поочередно запускает четыре различных анимации, которые увеличивают ширину элемента, длительностью пол секунды каждая и по завершению четветртой вызывает функцию animate вновь.
- Вторая кнопка инициализирует переменную, содержащую массив из одной функции для замены текущего содержимого очереди и с помощью метода .queue() изменяет текущее содержимое очереди, благодаря чему элемент будет воспроизводить уже анимацию, которая будет увеличивать высоту элемента, а не ширину.