A clearQueue metódus

A clearQueue metódus lehetővé teszi számunkra, hogy eltávolítsuk a sorból az összes még el nem indított függvényt.

Szintaxis

Így törölhetjük a függvények sorát. Opcionális paraméterként átadhatjuk a sor nevét sztring formájában (alapértelmezetten fx - a standard effektus sor). Ha nem adunk meg paramétert, akkor a fx sorból eltávolításra kerülnek az összes megmaradt függvény:

.clearQueue([sor neve]);

Ez a metódus analóg a stop metódussal. De, míg az utóbbi csak animációval tud dolgozni, addig a clearQueue bármely jQuery sorral lehetővé teszi a munkát, amit a queue metódussal adtunk hozzá.

Példa

Legyen úgy, hogy a #start gomb megnyomásakor elindítjuk az animációt. A #stop gomb megnyomásakor leállítjuk az animációt és megtisztítjuk a sort a clearQueue metódus segítségével. A #start gomb ismételt megnyomásakor az animáció újrakezdődik:

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

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

div.newcolor {
	background: green;
}

$('#start').click(function() {

	let myDiv = $('div');
	
	myDiv.show('slow');
	
	myDiv.animate({
		left: '+=200'
	}, 5000);
	
	myDiv.queue(function() {
		let that = $(this);
		that.addClass('newcolor');
		that.dequeue();
	});
	
	myDiv.animate({
		left: '-=200'
	}, 1500);
	
	myDiv.queue(function() {
		let that = $(this);
		that.removeClass('newcolor');
		that.dequeue();
	});
	
	myDiv.slideUp();
});
	
$('#stop').click(function() {
	let myDiv = $('div');
	myDiv.clearQueue();
	myDiv.stop();
});

Lásd még

a queue metódus,
amely lehetővé teszi a függvények sorának megjelenítését és módosítását
a dequeue metódus,
amely lehetővé teszi a sorban következő függvény végrehajtását
a stop metódus,
amely lehetővé teszi az elindított animáció leállítását
a animate metódus,
amely animálja az elemek tulajdonságait