标签： jQuery

jQuery 1.3自从2009年1月14日发布后，后引来了各界的关注。我们也随即投入到翻译文档的工作中来。经过4天的努力，终于完工了。这个版本更新了不少东西

changelog:

2009-01-21 20:23:38 +0800
* #4 关于1.3版的日期 (感谢liushuang630)
* #5 die()的标题误为toggle() (感谢dadao5.com)
* queue([name],callback) queue([name],queue)少参数 (感谢Horatio)

2009-01-19 00:00:10 +0800
+ offsetParent()
* closest() 说明

2009-01-18 16:06:52 +0800
* triggerHandler 进一步说明
* trigger 进一步说明

2009-01-17 22:37:11 +0800
* live() – 与bind()不同的是，live()一次只能绑定一个事件。
* [attribute!=value] jQuery 1.3中意义改变
* load 的data参数在jQuery 1.3中也可以接受String
+ ajax的error回调的第二个参数可能值”timeout”, “error”, “notmodified” 和 “parsererror”
+ ajax参数xhr
* animate 的duration为0的问题
* show, hide, toggle, slideDown, slideUp, slideToggle 在jQuery 1.3中，padding和margin也会有动画，效果更流畅。
* jQuery(html,[ownerDocument])等效于$(document.createElement(“span”)
* is支持复杂表达式

2009-01-17 18:31:10 +0800
+ jQuery.support.scriptEval
+ 原 Dimension 插件功能（1.2.6版加入jQuery核心）

2009-01-16 19:11:10 +0800
+ jQuery.fx.off
+ toggleClass( class, switch )
+ toggle( switch )
+ toggle(speed,[callback])
* 修改queue和dequeue方法的参数和说明

2009-01-15 22:31:02 +0800
* jQuery(html,[ownerDocument])
+ jQuery.selector
+ jQuery.context
* 效果下的queue和dequeue搬到核心下
+ live()
+ die()
+ closest()
* stop( [clearQueue], [gotoEnd]) 增加两个参数
+ jQuery.support
+ jQuery.isArray( obj )

感谢Cloudream的热情帮忙。还要感谢一揪制作chm版。这个版本还加入了检查更新的功能。如果有需要的同学可轻松查看是否有更新的中文文档(chm版中的检查更新也将同步升级)。目前chm版尚未完工，请稍候。
继续阅读jQuery 1.3 中文文档发布

好久没写博客了，抱歉抱歉，最近半年很忙很忙。
正好群里 Q.Lee.lulu 问起怎样判断有没有绑定一个事件。
我研究了一下之后发现，jQuery都将事件缓存起来了，其实也是为了防止内存溢出以及页面unload的时候的速度，也包括多函数触发，方便管理等诸多好处，具体可以参考此文。
jQuery会在window.unload的时候卸载所有绑定过的事件，释放内存的。

OK，言归正传。判断元素上是否绑定过事件用如下语句

jQuery.data(elem,”events”)[type] //老版本也能用
$(elem).data(“events”)[type] //1.2.3以后才能用

返回值：
一个Object，可以用for in来遍历。或者undefined。
参数：
elem是一个DOM对象，type是事件类型。
举例：
判断id为foo的元素上是否绑定了click事件

if( $(“#foo”).data(“events”)[“click”] ){
//your code
}

论坛里有人问

HTML:
<div id=”b”>
<div>sssssssssssss</div>
<div>aaaaaaaaaaaa</div>
</div>

JQ;
$(‘div:contains(aaa)’).addClass(‘aa’);

如何才能让这个id=”b”的div不要被选择器匹配到呢？

底下讨论了老半天基本都是无解，只能回避这个问题，加入class之类的限定条件。

后来我仔细翻了翻API，发现还有filter这个方法可以用。

之后还不过瘾，写了个选择器插件，需要的同学可以拿去用。

直接上代码了，写的不好，有能力的帮忙优化一下，毕竟选择器函数属于运算密集型函数。
filter方法：

$(‘div:contains(aaa)’).filter(function() {
return $(this).children().length == 0;
});

选择器插件：

/*
Shawphy:用于查找不含子元素的元素（可以包含文本，不同于:empty选择器）
*/
;(function($) {
$.extend($.expr[“:”], {
nochild : function( a ) {
return $(a).children().length == 0; //Shawphy:子元素数量为0的元素会被保留
}
});
})(jQuery);
//Shawphy:测试是否能查到所需要的东西
alert($(‘div:contains(shawphy):nochild’).length)

又开始写jQuery的秘密了~
这里写的基本上都是没啥用的东西，大家随便看看好了，有用的都放在文档里了~

这回先说选择器，
两个特殊的选择器，没有在文档里列出来。有可能只是选择器正则匹配的失误，也可能是故意的，但我源码中看不出来。望各位看官指点。注意，下面两个特殊选择器，随时可能在以后版本中消失，慎用。本文涉及的是1.2.6，经测试1.2.3也可使用。

创建一个空jQuery对象：

$(” “); //切记，引号中间至少有_一个_空格

这段简易的代码即可创建一个空的jQuery对象。这就类似创建一个代码片段。但由于是空的，所以无法append进任何东西。但你可以用add将你要的东西添加进去。

获取document，有时候需要写一些关于document的事件，比如keypress之类的，或者其他的，就可以用

$(“”); //切记，引号中间_没有_空格

这一定程度上可以用于混淆代码，比如将$(document).ready()写成$(“”).ready()，不知道的人就看不懂了。当然，要看过本文的人就都知道了~~（笑~）

顺便一说，前端加密是没有可能的，混淆也是有限度的。有jQuery的操作是链式操作，没有中间变量，同时通常绑定函数也是匿名函数，所以对于jQuery代码的混淆更是没有太大用处。除非，不再使用匿名函数，每次都外部定义一个。同时不再使用链式操作，用next，parent之类操作的时候，统统再定义一个中间变量。这样你的jQuery代码已经没有jQuery风格了，对混淆会稍微有点点帮助。注意，以上所有混淆操作，只防君子不防小人！切记，前端开发不可能加密！所以一切都做好开源的准备！了解GPL、MIT之类的都是有必要的！

如果你要用中间变量,像前面说的为了混淆，有时候你可能需要用到之前的一个对象，就好像在链式写法中用end()的效果，那就可以用prevObject属性，end()就是返回这个属性。

$(“#id”).prevObject; //切记，最后没有括号，这个是属性不是方法

下面说的这个其实不是很秘密，但值得一提
attr是很伟大的方法，以下这些都是可以执行的，你就可以通过这些来进行一些简单的判断，比如这个元素的标签名啦之类的。

$(“body”).attr(“tagName”);
$(“body”).attr(“nodeName”);
$(“body”).attr(“nodeType”);

还有个相关的，他返回的是布尔值true/false

jQuery.nodeName( elem, nodeName )

第一个参数是一个DOM对象，不是jQuery对象，第二个就是节点名称（标签名）了，大小写无关。返回true/false
有人问，为什么我不直接使用elem.nodeName==nodeName呢，爱用写这么麻烦呢？
看一下jQuery的源码就知道了

nodeName: function( elem, name ) {
return elem.nodeName && elem.nodeName.toUpperCase() == name.toUpperCase();
},

明白了么？浏览器兼容性问题，某些浏览器中的nodeName是大写，有些是小写，够恶心吧？
兼容一下总是好的~~

参考资料地址：
http://docs.jquery.com/Ajax_Events
Ajax会触发很多事件。
有两种事件，一种是局部事件，一种是全局事件：

局部事件：通过$.ajax来调用并且分配。

$.ajax({
beforeSend: function(){
// Handle the beforeSend event
},
complete: function(){
// Handle the complete event
}
// …
});

全局事件，可以用bind来绑定，用unbind来取消绑定。这个跟click/mousedown/keyup等事件类似。但他可以传递到每一个DOM元素上。

$(“#loading”).bind(“ajaxSend”, function(){ //使用bind
$(this).show();
}).ajaxComplete(function(){ //直接使用ajaxComplete
$(this).hide();
});

当然，你某一个Ajax请求不希望产生全局的事件，则可以设置global:false

$.ajax({
url: “test.html”,
global: false,
// …
});

事件的顺序如下：
ajaxStart 全局事件
开始新的Ajax请求，并且此时没有其他ajax请求正在进行。
beforeSend 局部事件
当一个Ajax请求开始时触发。如果需要，你可以在这里设置XHR对象。
ajaxSend 全局事件
请求开始前触发的全局事件
success 局部事件
请求成功时触发。即服务器没有返回错误，返回的数据也没有错误。
ajaxSuccess 全局事件
全局的请求成功
error 局部事件
仅当发生错误时触发。你无法同时执行success和error两个回调函数。
ajaxError 全局事件
全局的发生错误时触发
complete 局部事件
不管你请求成功还是失败，即便是同步请求，你都能在请求完成时触发这个事件。
ajaxComplete 全局事件
全局的请求完成时触发
ajaxStop 全局事件
当没有Ajax正在进行中的时候，触发。

局部事件回调的参数在文档中写的很清楚了，这里就不累述了。

全局事件中，除了ajaxStart和ajaxStop之外，其他的事件都有3个参数
event, XMLHttpRequest, ajaxOptions
第一个是事件，第二个是XHR对象，第三个参数最有用，是当时调用这个ajax的时候的参数。
对于ajaxError,还有第四个参数thrownError，只有当异常发生时才会被传递。
我们可以利用ajaxOptions来写一个全局的ajax事件。
比如

$(“#msg”).beforeSend(function(e,xhr,o) {
$(this).html(“正在请求”+o.url);
}).ajaxSuccess(function(e,xhr,o) {
$(this).html(o.url+”请求成功”);
}).ajaxError(function(e,xhr,o) {
$(this).html(o.url+”请求失败”);
});

对于这个例子，
这样我们就可以很方便的全局地在某个地方显示当前的ajax状态。
当然，之前说了，第三个参数实际上是传递给ajax的参数。get/post/load/getScript/getJSON等方法本质上都是调用ajax方法的，所以ajaxOptions.url属性总是有效的。

还有更丰富的例子。
如果你用ajax调用，还可以传递自定义参数。下面的例子我就自定义了一个msg参数给了ajax调用

//自定义参数msg
$.ajax({url:”test1.html”,type:”get”,msg:”页面一”});
$.ajax({url:”test2.html”,type:”get”,msg:”页面二”});
$.ajax({url:”test3.html”,type:”get”,msg:”页面三”});
$.ajax({url:”test4.html”,type:”get”,msg:”页面四”});

//这里就能获取到自定义参数msg。
//这可以用来区别对待不同的ajax请求。
$(“#msg”).beforeSend(function(e,xhr,o) {
$(this).html(“正在请求”+o.msg);
}).ajaxSuccess(function(e,xhr,o) {
$(this).html(o.msg+”请求成功”);
}).ajaxError(function(e,xhr,o) {
$(this).html(o.msg+”请求失败”);
});

最后对于load方法，还有话说。
其他的简易ajax方法，比如get,post,getJSON等，他们的回调函数都是设置了success回调。
而只有load设置的其实是complete回调。
所以，load里设置的回调函数的参数应该有2个。
XMLHttpRequest和textStatus
但实际上也并非如此。
load的回调有三个参数
XMLHttpRequest.responseText, textStatus, XMLHttpRequest
所以，你可以在load的回调里
通过textStatus==”success”或者textStatus==”error”来判断是否调用成功。
或者用XMLHttpRequest.status属性判断是200还是404或者其他的。

这点上，我认为比普通的get/post等方法更先进。如果要单数设置每get的error是不可能的。但是设置一个全局的ajaxError其实也是不错的选择。

jQuery的向来以其完善的文档著称，而不像早期的Prototype那样库写的很牛，而文档很糟糕，其他使用者不得不看他的源码以了解一些功能。
但是，不得不说，文档的更新速度是远没有其程序变化的快的。
这个专题就是用于介绍一些隐藏在jQuery源码内部的事情。

今天先揭秘2条

1，序列化一个对象
类似于Prototype中的$H(obj).toQueryString()
jQuery中也有一个内部函数，用于在ajax时候序列化对象用：
jQuery.param

var obj={A:1,B:2,C:3};
jQuery.param(obj); //A=1&B=2&C=3

2，获取原始的event对象
用过jQuery都知道，jQuery提供了一个事件对象，用于在事件处理函数中使用，并且这个对象已经将ie中的事件修复成了标准的W3C事件。具体可以参考我这篇日志

但他并没有完全统一所有事件，比如获取mousemove的event事件中鼠标的相对坐标的位置，ie和ff分别用的x和layerX来实现，而jQuery没有给统一。我们只能使用原始的event对象再自己判断，此时就可以使用
e.originalEvent
这样就得到了原始的event对象了
在ie中，这个指向的是window.event，而在其他浏览器中，就是传递给事件处理函数的第一个参数。

像上面那个例子，我就用了如下的代码，用于获取鼠标的相对坐标。

$(“#menuWrap”).mousemove(function(e) {
var xx=e.originalEvent.x||e.originalEvent.layerX||0;
});

可以参考我写的一个简单的菜单。
这个页面看上去动作还有点僵硬，是由于动画函数的问题。
关于动画函数，将在以后详细讲解。