Método jQuery off()

❮ Métodos de eventos jQuery

Exemplo

Remova o evento click de todos os elementos <p>:

$("button").click(function(){
  $("p").off("click");
});

Definição e uso

O método off() é mais frequentemente usado para remover manipuladores de eventos anexados ao método on() .

A partir da versão 1.7 do jQuery, o método off() é o novo substituto para os métodos unbind(), die() e undelegate(). Esse método traz muita consistência para a API, e recomendamos que você use esse método, pois simplifica a base de código do jQuery. 

Nota: Para remover manipuladores de eventos específicos, a string do seletor deve corresponder àquela passada para o método on(), quando o manipulador de eventos foi anexado. 

Dica: Para anexar um evento que é executado apenas uma vez e depois se remove, use o método one() .


Sintaxe

$(selector).off(event,selector,function(eventObj),map)

Parameter Description
event Required. Specifies one or more events or namespaces to remove from the selected element(s).

Multiple event values are separated by a space. Must be a valid event
selector Optional. A selector which should match the one originally passed to the on() method when attaching event handlers
function(eventObj) Optional. Specifies the function to run when the event occurs
map Specifies an event map ({event:function, event:function, ...}) containing one or more event to attach to the elements, and functions to run when the events occur

Experimente você mesmo - Exemplos


Como remover todos os manipuladores de eventos de clique para todos os elementos <p> adicionados com o método on().


Como remover uma função específica adicionada com o método on().


de evento Como remover um manipulador de eventos após o evento ter sido acionado um determinado número de vezes.


❮ Métodos de eventos jQuery