jQuery.Callbacks()Метод
Разные методы jQuery
Примеры
Добавить функцию обратного вызова в список $.Callbacks
$(function () {
function fn1( value ) {
alert( value );
}
function fn2( value ) {
fn1("fn2 говорит: " + value);
return false;
}
var callbacks = $.Callbacks();
callbacks.add( fn1 );
callbacks.fire( "foo!" );
callbacks.add( fn2 );
обратные вызовы.запускают( "bar!" );
})
Попробуйте сами »
Определение и использование
$.Callbacks() представляет собой многоцелевой объект списка функций обратного вызова, который предоставляет мощный способ управления очередями функций обратного вызова.
Совет:$.Callbacks используется в jQuery, например, в функциях, которые обеспечивают базовую функциональность для таких компонентов, как .ajax, $.Deferred и т.д. Он также может использоваться в некоторых компонентах с аналогичной функциональностью, самостоятельно разработанных плагинах.
Синтаксис
| Parameters |
Описание |
|
флаги
|
Необязательно. Строковый тип. Необязательный список, разделённый пробелами, для изменения поведения списка обратных вызовов. |

Другие примеры
Ниже приведён пример использования .remove() для удаления конкретного обратного вызова из списка обратных вызовов.
Пример
$(function () {
function fn1( value ) {
alert( value );
}
function fn2( value ) {
fn1("fn2 говорит: " + value);
return false;
}
var callbacks = $.Callbacks();
callbacks.add( fn1 );
callbacks.fire( "foo!" );
callbacks.add( fn2 );
callbacks.fire( "bar!" );
callbacks.remove( fn2 );
callbacks.fire( "foobar" );
})
Попробуйте сами »
Поддерживаемые параметры флагов
Этот параметр flags — необязательный параметр $.Callbacks(). Он представляет собой необязательный список флагов, разделённых пробелами, изменяющий поведение списка обратных вызовов (например, $.Callbacks( 'unique stopOnFalse' )).
Доступны следующие флаги:
| Parameters |
Описание |
|
once
|
Убедитесь, что этот список обратных вызовов выполняется только один раз. |
|
memory
|
Кэшируйте значения параметров от последнего fire. Когда add() добавляет функцию обратного вызова, немедленно вызовите только что добавленную функцию обратного вызова с последними значениями параметров. |
unique
|
Функция обратного вызова может быть добавлена только один раз и не будет добавлена повторно. |
stopOnFalse
|
После того как функция обратного вызова возвращает false, прервать последующие функции обратного вызова. |
Ниже приведён пример $.Callbacks( "once" ).
Пример
$(function () {
function fn1( value ) {
alert( value );
}
function fn2( value ) {
fn1("fn2 говорит: " + 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" );
})
Попробуйте сами »
Ниже приведён пример $.Callbacks( "memory" ).
Пример
$(function () {
function fn1( value ) {
alert( value );
}
function fn2( value ) {
fn1("fn2 говорит: " + 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" );
})
Попробуйте сами »
Ниже приведён пример $.Callbacks( "unique" ).
Пример
$(function () {
function fn1( value ) {
alert( value );
}
function fn2( value ) {
fn1("fn2 говорит: " + 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" );
})
Попробуйте сами »
Ниже приведён пример $.Callbacks( "stopOnFalse" ).
Пример
$(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" );
})
Попробуйте сами »
$.Callbacks() поддерживает установку флагов (идентификаторов) не только одного, и имеет накопительный эффект, аналогичный "&&".
Ниже приведён пример $.Callbacks( 'unique memory' ).
Пример
$(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" );
})
Попробуйте сами »
Метод $.Callbacks также можно разделить, например:
Пример
$(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 );
})
Попробуйте сами »
$.Callbacks, $.Deferred и Pub/Sub
Общая идея pub/sub (шаблон наблюдателя) состоит в том, чтобы способствовать слабой связанности и эффективному взаимодействию в приложениях. Наблюдатели, также называемые подписчиками, указывают на наблюдаемый субъект. Издатель уведомляет подписчиков, когда происходит событие.
В качестве демонстрации компонентов, созданных с помощью $.Callbacks(), можно реализовать систему Pub/Sub, используя только список функций обратного вызова. Используя $.Callbacks в качестве очереди тем, можно публиковать темы и подписываться на них следующим образом:
Пример
$(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!" );
})
Попробуйте сами »
Дальнейшее улучшение с использованием $.Deferreds может гарантировать, что издатель публикует уведомления подписчикам только тогда, когда конкретная задача завершена (или разрешена). См. пример кода ниже:
Пример
$(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( "Уже опубликовано!" );
})
Попробуйте сами »
Разные методы jQuery
Другие расширения