jQuery.Callbacks()Méthode
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 );
callbacks.fire( "foo!" );
callbacks.add( fn2 );
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
| 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 );
callbacks.fire( "foo!" );
callbacks.add( fn2 );
callbacks.fire( "bar!" );
callbacks.remove( fn2 );
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" );
})
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" );
})
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 );
callbacks.add( fn2 );
callbacks.fire( "bar" );
callbacks.remove( fn2 );
callbacks.fire( "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" );
})
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 );
callbacks.add( fn2 );
callbacks.fire( "bar" );
callbacks.add( fn2 );
callbacks.fire( "baz" );
callbacks.remove( fn2 );
callbacks.fire( "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 );
})
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;
};
$.Topic( "mailArrived" ).subscribe( fn1 );
$.Topic( "mailArrived" ).subscribe( fn2 );
$.Topic( "mailSent" ).subscribe( fn1 );
$.Topic( "mailArrived" ).publish( "hello world!" );
$.Topic( "mailSent" ).publish( "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;
};
$.Topic( "mailArrived" ).subscribe( fn1 );
var dfd = $.Deferred();
var topic = $.Topic( "mailArrived" );
dfd.done( topic.publish );
dfd.resolve( "Déjà publié !" );
})
Essayez-le vous-même »
Méthodes diverses jQuery
Autres extensions