[原创] jQuery 最新版中文文档

jQuery 1.8.3 中文在线文档地址 （翻译完成度 100%）（之前已经访问过的用户，请重新刷新页面或清理一下缓存）：
【主站】
http://yhz61010.github.com/jquery/

【被墙时请访问】
http://jquerydoc.sinaapp.com/

或访问我的个人网站：
http://www.ho1ho.com
http://yhz61010.sinaapp.com
(Deprecated)http://ho1ho.com/jquery

jQuery 是目前使用比较多的 Javascript 框架。一直想把它翻译成中文的，最近利用闲暇时间，在 “为之漫笔 jQuery 1.4.x 中文文档” 的基础上，修改了一些脚本，使之与最新官方英文文档的 XML 格式保持一致，并做了进一步翻译。

再次感谢 “为之漫笔” 为 jQuery 中文文档作出的贡献。

重要通知
　　2013-03-21（星期四），经最后调试，今天终于把生成文档的迁移工具都写完并测试通过了，由于从 1.9 开始，官方文档的 XML 格式被全部重写了，所以不能使用 1.8.3 之前的程序来生成 1.9 之后的文档了。
　　经过了好长时间的对应，今天终于完成了新版文档 XML 格式的对应。不过 1.9 开始新添加的 API 还没有翻译，而且新版还修改了不少已有的 API 文档，所以最新中文版文档的上线还需要一段时间。由于文档迁移工具已经测试通过了，剩下的工作基本就是体力活了：翻译 + 修改，相信过不了多久大家就可以使用上最新版的 jQuery 中文文档了！（此处应该有长时间的掌声~~~~~~）
-------------------------------------------------------------------------------------------------------------------------------------
啊！~~~~~开什么玩笑，好不容易找到了 http://api.jquery.com/api 的新地址： http://api.jquery.com/resources/api.xml，结果下载下来一看，我了个去，这变化也太大了吧。就说 jQuery 最近在全面整理网站(renovating)，也不至于变化这么大吧。所以最新版中文文档在很长一段时间内将还是 1.8.3 版本，等我应用上最新的 API XML 后再发布 1.9.0 吧(也可能是 2.0，嘿嘿！)。哎，谁让它们变化的这么大，几乎得重写之前的程序才能适应新的变化。所以在这段时间内，还是请大家耐心等待吧！
-------------------------------------------------------------------------------------------------------------------------------------
今天早上（2013-01-24）发现 github 终于能正常访问了！！！大家终于可以访问原地址了！以防万一，新的地址以后将继续为大家提供服务。
-------------------------------------------------------------------------------------------------------------------------------------
原地址：http://yhz61010.github.com/jquery/
由于最近 github 被墙（希望过了春运能好些。不会永远被和谐了吧？？？）所以，原托管在 github 上的服务无法再访问，现已迁移到
新地址：
http://jquerydoc.sinaapp.com/。访问时建议大家重新刷新页面或清理浏览器缓存。
-------------------------------------------------------------------------------------------------------------------------------------
由于最近官方 jQuery 文档网站正在重新进行设计，因此官方关闭了对 http://api.jquery.com/api 的访问（希望是暂时性禁止访问），导致作者无法根据最新版文档进行翻译，所以目前中文文档的最新版本还是 1.8.3。待官方允许访问先前的地址后，作者会尽快根据进行翻译。望广大读者谅解。
-------------------------------------------------------------------
2013-01-16 天气：晴
　　今天 jQuery 1.9.0 发布了，主要是修正如下：
　　1. 更加合理化的 API。移除了许多不建议及功能有问题的 API。详细说明请参见 http://jquery.com/upgrade-guide/1.9/
　　2. 新的 css() 方法，支持同时取得多个属性。
　　3. 增强跨浏览器的 CSS3 的支持。
　　4. 新增 .finish() 方法。
　　5. 支持代码地图。
　　6. 修复大量缺陷。

　　说明：
　　1. 移除不建议使用的 API（如 $.browser 等），这些 API 被移到了 jQuery 移除插件中。详细说明请参见 http://jquery.com/upgrade-guide/1.9/
　　2. jQuery 1.9 依然兼容 IE 6，7，8。与 jQuery 1.8 相比，该版本的API更简洁、更轻量、更现代。
　　3. jQuery 2.0 将不再支持老版本 IE (IE6，7，8)，这样可以使 jQuery 2.0 比 jQuery 1.9 运行的更快，而且文件也更小。
　　4. jQuery 团队今后会同时维护 jQuery 1.9 和 2.0。用户可以根据需要自行选择需要的版本。

　　jQuery 迁移插件可以用于 1.9 或 2.0 版本，用于检测不建议使用的 API和被移除功能的 API。还可以将旧的功能引入新版本的 jQuery 中（当然这样做也会带来原 API 中那些棘手的问题）。

　　官方完整的 Release 说明地址如下：
　　http://blog.jquery.com/2013/01/15/jquery-1-9-final-jquery-2-0-beta-migrate-final-released/

-------------------------------------------------------------------
2012-09-24 天气：晴
　　2012-09-21 jQuery 1.8.2 发布了，主要是修正一些 bug，及修正已经发现的某些 API 性能下降的问题。此外，该版本中并没有添加任何新 API。

　　官方完整的 Release 说明地址如下：
　　http://blog.jquery.com/2012/09/20/jquery-1-8-2-released/

-------------------------------------------------------------------
2012-08-31 天气：晴
　　“啊，有这种事！”。刚刚(17:00左右)打开 ITeye 一看， jQuery 居然更新到了 1.8.1，早上看的时候还是 1.8.0 呢，这回更新的速度也太神速了！我中午才刚刚发布消息说已经全部翻译完 1.8.0 的文档。赶紧下载了最新文档，和 1.8.0 比较了一下，这才安心了，变更的只是程序，文档没有任何变化。激动中......

　　1.8.1 主要是修正上一版本中的几十个 Bug。着重提醒开发者，不要使用 Quirks 模式。Sizzle 中自定义的伪选择器参数已经改变，jQuery 1.8.1 也针对旧的代码提供了一个兼容的 shim。

　　官方完整的 Release 说明地址如下：
　　http://blog.jquery.com/2012/08/30/jquery-1-8-1-released/

-------------------------------------------------------------------
2012-08-31 天气：晴
　　经过了近 10 个月的翻译，总计翻译了 80,000 多字，本人凭一已之力今天终于将 jQuery 最新版 1.8.0 全部翻译完了！（持久不断的掌声！！！）。真可谓是历经艰辛啊，本人利用业余时间，历时 10 个月终于完全了本人做过的字数最多的翻译，到现在我自己还不敢相信这一切我自己居然做到了！希望对大家的工作和学习能起到一定的帮助作用。

　　同时，也希望大家尊重别人的辛勤劳动，转载请注明本文出处。

　　截止目前，本人还发现了一些 Bug，目前正在修改中。由于本人翻译水平有限，毕竟不是专业翻译，有很多地方可能翻译的不当（有的时候我也觉得读起来不是那么的地道，悔恨自己的语文功底不行啊。真希望我以前是课代表啊！！！），所以还请大家多多谅解。也欢迎大家提出您的宝贵意见，反馈您的想法及发现的 Bug。谢谢！

-------------------------------------------------------------------
2012-08-13 天气：晴

　　我是天天等夜夜盼，期待第一时间得知 1.8.0 的到来，因为我几乎每天打开的第一个页面就是 jQuery 的官方网站，结果它就是不更新。嘿，非等我去韩国旅游的这几天它更新到了 1.8.0（更新时间 08-09）！哎，我这热情似火的心啊，多多少少感受到了那么一点点儿的遗憾。不过 1.8.0 还是在万众瞩目之下闪亮登场了，还是让我万分兴奋的！

　　现已将中文文档更新到 1.8.0。欢迎大家访问上面的地址。

　　完整的变更说明请参见官方博客：http://blog.jquery.com/2012/08/09/jquery-1-8-released/ 或搜索相关的中文信息，在此我就不再赘述了。

　　本次版本升级，没有添加任何新方法，主要是修正了 160 多处 Bug，并移除了一些 API。我在这里主要列出一些被移除的 API，方便大家了解最新的变化及带来的影响。
　　1. $(element).data(“events”)
　　2. Deferred.isResolved()
　　3. Deferred.isRejected()
　　4. 返回 Array 的 $(element).closest(Array)
　　5. $.curCSS 说明：该方法曾是 jQuery.css() 的别名。
　　6. $.attrFn 注意：为了防止使用该方法出现异常，所以在 jQuery 1.8 中它仅是一个空方法。在 jQuery 1.9 中，该方法会被彻底移除。

　　PS:从 1.7.2 更新到 1.8.0 用了五个月左右的时间！更新速度虽然不是那么的快，主要是官方对该版本改动较大导致的。所以该版本应该是很重要的一个版本。不管怎么说，我对此是十分期待的！

-------------------------------------------------------------------
2012-03-23 天气：小雨

　　今天发现 jQuery 终于正式更新到 1.7.2 了。还好这几天不太忙，于是花了好长时间将变化的内容反映到中文文档中。累死我了！

　　新版没添加新方法，只是改了相当多的 bug，并 deprecated 了几个方法。

　　PS:从 1.7.1 更新到 1.7.2 好像用了四个多月，真是用了相当长的时间啊。还记得从 1.6.x 到 1.7.1 更新速度那是涮涮的。
-------------------------------------------------------------------

声明：
    1. 此次文档的翻译，尊重英文原意。
    2. 由于 “为之漫笔” 的翻译相当的专业，而且尊重英文原意。由于本人水平有限（毕竟咱爷们不是搞翻译的，有些地方看明白了，但写成中文还真不太好说，嘿嘿！还望大家多多理解啊！）可能没有原作者翻译的好，有翻译不当或出错的地方，还请大家多多指正。

注：
    由于是利用闲暇时间做的翻译，时间有限，因此本人每周仅更新一次文档，每次更新 5 - 10 个方法。

评论

1 楼 41082468 2013-01-12  

能否提供 离线版 thx  [e-mail]