Справочник API

jQuery.dequeue()

Содержание статьи
  • Категории: Data ,  Utilities

    Приводит в исполнение следующую функцию в очереди для указанного элемента, прерванной при использовании .queue().

Синтаксис и описание:

  • Добавлено в jQuery 1.3jQuery.dequeue( element [, queueName ] )

  • Статический метод jQuery.dequeue() — низкоуровневый аналог .dequeue(): делает ровно то же самое (запускает следующую функцию очереди), но принимает не набор jQuery, а сразу конкретный DOM-элемент, без предварительного оборачивания в $().

Возвращаемое значение: не возвращает значения (undefined).

Параметры:

  • element – (DOM-элемент) Элемент, из очереди которого нужно убрать и выполнить следующую функцию.

  • queueName – (строка) Необязательный параметр. Имя очереди. По умолчанию — "fx".

  1. Примечание:

    Официальная документация прямо называет метод низкоуровневым и рекомендует в обычном коде пользоваться методом набора .dequeue(), а не этой статической функцией.

  2. Примечание:

    Практическая причина обращаться именно к jQuery.dequeue() — авторство низкоуровневых jQuery-плагинов или внутренних утилит, где на входе уже есть «голый» DOM-элемент и оборачивать его в $() ради единственного вызова избыточно.

  3. В jQuery 3.x и 4.0:

    Метод не деприкейчен. Как и .dequeue(), недоступен в slim-сборке: эффектов там нет с jQuery 3.0, а с 4.0 в slim дополнительно нет модулей deferred/queue.

Примеры:

  1. Использование низкоуровневой версии внутри вспомогательной функции, принимающей «голый» элемент.

    function advanceQueue(domElement) {
      jQuery.dequeue(domElement, 'steps');
    }
    
    var box = document.getElementById('box');
    advanceQueue(box);
  2. То же самое обычным способом через .dequeue() — предпочтительный вариант для прикладного кода.

    $('#box').dequeue('steps');

[ наверх ]

Вопросы и ответы

Для чего используется jQuery.dequeue()?

Приводит в исполнение следующую функцию в очереди для указанного элемента, прерванной при использовании .queue().

Поиск по материалам

Начните вводить — поиск работает по заголовкам и тексту.

Esc — закрытьВсе материалы →