Methode clearQueue

Die Methode clearQueue ermöglicht es uns, alle Funktionen aus der Warteschlange zu entfernen, die noch nicht gestartet wurden.

Syntax

So können wir die Funktionswarteschlange leeren. Optional kann der Name der Warteschlange als Zeichenkette übergeben werden (Standard ist fx - die Standard-Effekt-Warteschlange). Wenn keine Parameter übergeben werden, werden alle verbleibenden Funktionen aus der fx-Warteschlange entfernt:

.clearQueue([Warteschlangenname]);

Diese Methode ist ähnlich der Methode stop. Aber, während letztere nur mit Animationen arbeiten kann, ermöglicht clearQueue die Arbeit mit jeder jQuery-Warteschlange, die mit der Methode queue hinzugefügt wurde.

Beispiel

Lassen Sie uns bei einem Klick auf die Schaltfläche #start die Animation starten. Bei einem Klick auf die Schaltfläche #stop werden wir die Animation anhalten und die Warteschlange mit der Methode clearQueue leeren. Bei erneutem Klick auf #start beginnt die Animation von Neuem:

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

Siehe auch

Methode queue,
die das Anzeigen und Ändern der Funktionswarteschlange ermöglicht
Methode dequeue,
die das Ausführen der nächsten Funktion in der Funktionswarteschlange ermöglicht
Methode stop,
die das Anhalten einer laufenden Animation ermöglicht
Methode animate,
die Eigenschaften von Elementen animiert