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):

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

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

javascript.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:

html<button id="toggle">váltás</button>
<div id="test"></div>
css#test {
  background-color: green;
  border: 1px solid black;
  width: 200px;
  height: 100px;
  margin: 10px;
}
javascript$('#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