jQuery.Callbacks()Méthode

jQuery 杂项方法Méthodes diverses jQuery

Exemples

Ajouter une fonction de rappel à la liste $.Callbacks

$(function () { function fn1( value ) { alert( value ); } function fn2( value ) { fn1("fn2 dit : " + value); return false; } var callbacks = $.Callbacks(); callbacks.add( fn1 ); //Sortie : foo! callbacks.fire( "foo!" ); callbacks.add( fn2 ); //Sortie : bar!, fn2 dit : bar! callbacks.fire( "bar!" ); })

Essayez-le vous-même »

Définition et utilisation

$.Callbacks() fait référence à un objet liste de fonctions de rappel polyvalent qui fournit un moyen puissant de gérer les files d'attente de fonctions de rappel.

Astuce :$.Callbacks est utilisé en interne dans jQuery, comme les fonctions qui fournissent les fonctionnalités de base pour des composants tels que .ajax, $.Deferred, etc. Il peut également être utilisé dans certains composants ayant des fonctionnalités similaires, comme des plugins développés par vous-même.


Syntaxe

$.Callbacks( flags )

Parameters Description
indicateurs Facultatif. Type String. Une liste facultative séparée par des espaces pour modifier le comportement de la liste de callbacks.


实例

Plus d’exemples

Voici un exemple d'utilisation de .remove() pour supprimer un callback spécifique de la liste de callbacks.

Exemple

$(function () { function fn1( value ) { alert( value ); } function fn2( value ) { fn1("fn2 dit : " + value); return false; } var callbacks = $.Callbacks(); callbacks.add( fn1 ); //Sortie : foo! callbacks.fire( "foo!" ); callbacks.add( fn2 ); //Sortie : bar!, fn2 dit : bar! callbacks.fire( "bar!" ); callbacks.remove( fn2 ); //Seul foobar est affiché ; fn2 a été supprimé. callbacks.fire( "foobar" ); })

Essayez-le vous-même »


Paramètres de flags pris en charge

Ce paramètre flags est un paramètre optionnel de $.Callbacks(). Il est structuré comme une liste optionnelle de flags séparés par des espaces pour modifier le comportement de la liste de callbacks (par exemple $.Callbacks( 'unique stopOnFalse' )).
Les flags suivants sont disponibles :

Parameters Description
once Garantit que cette liste de callbacks n'est exécutée qu'une seule fois.
memory Met en cache les valeurs des paramètres du dernier fire. Lorsque add() ajoute une fonction de callback, appelle immédiatement la fonction de callback nouvellement ajoutée avec les valeurs des paramètres du dernier fire.
unique Un callback ne peut être ajouté qu'une seule fois et ne sera pas ajouté de façon répétée. stopOnFalse Après qu'une fonction de callback renvoie false, interrompt les fonctions de callback suivantes.

Ci-dessous se trouve un exemple de $.Callbacks( "once" ).

Exemple

$(function () { function fn1( value ) { alert( value ); } function fn2( value ) { fn1("fn2 dit : " + value); return false; } var callbacks = $.Callbacks( "once" ); callbacks.add( fn1 ); callbacks.fire( "foo" ); callbacks.add( fn2 ); callbacks.fire( "bar" ); callbacks.remove( fn2 ); callbacks.fire( "foobar" ); /*Affiche uniquement : foo*/ })

Essayez-le vous-même »

Voici un exemple de $.Callbacks( "memory" ).

Exemple

$(function () { function fn1( value ) { alert( value ); } function fn2( value ) { fn1("fn2 dit : " + value); return false; } var callbacks = $.Callbacks( "memory" ); callbacks.add( fn1 ); callbacks.fire( "foo" ); callbacks.add( fn2 ); callbacks.fire( "bar" ); callbacks.remove( fn2 ); callbacks.fire( "foobar" ); /*Sortie : foo fn2 dit : foo bar fn2 dit : bar foobar*/ })

Essayez-le vous-même »

Voici un exemple de $.Callbacks( "unique" ).

Exemple

$(function () { function fn1( value ) { alert( value ); } function fn2( value ) { fn1("fn2 dit : " + value); return false; } var callbacks = $.Callbacks( "unique" ); callbacks.add( fn1 ); callbacks.fire( "foo" ); callbacks.add( fn1 ); // répéter l'ajout callbacks.add( fn2 ); callbacks.fire( "bar" ); callbacks.remove( fn2 ); callbacks.fire( "foobar" ); /*Sortie : foo bar fn2 dit : bar foobar*/ })

Essayez-le vous-même »

Voici un exemple de $.Callbacks( "stopOnFalse" ).

Exemple

$(function () { function fn1( value ) { alert( value ); return false; } function fn2( value ) { fn1( "fn2 says: " + value ); return false; } var callbacks = $.Callbacks( "stopOnFalse" ); callbacks.add( fn1 ); callbacks.fire( "foo" ); callbacks.add( fn2 ); callbacks.fire( "bar" ); callbacks.remove( fn2 ); callbacks.fire( "foobar" ); /*Sortie : foo bar foobar*/ })

Essayez-le vous-même »

$.Callbacks() prend en charge la définition de plusieurs drapeaux (identifiants) dans une liste plutôt qu'un seul, et a un effet cumulatif, similaire à "&&".
Voici un exemple de $.Callbacks( 'unique memory' ).

Exemple

$(function () { function fn1( value ) { alert( value ); return false; } function fn2( value ) { fn1( "fn2 says: " + value ); return false; } var callbacks = $.Callbacks( "unique memory" ); callbacks.add( fn1 ); callbacks.fire( "foo" ); callbacks.add( fn1 ); // répéter l'ajout callbacks.add( fn2 ); callbacks.fire( "bar" ); callbacks.add( fn2 ); callbacks.fire( "baz" ); callbacks.remove( fn2 ); callbacks.fire( "foobar" ); /*Sortie : foo fn2 says:foo bar fn2 says:bar baz fn2 says:baz foobar*/ })

Essayez-le vous-même »

La méthode $.Callbacks peut aussi être séparée, par exemple :

Exemple

$(function () { function fn1( value ) { alert( value ); } var callbacks = $.Callbacks(), add = callbacks.add, remove = callbacks.remove, fire = callbacks.fire; add( fn1 ); fire( "hello world" ); remove( fn1 ); /*Sortie : hello world*/ })

Essayez-le vous-même »


$.Callbacks, $.Deferred et Pub/Sub

L'idée générale derrière pub/sub (modèle observateur) est de favoriser un couplage faible et une communication efficace dans les applications. Les observateurs, aussi appelés abonnés, pointent vers le sujet observé. L'éditeur notifie les abonnés lorsqu'un événement se produit.

Comme démonstration des composants créés par $.Callbacks(), vous pouvez implémenter un système Pub/Sub en utilisant uniquement la liste de fonctions de rappel. En utilisant $.Callbacks comme file de sujets, vous pouvez publier et vous abonner à des sujets comme suit :

Exemple

$(function () { function fn1( value ) { alert( value ); return false; } function fn2( value ) { fn1( "fn2 says: " + value ); return false; } var topics = {}; jQuery.Topic = function( id ) { var callbacks, method, topic = id && topics[ id ]; if ( !topic ) { callbacks = jQuery.Callbacks(); topic = { publish: callbacks.fire, subscribe: callbacks.add, unsubscribe: callbacks.remove }; if ( id ) { topics[ id ] = topic; } } return topic; }; //Subscriber $.Topic( "mailArrived" ).subscribe( fn1 ); $.Topic( "mailArrived" ).subscribe( fn2 ); $.Topic( "mailSent" ).subscribe( fn1 ); //Publisher $.Topic( "mailArrived" ).publish( "hello world!" ); $.Topic( "mailSent" ).publish( "woo! mail!" ); /*Sortie : hello world! fn2 dit : hello world! woo! mail!*/ })

Essayez-le vous-même »

Une amélioration supplémentaire utilisant les $.Deferred peut garantir que l'éditeur ne publie des notifications aux abonnés que lorsqu'une tâche spécifique est terminée (ou résolue). Voir l'exemple de code ci-dessous :

Exemple

$(function () { function fn1( value ) { alert( value ); return false; } function fn2( value ) { fn1( "fn2 says: " + value ); return false; } var topics = {}; jQuery.Topic = function( id ) { var callbacks, method, topic = id && topics[ id ]; if ( !topic ) { callbacks = jQuery.Callbacks(); topic = { publish: callbacks.fire, subscribe: callbacks.add, unsubscribe: callbacks.remove }; if ( id ) { topics[ id ] = topic; } } return topic; }; //S'abonner aux notifications mailArrived $.Topic( "mailArrived" ).subscribe( fn1 ); //Créer un nouvel objet pour remplacer les $.Deferred différés var dfd = $.Deferred(); //Définir un nouveau sujet (non publié directement) var topic = $.Topic( "mailArrived" ); //Lorsque l'objet différé est résolu, publier une notification aux abonnés dfd.done( topic.publish ); /*Ici, le message à renvoyer à l'abonné est différé jusqu'à ce qu'il soit résolu. Il intègre des procédures complexes autant que possible (par ex., attendre la fin d'un appel Ajax), donc en fait le message n'est publié qu'une seule fois.*/ //Terminé. dfd.resolve( "Déjà publié !" ); })

Essayez-le vous-même »


jQuery 杂项方法Méthodes diverses jQuery

Autres extensions