Metoda clearQueue

Metoda clearQueue nám umožňuje odstranit z fronty všechny funkce, které nebyly spuštěny.

Syntaxe

Tímto způsobem můžeme vyčistit frontu funkcí. Lze předat nepovinný parametr název fronty ve formě řetězce (výchozí je fx - standardní fronta efektů). Pokud nepředáte žádné parametry, z fronty fx budou odstraněny všechny zbývající funkce:

javascript.clearQueue([název fronty]);

Tato metoda je analogická metodě stop. Ale, pokud poslední jmenovaná může pracovat pouze s animací, clearQueue umožňuje pracovat s jakoukoli frontou jQuery, která byla přidána metodou queue.

Příklad

Při kliknutí na tlačítko #start spustíme animaci. Při kliknutí na tlačítko #stop zastavíme animaci a vyčistíme frontu pomocí metody clearQueue. Při opětovném kliknutí na #start animace začne znovu:

html<button id="start">start</button>
<button id="stop">stop</button>
<div></div>
cssdiv {
  position: absolute;
  margin: 3px;
  width: 50px;
  height: 50px;
  left: 0px;
  top: 30px;
  background: red;
  display: none;
}

div.newcolor {
  background: green;
}
javascript$('#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();
});

Viz také

  • metoda queue,
    která umožňuje zobrazit a změnit frontu funkcí
  • metoda dequeue,
    která umožňuje provést další funkci ve frontě funkcí
  • metoda stop,
    která umožňuje zastavit spuštěnou animaci
  • metoda animate,
    která animuje vlastnosti elementů