jQuery one() Method

jQuery Events

The one() method attaches one or more event handlers to the selected elements.

also attaches the function to be executed when the event occurs.

This method is named one because any event handler attached to this method for each elementwill only run once.

Syntax:

$(selector).one(event, data, function)

Example

Attach a click event to all <p> elements (the event will only trigger once for each <p> element):

$("p").one("click", function(){
　　$(this).animate({fontSize: "+=5px"});
});

Display the difference between the one() and on() methods:

$(document).ready(function() {
　　$("#para-1").one("click", myFunc);
　　$("#para-2.on("click", myFunc);
});

Add multiple event handlers to all <p> elements:

$("p").one("click　dblclick", function() {
　　$(this).animate({fontSize: "+=5px"});
});

Pass data to the function:

$(document).ready(function() {
　　$("p").one("click", {msg: "You just clicked me!!!"}, showMsg)
});
function showMsg(event) {
　　$(this).append(event.data.msg);
});

Parameter Value

jQuery Events