Método jQuery on()

❮ Métodos de eventos jQuery

Exemplo

Anexe um evento de clique ao elemento <p>:

$("p").on("click", function(){
  alert("The paragraph was clicked.");
});

Definição e uso

O método on() anexa um ou mais manipuladores de eventos para os elementos selecionados e elementos filho.

A partir da versão 1.7 do jQuery, o método on() é o novo substituto para os métodos bind(), live() e delegate(). 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: Manipuladores de eventos anexados usando o método on() funcionarão para elementos atuais e FUTURE (como um novo elemento criado por um script).

Dica: Para remover manipuladores de eventos, use o método off() .

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


Sintaxe

$(selector).on(event,childSelector,data,function,map)

Parameter Description
event Required. Specifies one or more event(s) or namespaces to attach to the selected elements.

Multiple event values are separated by space. Must be a valid event
childSelector Optional. Specifies that the event handler should only be attached to the specified child elements (and not the selector itself, like the deprecated delegate() method).
data Optional. Specifies additional data to pass along to the function
function Required. 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 selected elements, and functions to run when the events occur

Experimente você mesmo - Exemplos


Como anexar vários eventos a um elemento.


Como anexar vários manipuladores de eventos aos elementos selecionados usando o parâmetro map.


Como anexar um evento de namespace personalizado em um elemento.


Como passar dados para a função.


Mostre que o método on() também funciona para elementos ainda não criados.


de eventos Como remover um manipulador de eventos usando o método off().


❮ Métodos de eventos jQuery