0%

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

jQuery 1.8.3 中文在线文档地址 (翻译完成度 100%)(之前已经访问过的用户,请重新刷新页面或清理一下缓存):
【主站】
http://yhz61010.github.com/jquery/
【被墙时请访问】
http://jquerydoc.sinaapp.com/
或访问我的个人网站:
http://www.leovp.com
http://yhz61010.sinaapp.com
<(Deprecated)http://leovp.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. 修复大量缺陷。
    说明:
  7. 移除不建议使用的 API(如 $.browser 等),这些 API 被移到了 jQuery 移除插件中。详细说明请参见 http://jquery.com/upgrade-guide/1.9/
  8. jQuery 1.9 依然兼容 IE 6,7,8。与 jQuery 1.8 相比,该版本的API更简洁、更轻量、更现代。
  9. jQuery 2.0 将不再支持老版本 IE (IE6,7,8),这样可以使 jQuery 2.0 比 jQuery 1.9 运行的更快,而且文件也更小。
  10. 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 个方法。

坚持原创及高品质技术分享,您的支持将鼓励我继续创作!