Μέθοδος clearQueue

Η μέθοδος clearQueue μας επιτρέπει να αφαιρέσουμε από την ουρά όλες τις συναρτήσεις που δεν έχουν εκτελεστεί.

Σύνταξη

Έτσι μπορούμε να καθαρίσουμε την ουρά συναρτήσεων. Μπορούμε να περάσουμε ως προαιρετική παράμετρο το όνομα της ουράς σε μορφή συμβολοσειράς (προεπιλογή fx - η τυπική ουρά εφέ). Αν δεν περάσουμε καμία παράμετρο, τότε από την ουρά fx θα αφαιρεθούν όλες οι υπόλοιπες συναρτήσεις:

.clearQueue([όνομα ουράς]);

Αυτή η μέθοδος είναι ανάλογη της μεθόδου stop. Αλλά, ενώ η τελευταία μπορεί να δουλέψει μόνο με κινούμενα σχέδια, η clearQueue επιτρέπει την εργασία με οποιαδήποτε ουρά jQuery, που έχει προστεθεί με τη μέθοδο queue.

Παράδειγμα

Ας κάνουμε έτσι ώστε με πάτημα στο κουμπί #start, να ξεκινάμε το κινούμενο σχέδιο. Με πάτημα στο κουμπί #stop θα σταματάμε το κινούμενο σχέδιο και θα καθαρίζουμε την ουρά χρησιμοποιώντας τη μέθοδο clearQueue. Με επαναλαμβανόμενο πάτημα στο #start το κινούμενο σχέδιο θα ξεκινάει από την αρχή:

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

Δείτε επίσης

μέθοδος queue,
που επιτρέπει την εμφάνιση και αλλαγή της ουράς συναρτήσεων
μέθοδος dequeue,
που επιτρέπει την εκτέλεση της επόμενης συνάρτησης στην ουρά συναρτήσεων
μέθοδος stop,
που επιτρέπει τη διακοπή ενός κινούμενου σχεδίου που έχει ξεκινήσει
μέθοδος animate,
που κινεί τις ιδιότητες των στοιχείων