Справочник API
jQuery.dequeue()
Содержание статьи
-
Приводит в исполнение следующую функцию в очереди для указанного элемента, прерванной при использовании .queue().
Синтаксис и описание:
Добавлено в jQuery 1.3jQuery.dequeue( element [, queueName ] )
Статический метод jQuery.dequeue() — низкоуровневый аналог .dequeue(): делает ровно то же самое (запускает следующую функцию очереди), но принимает не набор jQuery, а сразу конкретный DOM-элемент, без предварительного оборачивания в
$().
Возвращаемое значение: не возвращает значения (undefined).
Параметры:
element – (DOM-элемент) Элемент, из очереди которого нужно убрать и выполнить следующую функцию.
queueName – (строка) Необязательный параметр. Имя очереди. По умолчанию —
"fx".
Примечание:
Официальная документация прямо называет метод низкоуровневым и рекомендует в обычном коде пользоваться методом набора .dequeue(), а не этой статической функцией.
Примечание:
Практическая причина обращаться именно к jQuery.dequeue() — авторство низкоуровневых jQuery-плагинов или внутренних утилит, где на входе уже есть «голый» DOM-элемент и оборачивать его в
$()ради единственного вызова избыточно.В jQuery 3.x и 4.0:
Метод не деприкейчен. Как и .dequeue(), недоступен в slim-сборке: эффектов там нет с jQuery 3.0, а с 4.0 в slim дополнительно нет модулей
deferred/queue.
Примеры:
Использование низкоуровневой версии внутри вспомогательной функции, принимающей «голый» элемент.
function advanceQueue(domElement) { jQuery.dequeue(domElement, 'steps'); } var box = document.getElementById('box'); advanceQueue(box);То же самое обычным способом через .dequeue() — предпочтительный вариант для прикладного кода.
$('#box').dequeue('steps');