Déclenche un évènement particulier pour les éléments de la sélection. Mais contrairement a la fonction trigger(), cette méthode ne déclenche pas l'action par défaut du navigateur pour ce type d'évènement, ni le bouillonnement d'évènements, et les évènements live. Seconde différence, cette méthode sera appliquée seulement au premier élément de la sélection.
La méthode renvoie la valeur du gestionnaire d'évènement, ou 'undefined' si la sélection jQuery ne contient pas d'éléments.
Version: disponible depuis la version 1.3 de JQuery
Paramétres:
Valeur de retour: valeur de l'évènement déclenché
Exemple montrant la différence entre trigger et triggerhandler. Pour les deux un message "Focused!" va apparaitre. Mais seulement la fonction trigger déclenchera l'action du naviguateur associée a la méthode qui place le curseur dans le champ de saisie du formulaire.
$("#old").click(function(){
$("input").trigger("focus");
});
$("#new").click(function(){
$("input").triggerHandler("focus");
});
$("input").focus(function(){
$("<span>Focused!</span>").appendTo("body").fadeOut(1000);
});
Code de test:
<button id="old">.trigger("focus")</button>
<button id="new">.triggerHandler("focus")</button><br/><br/>
<input type="text" value="To Be Focused"/>