jQuery详细中文注释选编.doc

1 /* 2 * 说明: 3 * 本源代码的中文注释乃Auscar lin呕心沥血所作.旨在促进jQuery的传播以及向广大jQuery爱好者提供一个进阶 4 * 的途径,以让各位更加深入地了解jQuery,学习其中有用的技术,从而为振兴中华J S出一份绵薄之力...(说大了...) 5 * 6 * 本文件保留了jQuery代码原来的英文注释,个别语句我在其旁列出了尝试性的翻 译(并标明这是翻译).水平有限希望读者能斟酌. 7 * 另外,本中文注释不是简单将原文翻译(jQuery作者那少得可怜的注释根本不足以 让我们读通jQuery的源代码). 8 * 而是尽本人最大的努力将程序的意图以及所涉及的中高级的JavaScript程序设计 技术展现给各位读者,故文件注释较为详尽. 9 * 10 * 在注释的书写风格方面,采取了比较随意的方式和语气, 目的在于避免晦涩的说教以及拉近读者与代码之间的距离,同时也是为了 11 * 增强大家在阅读代码的趣味性.另外,本人并不提倡使用中文进行注释, 但是为了扩大读者群体, 不得已为之... 12 * 13 * 见识肤浅,不足之处希望指出. 我也希望有人能理解与支持我的工作.如果你觉得我的注释对你有帮助, 请不要吝惜你的感谢~ 14 * 批评与鼓励还有建议都可以通过以下这个电子邮件地址发送给我: 15 * auscar@126.com 16 * 17 * 或者登录我的个人网站给我留言: 18 * (注:linhuihua是我的中文名拼音) 19 * 20 * 又另外,本人写的仿jQuery js 框架miniQ即将要跟大家见面. 21 * 这个框架比jQuery短小,功能也没有这么强大. 但它的架构完全仿照jQuery.可以说它是jQuery架构的一个DEMO. 22 * 透过它,你可以从整体上把握jQuery的框架以及所用到的程序技巧和设计模式.可 以说它是一个教学用的小框架. 23 * 24 * 希望能有越来越多的人喜欢上jQuery,享受jQuery! 25 * 26 */ 27 /* 28 * 版权声明: 29 * (1) 本文件中的JavaScript代码与英文注释版权归原作者所有 30 * (2) 本文件中的中文注释版权归本人所有. 请自由下载与传播本文件, 但请勿用于商业用途. 31 */ 32 33 /* 34 * jQuery 1.2.6 - New Wave Javascript 35 * 36 * Copyright (c) 2008 John Resig () 37 * Dual licensed under the MIT (MIT-LICENSE.txt) 38 * and GPL (GPL-LICENSE.txt) licenses. 39 * 40 * $Date: 2008-05-24 14:22:17 -0400 (Sat, 24 May 2008) $ 41 * $Rev: 5685 $ -1-42 */ 43 44 45 /* 46 * 整个jQuery代码都定义在一个自运行(定义完成之后马上运行)的匿名函数的内部 : 47 * (function(){ 48 * 49 * //jQuery code runs here 50 * 51 * })(); 52 * 53 * 这样, 这个匿名函数所形成的闭包会保护jQuery的代码, 避免了匿名函数内部的jQuery代码与外部之间发生冲突(如使用了相同的变量名) . 54 * 另外, 函数自运行也保证了jQuery在能在第一时间得到初始化. 55 */ 56 (function(){ 57 /* 58 * 写下面两行代码，是出于这样的考虑： 59 * 在多库共存的环境中，很可能会与别人的库使用相同的关键字，那就先把人家的 jQuery、$(如果真的有人用的话)保存下来， 60 * 然后再换上自己的。需要的时候再把自己的jQuery,$关键字卸掉，恢复人家的代 码对这个两个关键字的使用权.调用jQuery.noConflict便可恢复. 61 * 恢复的详细内容, 请参考jQuery.noConflict的中文注释. 62 */ 63 // Map over jQuery in case o