月度归档： 2008 年 1 月

终于好不容易翻译到了50%了，发此文纪念一下。大家可以从 http://shawphy.com/jqueryapi/ 来查看
中间肯定有不少BUG，可以在这里给我反馈。

翻译期间发现原来的1.1版中确实也有些小错误的。
比如关于end()的翻译中，提到，如果前面的操作（对元素列表的状态）没有破坏性，则什么也不改变。
实际上，如果前面的操作（对元素列表的状态）没有破坏性，那就返回空集

当然，在新版中，关于end()的用法讲的更加明确了

[quote]回到最近的一个"破坏性"操作之前。即，将匹配的元素列表变为前一次的状态。
如果之前没有破坏性操作，则返回一个空集。所谓的"破坏性"就是指任何改变所匹配的jQuery元素的操作。这包括在 Traversing 中任何返回一个jQuery对象的函数–'add', 'andSelf', 'children', 'filter', 'find', 'map', 'next', 'nextAll', 'not', 'parent', 'parents', 'prev', 'prevAll', 'siblings' and 'slice'–再加上 Manipulation 中的 'clone'。[/quote]

注意，所有的wrap函数都不会改变原来选择的对象。

翻译真幸苦，接下来几天我将停止更新，大概到下个星期再开始更新这里。

BTW，我之所以说我翻译了50%，因为总共有6000多行，我翻译了3000行了。
目前进度是Traversing之前的所有以及Traversing中Filtering和Chaining翻译掉了。

• Core 95%
• Selectors 100%
• Attributes 100%
• Traversing 50%
• Manipulation 0%
• CSS 0%
• Events 0%
• Effetcs 0%
• Ajax 0%
• Utilities 0%

中文的资料不多
基本上就是几个

第一步：入门
首选的就是
jQuery的起点教程
上面那个是基础，看了上面就会有对jQuery有个大概的了解，本人就是从那个开始学起的之后就是看API了。
注意，那个是1.1的，实际中使用1.2的版本时会有差异。参看：http://shawphy.com/article.asp?id=7
以及，jQuery的精髓，选择器（重点看）：http://shawphy.com/article.asp?id=8

第二步：提升
现在有的是中文版的1.1的API，可以在这里看
http://jquery.org.cn/visual/cn/index.xml
1.2仿visual的API可以看
http://shawphy.com/jqueryapi/
但这个是英文版的，中文版翻译中。
如果英文比较好，期间建议你去他们官网http://jQuery.com/去看看。会有帮助的，以及一本书Learning jQuery的英文版 http://shawphy.com/down/learningjquery.rar 可以拿来看看。据说这本书的中文版将在08年3、4月份出版，可以关注一下。

第三步，交流
不可否认，交流是很重要的。建议去国内唯一还算有点人气的jQuery社区
http://bbs.jquery.org.cn/
遇到问题那里会有些人帮你解答，我也在那里混的~~
顺便一提，http://cssrain.cn/ 收集了论坛中的很多问题。可以去那里看看精华部分。
更多资料以后再补充。

之前从某个网站（现在想不起来名字了，得翻墙出去，如果有条件可以在里边找到链接，可能叫做kiss，感谢一下），找到了这个版本，仿visual jquery的。非常不错，就决定基于这个版本将其jQuery 1.2 的API翻译一下。
翻译真是件苦差事……
只好慢慢来了，手头还有项目呢……
现在先翻译了大概15%，已经将Core的全部和Selector的大部分翻译完成了，当然还是要校对的。
在此再感谢一下www.chinasvn.com提供了免费的svn服务器。可以帮我控制版本。如果有希望一起合作的朋友，也一起来加入翻译。当然要是会用svn就更好了~

地址：http://shawphy.com/jqueryapi/
由于尚未完成，暂时不提供本地下载的打包文件，如果需要离线文档，可以先下载英文版的：
http://shawphy.com/jqueryapi/jQuery_doc_1.2.zip

以下的文档根据官网1.2选择器汉化，并做相应的调整及加入了部份示例。
由于实际使用中选择器在IE和非IE下会有不同的效果，请参照红色的字样。如有错误请及时联系我。
绯雨汉化：http://feiyu.asgard.cn

基本选择器

#myid	返回: <jQuery对象>
匹配一个id为myid的元素。
element	返回: <jQuery对象> 数组
匹配所有的element元素
.myclass	返回: <jQuery对象> 数组
匹配所有class为myclass的元素
*	返回: <jQuery对象> 数组
匹配所有元素。该选择器会选择文档中所有的元素，包括html，head，body
selector1,selector2,selectorN	返回: <jQuery对象> 数组
匹配所有满足selector1或selector2或selectorN的元素

层次选择

elementParent elementChild	返回: <jQuery对象> 数组
匹配elementParent下的所有子元素elementChild。例如：$("div p") 选择所有div下的p元素
elementParent > elementChild	返回: <jQuery对象> 数组
匹配elementParent下的子元素elementChild。例如：$("div>p") 选择所有上级元素为div的p元素
prev+next	返回: <jQuery对象> 数组
匹配prev同级之后紧邻的元素next。例如：$("h1+div") 选择所有div同级之前为h1的元素（<h1 /><div />）
prev ~ siblings	返回: <jQuery对象> 数组
匹配prev同级之后的元素siblings。例如：$("h1~div") 可以匹配（<h1 /><div /><div />）

基本滤镜

:first	返回: <jQuery对象>
匹配第一个元素
:last	返回: <jQuery对象>
匹配最后一个元素
:not(selector)	返回: <jQuery对象> 数组
匹配不满足selector的元素
:has(selector)	返回: <jQuery对象> 数组
匹配包含满足selector的元素。此选择器为1.2新增
:even	返回: <jQuery对象> 数组
从匹配的元素集中取序数为偶数的元素。
:odd	返回: <jQuery对象> 数组
从匹配的元素集中取序数为奇数的元素。
:eq(index)	返回: <jQuery对象> 数组
从匹配的元素集中取第index个元素
:gt(index)	返回: <jQuery对象> 数组
从匹配的元素中取序数大于index的元素
:lt(index)	返回: <jQuery对象> 数组
从匹配的元素中取序数小于index的元素
:header	返回: <jQuery对象> 数组
匹配所有的标题元素，例如h1，h2，h3……hN。此选择器为1.2新增
:animated	返回: <jQuery对象> 数组
匹配正在执行动画的元素。此选择器为1.2新增
:empty	返回: <jQuery对象> 数组
匹配所有没有子元素（包括文本内容）的元素
:parent	返回: <jQuery对象> 数组
匹配包含子元素（包含文本内容）的所有元素
:contains(text)	返回: <jQuery对象> 数组
匹配所有含有text的元素
:hidden	返回: <jQuery对象> 数组
匹配所有隐藏的元素，包含属性type值为hidden的元素
:visible	返回: <jQuery对象> 数组
匹配所有非隐藏的元素

子元素滤镜

E:nth-child(index/even/odd/equation)	返回: <jQuery对象> 数组
匹配所有E在其父元素下满足（index/even/odd/equation）条件的集合。注：下标从1开始
E:first-child	返回: <jQuery对象> 数组
匹配所有E在其父元素下是第一个子元素的集合。例如：HTML（<div><p id="p1"></p></div><div><p id="p2"></p><p id="p3"></p></div>"），使用$("p:first-child")，选取：<p id="p1"></p><p id="p2"></p>
E:last-child	返回: <jQuery对象> 数组
匹配所有E在其父元素下是最后一个子元素的集合。例如：同上的HTML，使用$("p:last-child")，选取：<p id="p1"></p><p id="p3"></p>
E:only-child	返回: <jQuery对象> 数组
匹配所有E是其父元素的唯一子元素的集合。例如：同上的HTML，使用$("p:only-child")，选取：<p id="p1"></p>

表单滤镜

:input	返回: <jQuery对象> 数组
匹配所有的input、textarea、select、button
:text	返回: <jQuery对象> 数组
匹配文本域。注：在IE浏览器下，选择的对象是所有type属性为text的元素，在非IE浏览器下，选择的对象是input元素type属性为text的元素
:password	返回: <jQuery对象> 数组
匹配密码域。注：在IE浏览器下，选择的对象是所有type属性为password的元素，在非IE浏览器下，选择的对象是input元素type属性为password的元素
:radio	返回: <jQuery对象> 数组
匹配单选按钮。注：在IE浏览器下，选择的对象是所有type属性为radio的元素，在非IE浏览器下，选择的对象是input元素type属性为radio的元素
:checkbox	返回: <jQuery对象> 数组
匹配复选框。注：在IE浏览器下，选择的对象是所有type属性为checkbox的元素，在非IE浏览器下，选择的对象是input元素type属性为checkbox的元素
:submit	返回: <jQuery对象> 数组
匹配提交按钮。注：在IE浏览器下，选择的对象是所有type属性为submit的元素，在非IE浏览器下，选择的对象是input元素type属性为submit的元素和button元素type属性为空或为submit的元素
:image	返回: <jQuery对象> 数组
匹配图像域。注：在IE浏览器下，选择的对象是所有type属性为image的元素，在非IE浏览器下，选择的对象是input元素type属性为image的元素
:reset	返回: <jQuery对象> 数组
匹配重置按钮。注：在IE浏览器下，选择的对象是所有type属性为reset的元素，在非IE浏览器下，选择的对象是input或button元素type属性为reset的元素
:button	返回: <jQuery对象> 数组
匹配按钮。注：在IE浏览器下，选择的对象是所有type属性为button的元素和元素名为button的元素，在非IE浏览器下，选择的对象是input元素type属性为button的元素和元素名为button的元素
:file	返回: <jQuery对象> 数组
匹配文件域。注：在IE浏览器下，选择的对象是所有type属性为file的元素，在非IE浏览器下，选择的对象是input元素type属性为file的元素
:enabled	返回: <jQuery对象> 数组
匹配所有可用的元素。注：即:not(:disabled)，参考:disabled的注释
:disabled	返回: <jQuery对象> 数组
匹配所有禁用的元素。注：在非IE浏览器下，选择的对象是禁用的表单元素
:checked	返回: <jQuery对象> 数组
匹配所有被选中的表单。注：在IE浏览器下，选择的对象是含有checked属性的所有元素
:selected	返回: <jQuery对象> 数组
匹配所有选择的表单。注：在IE浏览器下，选择的对象是含有selected属性的所有元素

属性滤镜

[attribute]	返回: <jQuery对象> 数组
匹配拥有attribute属性的元素
[attribute=value]	返回: <jQuery对象> 数组
匹配属性attribute为value的元素
[attribute!=value]	返回: <jQuery对象> 数组
匹配属性attribute不为value的元素
[attribute^=value]	返回: <jQuery对象> 数组
匹配属性attribute的值以value开始的元素
[attribute$=value]	返回: <jQuery对象> 数组
匹配属性attribute的值以value结尾的元素
[attribute*=value]	返回: <jQuery对象> 数组
匹配属性attribute的值包含value的元素
[selector1][selector2][selectorN]	返回: <jQuery对象> 数组
匹配满足属性选择器selector1、selector2、selectorN的元素

绯雨的天空

看到绯雨的网站，非常好，介绍了不少jQuery的内容。此处转载一下1.1升级至1.2的差异性。

网上大部份的资料都是以jQuery 1.12为基础讲的。1.12至1.21更新了不少东西，如果不看官方的更新文档或者官方最新的API可能对开发造成影响。

1、选择器不支持XPath

XPath自1.2开始不再被jQuery默认支持。您可以通过插件形式来继续使用XPath，但是强烈建议您使用官方的选择器来替代XPath。

[code]$("div//p") //XPath写法
$("div p") //标准写法

$("div/p") //XPath写法
$("div>p") //标准写法

$("p/../div") //XPath写法
$("p").parent("div") //标准写法

$("div[p]") //XPath写法
$("div:has(p)") //标准写法

$("a[@href]") //XPath写法
$("a[href]") //标准写法[/code]

2、使用slice替代eq，lt，gt

eq及lt，gt方法非常好用，但官方从1.1.4开始放入了slice方法来替代它们，中间有一版本完全取消了eq（好像是1.2），然后又因为抗议太多，又把eq加回来了（群众的力量是强大的），但是难保eq在以后的版本还会继续存在。建议换成slice

[code]$("p").eq(0) //使用eq方法
$("p").slice(0,1) //使用slice方法

$("p").lt(2) //使用lt方法
$("p").slice(0,2) //使用slice方法

$("p").gt(2) //使用lt方法
$("p").slice(3) //使用slice方法[/quote]

3、contains方法官方不再赞成使用（有被取消掉的可能）

$("p").contains('text') //使用contains方法
$("p").filter(":contains(text)") //使用filter方法+选择器

4、loadIfModified，getIfModified，ajaxTimeout方法被取消

这3个方法应该算是冷门方法了，用的人应该是很少很少，替代方法如下。

[code]$("#elem").loadIfModified("some.asp") //使用loadIfModified方法
$.ajax({ //使用ajax方法（JSON参数里加入了ifModified）
url: "some.asp",
ifModified: true,
success: function(html) {
$("#elem").html(html)
}

});

$("#elem").getIfModified("some.asp") //使用getIfModified方法
$.ajax({ //使用ajax方法（JSON参数里加入了ifModified）
url: "some.asp",
ifModified: true

});

$.ajaxTimeout(3000) //使用ajaxTimeout方法
$.ajaxSetup({timeout: 3000}) //使用ajaxSetup方法[/code]

此外，版本更新里对动画效果也做了修改，具体看官方API的animate部份。此文档以1.1.4和1.2的更新说明为基础写的，可以上官网查看对应的原版更新文档。
1.2的选择器：http://shawphy.com/article.asp?id=8

被cssrain翻了N多的关于AJAX加载XML的帖子尸体。。。。
总结一下：

1,Content-Type
很多时候无法解析就是Content-Type的问题。
如果本身就是xml文件，请跳过这一步
动态生成的XML一定要将其设置为text/xml，否则默认就是text/html也就是普通的文本了。
常见语言的Content-Type设置

header(“Content-Type:text/xml”);    //php
response.ContentType=”text/xml”   //asp
response.setHeader(“ContentType”,”text/xml”);  //jsp

2，xml结构。
XML一定要封闭的，很重要！
例：
错误的XML


zhangsan
1
lisi
2

正确的




zhangsan
1


lisi
2

3,解析
这里引用macnie的
遍历student（这里还是用上面那个XML，子节点是student)

$.ajax({
    url:’ajax.asp’,
    type: ‘GET’,
    dataType: ‘xml’,//这里可以不写，但千万别写text或者html!!!
    timeout: 1000,
    error: function(xml){
        alert(‘Error loading XML document’+xml);
    },
    success: function(xml){
        $(xml).find(“student”).each(function(i){
            var id=$(this).children(“id”); //取对象
            var id_value=$(this).children(“id”).text(); //取文本
            alert(id_value);//这里就是ID的值了。
            alert($(this).attr(“email”)); //这里能显示student下的email属性。

            //最后么输出了，这个是cssrain的写法，貌似比macnie更JQ一点
            $(‘

‘)
                .html(id_value)
                .appendTo(‘ol’);
        });
    }
});
最后补充一条：保证服务器端是utf-8的编码，否则会乱码！

好啦，完工了，其实也不复杂，对吧？

jQuery发布

[b]
jquery 1.2.2 完整版：[本站下载] 93.1 KB (推荐供测试、开发、学习用)
jquery 1.2.2 Packed压缩版：[本站下载] 28.6 KB (推荐没有开通GZip的网站使用)
jquery 1.2.2 去注释空格版：[本站下载] 51.4 KB (GZizp压缩后15kb。推荐开通GZip的网站使用)
[/b]
2008-1-14日，这个版本是针对jQuery 1.2的BUG修复，你可以在Bug Tracker查看详细列表

重大改变
$(DOMElement)提升300%速度（此处鼓吹的不高兴翻译了……大家自己看表，并结合实践再判断吧

Browser1.2.1 (ms)1.2.2 (ms)
Firefox 2 0.041 0.015
Firefox 3 0.033 0.01
Safari 3 0.017 0.005
Opera 9 0.023 0.004
IE 6 0.04 0.03

.ready()改变

• IE中改变较多，我们不再必须写一个document.write()，感谢Diego Perini的灵感。
• 所有浏览器都是等CSS就绪后执行脚本了而不只是DOM，因为用户希望在CSS加载后判断某个元素是否可见以及高度等信息。这次在Safari和Opera中实现了。
• $(document).bind("ready", fn);你可以用bind来监控ready了。当然以往的.ready()依旧。

.bind("mouseenter") / .bind("mouseleave")
将.hover()的内核拆出两个新事件，这跟mouseover 不同 mouseout ，因为那些事件会在你进出子元素的时候也会触发，这往往不必如此。在1.2.2中，下面两段都有效：[code]$("li").hover(function(){
$(this).addClass("hover");
}, function(){
$(this).removeClass("hover");
});[/code][code]$("li").bind("mouseenter", function(){
$(this).addClass("hover");
}).bind("mouseleave", function(){
$(this).removeClass("hover");
});[/code]

.bind("mousewheel")
Brandon Aaron写的新插件，基于我们的新内核API，可以这样使用：[code]$("div").bind("mousewheel", function(event, delta){
if ( delta < 0 ) $(this).append("up"); else $(this).append("down"); });[/code] 更复杂的:not()
虽然这个不是CSS 3的标准，但是由于大家都需要，所以我们也就加上了。
现在下面的写法都是可以用了

$(".hover:not(li.active)")

$("li:not(.active,.hover,:contains(test))")

Accept Headers
现在我们会在普通的AJAX中发送给服务器一个附加的 accept headers
如果你指定了dataType，我们就会放你发送了。具体如下

• xml "application/xml, text/xml"
• html "text/html"
• script "text/javascript, application/javascript"
• json "application/json, text/javascript"
• text "text/plain"
• Everything else: "*/*"

Bug Fixes

• .clone() overhaul
• Script evaluation overhaul
• height() / width() overhaul
• Cross-frame DOM manipulation
• A few memory leaks have been resolved

Event API
这个是新的API，功能非常强大，通过上面那个新增事件的代码来学习这个强大的API。

附原文地址
http://docs.jquery.com/Release:jQuery_1.2.2