Méthode dequeue

La méthode dequeue nous permet d'exécuter la fonction suivante de la file des fonctions. Lors de l'appel de la méthode, la fonction est retirée de la file, puis exécutée. La fonction doit appeler cette méthode pour que la chaîne de fonctions puisse continuer à s'exécuter. Voir aussi la méthode queue, qui nous permet de travailler avec la file des fonctions attachées à l'élément.

Syntaxe

C'est ainsi que nous pouvons poursuivre l'exécution des fonctions suivantes dans la file. On peut passer en paramètre optionnel le nom de la file sous forme de chaîne. Si aucun paramètre n'est passé, la méthode fonctionnera avec la file fx :

.dequeue([nom de la file]);

Exemple

Dans cet exemple, à l'aide de la méthode queue, nous ajouterons une fonction personnalisée qui recolorera le carré en vert en ajoutant la classe newcolor. Comme vous pouvez le voir, nous appelons ensuite dequeue ici, pour retirer la fonction de la file et permettre l'exécution de la suivante :

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

Voir aussi

la méthode queue,
qui permet d'afficher et de modifier la file des fonctions
la méthode clearQueue,
qui permet de supprimer tous les éléments non exécutés de la file des fonctions