Objet
$.Callbacks() ou $.Callbacks( flags ) : un objet polyvalent pour gérer des listes de rappel. Par défaut, une liste de rappel va agir comme une liste de rappel liée à un événement, elle peut-être exécutée à plusieurs reprises. Cet objet est utilisé par $.ajax() et $.Deferred(), il prend en charge plusieurs méthodes.
flags : une liste optionnelle de booléens séparés par des espaces.
- once : les fonctions de rappel ne sont exécutables qu'une seule fois.
- memory : la méthode fired() n'activera que les fonctions de rappel ajoutées après le fired() précédent.
- unique : vérifie qu'il n'y a pas de doublons dans la liste des fonctions de rappel.
- stopOnFalse : interrompt l'exécution lorsqu'une fonction de rappel retourne false.
Méthodes
- callbacks.add( callbacks ) Ajoute une ou plusieurs fonction de rappel à la liste.
- callbacks.remove( callbacks ) Supprime une fonction de rappel ou toutes les fonctions de rappel contenues dans la liste.
- callbacks.empty() Suprime toutes les fonctions de rappel contenues dans la liste.
- callbacks.fire( arguments ) Exécute toutes les fonctions de rappel contenues dans la liste avec les arguments fournis.
- callbacks.fireWith( context, arguments ) Exécute toutes les fonctions de rappel contenues dans la liste avec les arguments et le contexte fournis.
- callbacks.disable() Rend la liste non exécutable.
- callbacks.lock() Bloque la liste dans son état actuel.
- callbacks.has( callback ) Détermine si cette fonction de rappel est dans la liste.
- callbacks.disabled() Détermine si cette liste de rappel a été rendue non exécutable.
- callbacks.fired() Détermine si cette liste de rappel a déjà été exécutée au moins une fois.
- callbacks.locked() Détermine si cette liste de rappel a déjà été bloquée.
Paramètres
- callbacks : une fonction de rappel ou un array contenant des fonctions de rappel.
- callback : une fonction de rappel.
- arguments : un argument ou un array contenant des arguments.
- context : une référence au contexte d'exécution.
On peut ainsi construire des listes de rappels complexes où les valeurs d'entrée peuvent être passés à travers autant de fonctions que nécessaire.
Topic
Avec $.Callbacks(), il est possible de mettre en œuvre un système d'édition et de souscription à un événement en utilisant uniquement des listes de rappel.
Nous parlerons d'objets souscripteurs et d'objet éditeurs.
L'éditeur prévient les souscripteurs lorsque la tâche ou l'activité spécifique auxquels ils ont souscrit se produit.