jQuery.Callbacks()Método
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 );
callbacks.fire( "foo!" );
callbacks.add( fn2 );
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
| 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 );
callbacks.fire( "foo!" );
callbacks.add( fn2 );
callbacks.fire( "bar!" );
callbacks.remove( fn2 );
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" );
})
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" );
})
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 );
callbacks.add( fn2 );
callbacks.fire( "bar" );
callbacks.remove( fn2 );
callbacks.fire( "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" );
})
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 );
callbacks.add( fn2 );
callbacks.fire( "bar" );
callbacks.add( fn2 );
callbacks.fire( "baz" );
callbacks.remove( fn2 );
callbacks.fire( "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 );
})
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;
};
$.Topic( "mailArrived" ).subscribe( fn1 );
$.Topic( "mailArrived" ).subscribe( fn2 );
$.Topic( "mailSent" ).subscribe( fn1 );
$.Topic( "mailArrived" ).publish( "hello world!" );
$.Topic( "mailSent" ).publish( "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;
};
$.Topic( "mailArrived" ).subscribe( fn1 );
var dfd = $.Deferred();
var topic = $.Topic( "mailArrived" );
dfd.done( topic.publish );
dfd.resolve( "¡Ya se ha publicado!" );
})
Pruébalo »
Métodos varios de jQuery
Otras extensiones