English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Método jQuery one()

Eventos de jQuery

El método one() adjunta uno o más manejadores de eventos a los elementos seleccionados.

También se adjunta la función que se debe ejecutar cuando ocurre el evento.

Este método se llama one porque cualquier manejador de eventos adjunto a este método para cada elementosolo se ejecutarán una vez.

Sintaxis:

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

Ejemplo

Añadir el evento click a todos los elementos <p> (el evento solo se desencadenará una vez para cada <p>):

$("p").one("click", function(){
  $(this).animate({fontSize: "+=5px"});
});
Prueba y observa‹/›

Mostrar la diferencia entre los métodos one() y on():

$(document).ready(function() {
  $("#para-1).one("click", myFunc);
  $("#para-2.on("click", myFunc);
});
Prueba y observa‹/›

Agregar varios manejadores de eventos a todos los elementos <p>

$("p").one("click dblclick", function() {
  $(this).animate({fontSize: "+=5px"});
});
Prueba y observa‹/›

Enviar datos a la función:

$(document).ready(function() {
  $("p").one("click", {msg: "¡Has hecho clic en mí!!!"}, showMsg)
});
function showMsg(event) {
  $(this).append(event.data.msg);
});
Prueba y observa‹/›

Valor del parámetro

ParámetrosDescripción
eventEspecificar un o varios eventos separados por espacio
data(Opcional)Especificar otros datos que se deben pasar al función
Nota:Si seDatosLos parámetros proporcionados al método one() se transmiten alevent.dataManejador en el atributo.
functionFunción a ejecutar al activar el evento

Eventos de jQuery