Método dequeue

El método dequeue nos permite ejecutar la siguiente función de la cola de funciones. Al llamar al método, la función se elimina de la cola y luego se ejecuta. La función debe llamar a este método para que la cadena de funciones pueda ejecutarse continuar. Véase también el método queue, que nos permite trabajar con la cola de funciones, asociadas al elemento.

Sintaxis

Así podemos continuar con el trabajo de las siguientes funciones en la cola. Se puede pasar como parámetro opcional el nombre de la cola en forma de cadena. Si no se pasa ningún parámetro, el método trabajará con la cola fx:

.dequeue([nombre de la cola]);

Ejemplo

En este ejemplo, usando el método queue, agregaremos una función personalizada que repintará el cuadrado en verde, agregando la clase newcolor. Como puede ver, luego aquí se llama a dequeue, para quitar la función de la cola y permitir que se ejecute la siguiente:

<button id="animate">start</button>
<div></div>

div {
	position: absolute;
	margin: 3px;
	width: 50px;
	height: 50px;
	left: 0px;
	top: 30px;
	background: red;
	display: none;
}

div.newcolor {
	background: green;
}

$('#animate').click(function() {
	$('div')
		.show('slow')
		.animate({left: '+=200'}, 2000)
		.queue(function() {
			$(this).addClass('newcolor').dequeue();
		})
		.animate({left: '-=200'}, 500)
		.queue(function() {
			$(this).removeClass('newcolor').dequeue();
		})
		.slideUp();
});

Véase también

método queue,
que permite mostrar y modificar la cola de funciones
método clearQueue,
que permite eliminar todos los elementos no ejecutados de la cola de funciones