Metoda stop

Metoda stop pozwala nam natychmiast zatrzymać uruchomioną animację. Animacja będzie kontynuowana od następnej funkcji bez ukończenia poprzedniej.

Składnia

W ten sposób zatrzymujemy uruchomioną animację. Można przekazać dwa opcjonalne parametry, które przyjmują wartości logiczne. Jeśli pierwszy parametr ustawimy jako true, wówczas pozostałe funkcje w kolejce animacji zostaną usunięte i nigdy nie uruchomią się. Jeśli drugi parametr ustawimy na true, to po zatrzymaniu animacji właściwości css elementu natychmiast przyjmą swoje końcowe wartości (tzn., jeśli celem było płynne ukrycie elementu, to zostanie on ukryty natychmiast):

.stop([clearQueue], [jumpToEnd]);

Można również przekazać opcjonalny parametr, w którym podaje się nazwę kolejki:

.stop([nazwa kolejki], [clearQueue],[jumpToEnd]);

Animację można wyłączyć globalnie, używając ustawienia jQuery.fx.off = true, które ustawia wartość czasu trwania na 0.

Przykład

Sprawmy, aby przy każdym kliknięciu przycisku #toggle nasz prostokąt raz rozwijał się, raz zwijał za pomocą metody slideToggle. Klikaj przycisk, nie czekając na zakończenie animacji - następny etap uruchomi się, nie czekając na ukończenie poprzedniego, dzięki metodzie stop:

<button id="toggle">toggle</button>
<div id="test"></div>

#test {
	background-color: green;
	border: 1px solid black;
	width: 200px;
	height: 100px;
	margin: 10px;
}

$('#toggle').on('click', function() {
	$('#test').stop().slideToggle(1500);
});

Zobacz też

metoda clearQueue,
która pozwala usunąć wszystkie niewykonane elementy z kolejki funkcji
właściwość jQuery.fx.off,
która pozwala globalnie wyłączyć animację