Método dequeue

O método dequeue nos permite executar a próxima função da fila de funções. Quando chamado, o método remove a função da fila e então a executa. A função deve chamar este método para que a cadeia de funções possa continuar a ser executada. Veja também o método queue, que nos permite trabalhar com a fila de funções vinculadas a um elemento.

Sintaxe

É assim que podemos continuar o trabalho das próximas funções na fila. Podemos passar como parâmetro opcional o nome da fila como uma string. Se nenhum parâmetro for passado, o método trabalhará com a fila fx:

.dequeue([nome da fila]);

Exemplo

Neste exemplo, com o método queue, adicionaremos uma função personalizada que recolorirá o quadrado para verde, adicionando a classe newcolor. Como você pode ver, em seguida é chamado dequeue, para remover a função da fila e permitir que a próxima seja executada:

<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();
});

Veja também

método queue,
que permite mostrar e alterar a fila de funções
método clearQueue,
que permite remover todos os itens não executados da fila de funções