Método dequeue

O método dequeue nos permite executar a próxima função da fila de funções. Quando chamado, o método remove a função da fila e então a executa. A função deve chamar este método para que a cadeia de funções possa continuar a ser executada. Veja também o método queue, que nos permite trabalhar com a fila de funções vinculadas a um elemento.

Sintaxe

É assim que podemos continuar o trabalho das próximas funções na fila. Podemos passar como parâmetro opcional o nome da fila como uma string. Se nenhum parâmetro for passado, o método trabalhará com a fila fx:

javascript.dequeue([nome da fila]);

Exemplo

Neste exemplo, com o método queue, adicionaremos uma função personalizada que recolorirá o quadrado para verde, adicionando a classe newcolor. Como você pode ver, em seguida é chamado dequeue, para remover a função da fila e permitir que a próxima seja executada:

html<button id="animate">start</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$('#animate').click(function() {
  $('div')
    .show('slow')
    .animate({left: '+=200'}, 2000)
    .queue(function() {
      $(this).addClass('newcolor').dequeue();
    })
    .animate({left: '-=200'}, 500)
    .queue(function() {
      $(this).removeClass('newcolor').dequeue();
    })
    .slideUp();
});

Veja também

  • método queue,
    que permite mostrar e alterar a fila de funções
  • método clearQueue,
    que permite remover todos os itens não executados da fila de funções