A stop metódus

A stop metódus lehetővé teszi számunkra, hogy azonnal megállítsuk a futó animációt. Az animáció a következő függvénynél folytatódik anélkül, hogy befejeződne az előző.

Szintaxis

Így állítjuk meg a futó animációt. Két opcionális paramétert is átadhatunk, amelyek Logikai értékeket fogadnak. Ha az első paramétert true-ra állítjuk, akkor a várólistában lévő többi animációs függvény törlődik és sosem fog elindulni. Ha a második paramétert true-ra állítjuk, akkor az animáció megállításakor az elem css-tulajdonságai azonnal felveszik a végső értékeiket (azaz ha a cél az elem sima elrejtése volt, akkor az azonnal el lesz rejtve):

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

Opcionálisan átadhatunk egy paramétert is, amelyben a várólista neve van megadva:

.stop([várólista neve], [clearQueue],[jumpToEnd]);

Az animáció globálisan is kikapcsolható a jQuery.fx.off = true beállítás használatával, amely az animáció időtartamát 0-ra állítja.

Példa

Tegyük úgy, hogy a #toggle gombra való minden kattintáskor a téglalapunk ki-becsúsztatható legyen a slideToggle metódus segítségével. Kattintsunk a gombra anélkül, hogy megvárnánk az animáció befejeződését - a következő lépés anélkül indul el, hogy befejeződött volna az előző, a stop metódusnak köszönhetően:

<button id="toggle">váltás</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);
});

Lásd még

a clearQueue metódus,
amely lehetővé teszi az összes befejezetlen elem eltávolítását a függvényvárólistából
a jQuery.fx.off tulajdonság,
amely lehetővé teszi az animáció globális kikapcsolását