jQuery.callbacks()

概述

一个多用途的回调列表对象,提供了强大的的方式来管理回调函数列表。

$.Callbacks()的内部提供了jQuery的$.ajax() 和 $.Deferred() 基本功能组件。它可以用来作为类似基础定义的新组件的功能。

$.Callbacks() 支持的方法,包括 callbacks.add(),callbacks.remove()callbacks.fire() and callbacks.disable().

参数

flagsV1.7

一个用空格标记分隔的标志可选列表,用来改变回调列表中的行为

示例

入门描述:

以下是两个样品的方法命名fn1 and fn2:

jQuery 代码:
function fn1( value ){
    console.log( value );
}

function fn2( value ){
    fn1("fn2 says:" + value);
    return false;
}

这些可以添加为回调函数作为一个$.Callbacks的列表,并调用如下:

var callbacks = $.Callbacks();
callbacks.add( fn1 );
callbacks.fire( "foo!" ); // outputs: foo!

callbacks.add( fn2 );
callbacks.fire( "bar!" ); // outputs: bar!, fn2 says: bar!

这样做的结果是,它使构造复杂的回调列表变得简单,输入值可以通过尽可能多的函数根据需要轻松使用。

用于以上的两个具体的方法: .add() 和 .fire() .add() 支持添加新的回调回调列表, 而.fire() 提供了一种用于处理在同一列表中的回调方法的途径.

另一种方法由$.Callbacks 的remove(),用于从回调列表中删除一个特定的回调。下面是.remove() 使用的一个例子:

var callbacks = $.Callbacks();
callbacks.add( fn1 );
callbacks.fire( "foo!" ); // outputs: foo!

callbacks.add( fn2 );
callbacks.fire( "bar!" ); // outputs: bar!, fn2 says: bar!

callbacks.remove(fn2);
callbacks.fire( "foobar" ); 

// only outputs foobar, as fn2 has been removed.

支持的 Flags描述:

这个 flags 参数是$.Callbacks()的一个可选参数, 结构为一个用空格标记分隔的标志可选列表,用来改变回调列表中的行为 (比如. $.Callbacks( 'unique stopOnFalse' )).

 

可用的 flags:

  • once: 确保这个回调列表只执行一次(像一个递延 Deferred).
  • memory: 保持以前的值和将添加到这个列表的后面的最新的值立即执行调用任何回调 (像一个递延 Deferred).
  • unique: 确保一次只能添加一个回调(所以有没有在列表中的重复).
  • stopOnFalse: 当一个回调返回false 时中断调用

默认情况下,回调列表将像事件的回调列表中可以多次触发。

如何在理想情况下应该使用的flags的例子,见下文:

 

$.Callbacks( 'once' ):

var callbacks = $.Callbacks( "once" );
callbacks.add( fn1 );
callbacks.fire( "foo" );
callbacks.add( fn2 );
callbacks.fire( "bar" );
callbacks.remove( fn2 );
callbacks.fire( "foobar" );

/*
output: 
foo
*/

 

$.Callbacks( 'memory' ):

var callbacks = $.Callbacks( "memory" );
callbacks.add( fn1 );
callbacks.fire( "foo" );
callbacks.add( fn2 );
callbacks.fire( "bar" );
callbacks.remove( fn2 );
callbacks.fire( "foobar" );

/*
output:
foo
fn2 says:foo
bar
fn2 says:bar
foobar
*/

 

$.Callbacks( 'unique' ):

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" );

/*
output:
foo
bar
fn2 says:bar
foobar
*//code>

 

$.Callbacks( 'stopOnFalse' ):

function fn1( value ){
    console.log( 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" );

/*
output:
foo
bar
foobar
*/

因为$.Callbacks() 支持一个列表的flags而不仅仅是一个,设置几个flags,有一个累积效应,类似“&&”。这意味着它可能结合创建回调名单,unique 和确保如果名单已经触发,将有更多的回调调用最新的触发值 (i.e.$.Callbacks("unique memory")).

 

$.Callbacks( 'unique memory' ):

function fn1( value ){
    console.log( 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" );

/*
output:
foo
fn2 says:foo
bar
fn2 says:bar
baz
fn2 says:baz
foobar
*/

Flag结合体是使用的$.Callbacks()内部的.done() 和 .fail()一个递延容器-它们都使用 $.Callbacks('memory once').

$.Callbacks 方法也可以被分离, 为方便起见应该有一个需要定义简写版本:

var callbacks = $.Callbacks(),
    add = callbacks.add,
    remove = callbacks.remove,
    fire = callbacks.fire;

add( fn1 );
fire( "hello world");
remove( fn1 );

$.Callbacks, $.Deferred and Pub/Sub

pub / sub( Observer模式)背后的一般思路 是促进应用程序的松散耦合。而比对其他对象的方法调用的单个对象,一个对象,而不是另一个对象的一个特定的任务或活动,并通知当它发生。观察家也被称为订阅者,我们指的出版商(或主体)观察对象。出版商事件发生时通知用户

作为一个组件$.Callbacks()创造能力,它可以实现一个pub / sub系统只使用回调列表。使用$.Callbacks作为主题队列,发布和订阅的主题系统可以实现如下:

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;
};

然后,可以很容易的使用这部分应用程序的发布和订阅感兴趣的事件:

// Subscribers
$.Topic( "mailArrived" ).subscribe( fn1 );
$.Topic( "mailArrived" ).subscribe( fn2 );
$.Topic( "mailSent" ).subscribe( fn1 );

// Publisher
$.Topic( "mailArrived" ).publish( "hello world!" );
$.Topic( "mailSent" ).publish( "woo! mail!" );

// Here, "hello world!" gets pushed to fn1 and fn2
// when the "mailArrived" notification is published
// with "woo! mail!" also being pushed to fn1 when
// the "mailSent" notification is published. 

/*
output:
hello world!
fn2 says: hello world!
woo! mail!
*/

虽然这是有用的,可以采取进一步的实施。使用$.Deferreds,这是可能的,以确保发表者只为用户发布一次特别的任务已经完成(解决)通知。这可能是如何在实践中使用的一些进一步的评论,请参见下面的代码示例:

// subscribe to the mailArrived notification
$.Topic( "mailArrived" ).subscribe( fn1 );

// create a new instance of Deferreds
var dfd = $.Deferred();

// define a new topic (without directly publishing)
var topic = $.Topic( "mailArrived" );

// when the deferred has been resolved, publish a 
// notification to subscribers
dfd.done( topic.publish );

// Here the Deferred is being resolved with a message
// that will be passed back to subscribers. It's possible to
// easily integrate this into a more complex routine
// (eg. waiting on an ajax call to complete) so that
// messages are only published once the task has actually
// finished.
dfd.resolve( "its been published!" );
感谢阅读:jQuery.callbacks(),欢迎收藏【jQuery.callbacks()】,以便下次访问。
12个常用的jQuery代码片段

在《锋利的jQuery》中整理的几个现在还常用的jQuery代码片段。1.禁用页面,禁用页面的右键菜单//禁用右键菜单$(document)...4月23日

jQuery选择器Sizzle原理分析(下)

的jQuery还记得吗?拥有号称当时业界最快的DOM选择器Sizzle,那么为什么他能自称是最快呢?让我们来分析一下Sizzle.js的源码,了解他的设计精妙之处...4月20日

10款强大的jQuery/HTML5应用新鲜出炉

今天我们来分享10款最新的jQuery和HTML5应用插件,都非常强大,一起来看看吧。1...5月11日

锋利的jQuery

本书循序渐进地对jQuery的各种函数和方法调用进行了介绍,读者可以系统地掌握jQuery的DOM操作、事件监听和动画、表单操作、AJAX以及插件方面等知识点...5月8日

前端基础进阶(十一):详细图解jQuery对象,以及如何扩展jQuery插件

大家都非常热衷于研究jQuery源码。我还记得当初从jQuery源码中学到一星半点应用技巧的时候常会有一种发自内心的惊叹,...4月2日

外媒速递:五款jQuery插件轻松实现树状视图

外媒速递是核子可乐精选的近日国外媒体的精彩文章推荐,希望大家喜欢!本期给大家推荐的是五款jQuery插件轻松实现树状视图...4月26日

jQuery动画下拉菜单 自定义菜单内容

这次我们要来分享一款jQuery菜单插件,这是一款jQuery动画下拉菜单,这款菜单的特点是下拉菜单项可以自定义内容,可以是图片和图文结合的内容,非常灵活...5月10日

jQuery与js常用方法对比

一)文档就绪jQuery实现$(document).ready(function(){//开始写jQuery代码...})...4月12日

jquery图片查看插件,支持旋转、放大、缩小、拖拽、缩略图(仿qq图片查看)

最近做了一个jquery图片查看的插件,目的是能精确查看图片的详情,插件支持图片旋转、放大、缩小、拖拽、缩略图显示...3月30日

ThinkPHP中使用jQuery实现多条件组合筛选

使用ThinkPHP编写多条件组合筛选不是特别好实现,最直接的方法就是使用js辅助。本案例使用的是jquery。这里要实现的功能如下:多组筛选分类相互不冲突...4月18日

拥有强大的选择器、出色的DOM操作、可靠的事件处理、完善的兼容性和链式操作等功能。二、加入jQueryjQuery简介由JohnResig创建于2006年1月的开源项目...5月7日

jQuery特效 | 导航底部横线跟随鼠标缓动

:jQuery来实现如下特效-在导航底部存在一条横线,跟随着鼠标缓动到相应导航项底部。2月初,接收到了公众号读者的效果需求,希望能够讲解这样一个实例:横排的导航...2月27日

炫酷实用 7款jQuery/HTML5图片应用

jQuery非常强大,我们这里有很多关于jQuery焦点图的插件,今天我们精选了7款利用jQuery和HTML5实现的超炫酷图片特效应用,有些也是焦点图插件...3月14日

前端每周清单:jQuery 3.2发布,滴滴采用Vue 2.0重构Web App、饿了么 PWA 实...

从属于笔者的Web前端入门与工程实践。更多阅读清单请转向往期索引。前端每周清单:前端每周清单:jQuery3.2发布,滴滴采用Vue2.0重构WebApp...3月20日

小白都会的 jQuery 小技巧(中),再来瞄一眼!

jQuery的小技巧,不管是平民,还是小仙,掌握了这些秘籍,相信你很快就会飞升上仙了,哈哈。检测浏览器注:在版本jQuery1.4中,$.support替换掉了$...3月4日

任何使用jQuery Mobile网站中都存在一个尚未修复的...

ardoVela在jQueryMobile框架中发现了一个安全漏洞,这个漏洞将会让所有使用了jQueryMobile的网站暴露于跨站脚本攻击风险之下。安全客小百科...2月16日

用jQuery Mobile做HTML5移动应用的三个优缺点和缺点

我一直在使用JQueryMobile为一个健身培训网站开发基于HTML5的手机/平板前端应用...2月13日

jQuery 源码系列(十七)css 相关操作

作也是jQuery比较常用的一个操作,就我本人而言,这个css函数用多了,感觉自己有点傻乎乎的,主要还是自己不了解js中css的真正含义。不过现在不怕了。开始之前...3月5日

全部展开 | 全部折叠 | jQuery API手册