jQuery.Callbacks()Método

jQuery 杂项方法Métodos varios de jQuery

Ejemplo

Agregar una función de callback a la lista de $.Callbacks

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

Pruébalo »

Definición y uso

$.Callbacks() se refiere a un objeto de lista de funciones de callback multipropósito, que proporciona un potente método para gestionar la cola de funciones de callback.

Consejo:$.Callbacks se usa internamente en jQuery, como función que proporciona funcionalidad básica para componentes como .ajax, $.Deferred, etc. También puede usarse en algunos componentes con funciones similares, como en plugins desarrollados por uno mismo.


Sintaxis

$.Callbacks( flags )

Parámetros Descripción
flags Opcional. Tipo String. Una lista opcional separada por espacios, utilizada para cambiar el comportamiento de la lista de callback.


实例

Más ejemplos

A continuación se muestra un ejemplo de uso de .remove() para eliminar un callback específico de la lista de callback.

Ejemplo

$(function () { function fn1( value ) { alert( value ); } function fn2( value ) { fn1("fn2 says: " + value); return false; } var callbacks = $.Callbacks(); callbacks.add( fn1 ); //Salida: foo! callbacks.fire( "foo!" ); callbacks.add( fn2 ); //Salida: bar!, fn2 says: bar! callbacks.fire( "bar!" ); callbacks.remove( fn2 ); //Solo se emite foobar, fn2 ha sido eliminado. callbacks.fire( "foobar" ); })

Pruébalo »


Parámetros de flags admitidos

El parámetro flags es un parámetro opcional de $.Callbacks(), estructurado como una lista opcional de indicadores separados por espacios, utilizada para cambiar el comportamiento de la lista de callback (por ejemplo, $.Callbacks( 'unique stopOnFalse' )).
A continuación se muestran los flags disponibles:

Parámetros Descripción
once Garantiza que esta lista de callback se ejecute solo una vez.
memory Almacena en caché los valores de los parámetros de la última vez que se llamó a fire(). Cuando add() agrega una función de callback, invoca inmediatamente la función recién añadida usando los valores de los parámetros de la última vez.
unique Un callback solo se agregará una vez y no se añadirá repetidamente. stopOnFalse Si una función de callback devuelve false, interrumpe las funciones de callback posteriores.

A continuación se muestra un ejemplo de $.Callbacks( 'once' ).

Ejemplo

$(function () { function fn1( value ) { alert( value ); } function fn2( value ) { fn1("fn2 says: " + 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" ); /*Solo emite: foo*/ })

Pruébalo »

A continuación se muestra un ejemplo de $.Callbacks( 'memory' ).

Ejemplo

$(function () { function fn1( value ) { alert( value ); } function fn2( value ) { fn1("fn2 says: " + 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" ); /*Salida: foo fn2 says:foo bar fn2 says:bar foobar*/ })

Pruébalo »

A continuación se muestra un ejemplo de $.Callbacks( 'unique' ).

Ejemplo

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

Pruébalo »

A continuación se muestra un ejemplo de $.Callbacks( 'stopOnFalse' ).

Ejemplo

$(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" ); /*Salida: foo bar foobar*/ })

Pruébalo »

$.Callbacks() admite configurar múltiples flags (indicadores) en una lista, y no solo uno. Hay un efecto acumulativo, similar a '&&'.
A continuación se muestra un ejemplo de $.Callbacks( 'unique memory' ).

Ejemplo

$(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 ); // repeat addition callbacks.add( fn2 ); callbacks.fire( "bar" ); callbacks.add( fn2 ); callbacks.fire( "baz" ); callbacks.remove( fn2 ); callbacks.fire( "foobar" ); /*Salida: foo fn2 says:foo bar fn2 says:bar baz fn2 says:baz foobar*/ })

Pruébalo »

El método $.Callbacks también puede separarse, por ejemplo:

Ejemplo

$(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 ); /*Salida: hello world*/ })

Pruébalo »


$.Callbacks, $.Deferred y Pub/Sub

La idea general detrás de pub/sub (patrón de observador) es promover el acoplamiento flexible y la comunicación eficiente en las aplicaciones. Los observadores también se denominan suscriptores, que apuntan al objeto observado. El observador (Publisher) notifica al usuario cuando ocurre el evento.

Como demostración de los componentes de creación de $.Callbacks(), se puede implementar un sistema Pub/Sub utilizando solo la lista de funciones de callback. Usando $.Callbacks como una cola de artículos, se puede lograr la publicación y suscripción de artículos de la siguiente manera:

Ejemplo

$(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; }; //Suscriptor $.Topic( "mailArrived" ).subscribe( fn1 ); $.Topic( "mailArrived" ).subscribe( fn2 ); $.Topic( "mailSent" ).subscribe( fn1 ); //Publicador $.Topic( "mailArrived" ).publish( "hello world!" ); $.Topic( "mailSent" ).publish( "woo! mail!" ); /*Salida: hello world! fn2 says: hello world! woo! mail!*/ })

Pruébalo »

Una mejora adicional con el uso de $.Deferreds puede garantizar que cuando una tarea específica se complete (o se resuelva), el publicador solo pueda publicar notificaciones a los suscriptores. Consulte el siguiente código de ejemplo:

Ejemplo

$(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; }; //Suscribirse a la notificación mailArrived $.Topic( "mailArrived" ).subscribe( fn1 ); //Crear un nuevo objeto en lugar del diferido $.Deferreds var dfd = $.Deferred(); //Definir un nuevo artículo (sin publicarlo directamente) var topic = $.Topic( "mailArrived" ); //Cuando el diferido se resuelve, publicar una notificación a los suscriptores. dfd.done( topic.publish ); /*Aquí, el mensaje que se devolverá a los suscriptores se retrasa hasta que el diferido se resuelva. Esto integra programas complejos tanto como sea posible (por ejemplo, esperar a que se complete una llamada Ajax), por lo que, de hecho, el mensaje solo se publica una vez.*/ //Completado. dfd.resolve( "¡Ya se ha publicado!" ); })

Pruébalo »


jQuery 杂项方法Métodos varios de jQuery

Otras extensiones