jquery中文基础入门.docx

1、jquery中文基础入门jQuery中文入门指南，翻译加实例，jQuery的起点教程中文版译者：Keel此文以实例为基础一步步说明了jQuery的工作方式。现以中文翻译（添加我的补充说明）如下。如有相关意见或建议请EMAIL告知。或者在BLOG中留言。英文原版：，感谢原文作者Jrn Zaefferer本文发布已征求原作者同意。说明:在本教程发布之后，得到了几个网友的指正，对部分内容作了修正，但在jQuery版本不断更新的情况下，教程中的某些内容已经过时（尤其是1.3以上版本），在忠于原文的基础上，我将这部分内容加以标红的补充说明，希望更多的前端开发者能对此文提出宝贵意见，谢谢！ -2009-3

2、-10另外我认为在学习过程中,有两个API文档你要打开随时查看: 注：已更新为jquery新地址 如果想了解更多jQuery及插件信息，可访问本站首页.以下部分为原文翻译:jQuery入门指南教程这个指南是一个对jQuery库的说明，要求读者了解HTML(DOM)和CSS的一些常识。它包括了一个简单的Hello World的例子，选择器和事件基础，AJAX、FX的用法，以及如何制作jQuery的插件。 这个指南包括了很多代码，你可以copy它们，并试着修改它们，看看产生的效果。内容提要1. 安装2. Hello jQuery3. Find me:使用选择器和事件4. Rate me:使用AJA

3、X5. Animate me(让我生动起来):使用FX6. Sort me(将我有序化):使用tablesorter插件(表格排序)7. Plug me:制作您自己的插件8. Next steps(下一步)安装一开始,我们需要一个jQuery的库,最新的下载可以到这里找到。这个指南提供一个基本包含实例的包供下载.下载：jQuery Starterkit(译者Keel注:一定要下载这个包，光看文章不实践肯定是不行的。)下载后解压缩，然后用你最喜欢的文本编辑器打开starterkit.html和custom.js这两个文件。(译者Keel注:这两个就是例子文件,所有的例子都用这两个例子作出,cus

4、tom.js写jQuery代码,starterkit.html观察效果.建议用editPlus打开)现在,我们就已经做好了一切准备来进行这个著名的Hello world例子.本章的相关链接: Starterkit jQuery DownloadsHello jQuery在做所有事情之前,我们要让jQuery读取和处理文档的DOM,必须尽可能快地在DOM载入后开始执行事件,所以,我们用一个ready事件作为处理HTML文档的开始.看看我们打开的custom.js这个文件,里面已经准备好了:$(document).ready(function() / do stuff when DOM is re

5、ady);放一个简单的alert事件在需要等DOM完成载入,所以我们把任务稍稍变复杂一点:在点击任何一个链接时显示一个alert.$(document).ready(function() $(a).click(function() alert(Hello world!); ););这样在你点击页面的一个链接时都会触发这个Hello world的提示。(译者Keel注:请照此代码修改custom.js并保存,然后用浏览器打开starterkit.html观察效果。)让我们看一下这些修改是什么含义。$(a) 是一个jQuery选择器(selector),在这里，它选择所有的a标签（译者Keel注：

6、即），$号是 jQuery “类”(jQuery class)的一个别称，因此$()构造了一个新的jQuery 对象(jQuery object)。函数 click() 是这个jQuery对象的一个方法，它绑定了一个单击事件到所有选中的标签(这里是所有的a标签),并在事件触发时执行了它所提供的alert方法.这里有一个拟行相似功能的代码:Link不同之处很明显,用jQuery不需要在每个a标签上写onclick事件,所以我们拥有了一个整洁的结构文档(HTML)和一个行为文档(JS),达到了将结构与行为分开的目的,就像我们使用CSS追求的一样.下面我们会更多地了解到选择器与事件.本章的相关链接:

7、 jQuery Core jQuery Selectors jQuery EventsFind me:使用选择器和事件jQuery提供两种方式来选择html的elements，第一种是用CSS和Xpath选择器联合起来形成一个字符串来传送到jQuery的构造器（如：$(div ul a)）；第二种是用jQuery对象的几个methods(方法)。这两种方式还可以联合起来混合使用。为了测试一下这些选择器，我们来试着在我们starterkit.html中选择并修改第一个ordered list.一开始，我们需要选择这个list本身，这个list有一个ID叫“orderedlist”，通常的java

8、script写法是document.getElementById(orderedlist).在jQuery中，我们这样做：$(document).ready(function() $(#orderedlist).addClass(red););这里将starterkit中的一个CSS样式red附加到了orderedlist上(译者Keel注：参考测试包中的css目录下的core.css，其中定义了red样式)。因此，在你刷新了starterkit.html后，你将会看到第一个有序列表(ordered list )背景色变成了红色，而第二个有序列表没有变化.现在，让我们添加一些新的样式到list

9、的子节点.$(document).ready(function() $(#orderedlist li).addClass(blue););这样，所有orderedlist中的li都附加了样式blue。现在我们再做个复杂一点的，当把鼠标放在li对象上面和移开时进行样式切换，但只在list的最后一个element上生效。$(document).ready(function() $(#orderedlist li:last).hover(function() $(this).addClass(green); , function() $(this).removeClass(green); ););

10、还有大量的类似的CSS和XPath例子，更多的例子和列表可以在这里找到。（译者Keel注：入门看此文，修行在个人，要想在入门之后懂更多，所以这段话的几个链接迟早是要必看的！不会又要翻译吧._!）每一个onXXX事件都有效，如onclick,onchange,onsubmit等，都有jQuery等价表示方法（译者Keel注：jQuery不喜欢onXXX，所以都改成了XXX，去掉了on）。其他的一些事件，如ready和hover,也提供了相应的方法。你可以在Visual jQuery找到全部的事件列表，在Events栏目下.用这些选择器和事件你已经可以做很多的事情了，但这里有一个更强的好东东！$(

11、document).ready(function() $(#orderedlist).find(li).each(function(i) $(this).html( $(this).html() + BAM! + i ); ););find() 让你在已经选择的element中作条件查找,因此 $(#orderedlist).find(li) 就像 $(#orderedlist li)一样。each()方法迭代了所有的li，并可以在此基础上作更多的处理。 大部分的方法,如addClass(), 都可以用它们自己的 each() 。在这个例子中, html()用来获取每个li的html文本, 追

12、加一些文字，并将之设置为li的html文本。（译者Keel注：从这个例子可以看到.html()方法是获取对象的html代码，而.html(xxx)是设置xxx为对象的html代码）另一个经常碰到的任务是在没有被jQuery覆盖的DOM元素上call一些方法，想像一个在你用AJAX方式成功提交后的reset：$(document).ready(function() / use this to reset a single form $(#reset).click(function() $(form)0.reset(); ););（译者Keel注：这里作者将form的id也写成了form，源文件有

13、，这是非常不好的写法，你可以将这个ID改成form1或者testForm，然后用$(#form1)或者$(#testForm)来表示它，再进行测试。）上面这个代码选择了所有的form元素，并在其中的第一个上call了一个reset()。如果你有一个以上的form，你可以这样做：$(document).ready(function() / use this to reset several forms at once $(#reset).click(function() $(form).each(function() this.reset(); ); ););（译者Keel注：请注意一定要亲自将

14、这些代码写在custom.js中并在starterkit.html上测试效果才能有所体会！必要时要观察starterkit.html的html代码）这样你在点击Reset链接后，就选择了文档中所有的form元素，并对它们都执行了一次reset()。还有一个你可能要面对的问题是不希望某些特定的元素被选择。jQuery 提供了filter() 和not() 方法来解决这个问题。 filter()以过滤表达式来减少不符合的被选择项, not()则用来取消所有符合过滤表达式的被选择项. 考虑一个无序的list，你想要选择所有的没有ul子元素的li元素。$(document).ready(functio

15、n() $(li).not(:has(ul).css(border, 1px solid black);/原文为$(li).not(ul).css(border, 1px solid black););这个代码选择了所有的li元素，然后去除了有ul子元素的li元素。刷新浏览器后，所有的li元素都有了一个边框，只有ul子元素的那个li元素例外。（译者Keel注：请注意体会方便之极的css()方法，并再次提醒请务必实际测试观察效果，比方说换个CSS样式呢？再加一个CSS样式呢？像这样：$(li).not(ul).css(border, 1px solid black).css(color,red)

16、;）上面代码中的expression 语法是从XPath而来，可以在子元素和属性(elements and attributes)上用作过滤器，比如你可能想选择所有的带有name属性的链接:$(document).ready(function() $(aname).css(background-color,#eee); /原文为“$(aname).background(#eee);”在jQuery1.2及以上版本中,符号应该去除,background方法被css方法取代);这个代码给所有带有name属性的链接加了一个背景色。（译者Keel注：这个颜色太不明显了，建议写成$(aname).css

17、(background-color,#eee);）注：在jQuery1.2及以上版本中,符号应该去除,下文中不再说明更常见的情况是以name来选择链接，你可能需要选择一个有特点href属性的链接，这在不同的浏览器下对href的理解可能会不一致，所以我们的部分匹配(*=)的方式来代替完全匹配(=)：$(document).ready(function() $(ahref*=/content/gallery).click(function() / do something with all links that point somewhere to /content/gallery ););到现在

18、为止，选择器都用来选择子元素或者是过滤元素。另外还有一种情况是选择上一个或者下一个元素，比如一个FAQ的页面，答案首先会隐藏，当问题点击时，答案显示出来，jQuery代码如下：$(document).ready(function() $(#faq).find(dd).hide().end().find(dt).click(function() var answer = $(this).next(); if (answer.is(:visible) answer.slideUp(); else answer.slideDown(); ););这里我们用了一些链式表达法来减少代码量，而且看上去更直

19、观更容易理解。像#faq 只选择了一次，利用end()方法，第一次find()方法会结束(undone)，所以我们可以接着在后面继续find(dt)，而不需要再写$(#faq).find(dt)。在点击事件中的，我们用 $(this).next() 来找到dt下面紧接的一个dd元素，这让我们可以快速地选择在被点击问题下面的答案。（译者Keel注：这个例子真是太酷了，FAQ中的答案可以收缩！从利用next()的思路到实现这些效果都有很多地方需要我们消化，注意 if (answer.is(:visible)用法，注意answer.slideUp();不懂的地方赶紧查我在最开始提到的两个必看API文

20、档）除了选择同级别的元素外，你也可以选择父级的元素。可能你想在用户鼠标移到文章某段的某个链接时，它的父级元素-也就是文章的这一段突出显示，试试这个：$(document).ready(function() $(a).hover(function() $(this).parents(p).addClass(highlight); , function() $(this).parents(p).removeClass(highlight); ););测试效果可以看到，移到文章某段的链接时，它所在的段全用上highlight样式，移走之后又恢复原样。（译者Keel注：highlight是core.c

21、ss中定义的样式，你也可以改变它，注意这里有第二个function()这是hover方法的特点，请在API文档中查阅hover，上面也有例子说明）在我们继续之前我们先来看看这一步： jQuery会让代码变得更短从而更容易理解和维护，下面是$(document).ready(callback)的缩写法：$(function() / code to execute when the DOM is ready);应用到我们的Hello world例子中，可以这样:$(function() $(a).click(function() alert(Hello world!); ););现在，我们手上有了

22、这些基础的知识，我们可以更进一步的探索其它方面的东西，就从AJAX开始！本章的相关链接: jQuery API documentation Visual jQuery - A categorized browsable API documentation jQuery Expressions: CSS jQuery Expressions: XPath jQuery Expressions: Custom jQuery Special Events jQuery DOM TraversingRate me:使用AJAX在这一部分我们写了一个小小的AJAX应用，它能够rate一些东西（译Keel

23、注：就是对某些东西投票），就像在上面看到的一样。首先我们需要一些服务器端代码，这个例子中用到了一个PHP文件，读取rating参数然后返回rating总数和平均数。看一下rate.php代码.虽然这些例子也可以不使用AJAX来实现，但显示我们不会那么做，我们用jQuery生成一个DIV容器，ID是rating.$(document).ready(function() / generate markup var ratingMarkup = Please rate: ; for(var i=1; i = 5; i+) ratingMarkupratingMarkup.length = + i +

24、 ; / add markup to container and applier click handlers to anchors $(#rating).append( ratingMarkup.join() ).find(a).click(function(e) e.preventDefault(); / send requests $.post(rate.php, rating: $(this).html(), function(xml) / format result var result = Thanks for rating, current average: , $(averag

25、e, xml).text(), , number of votes: , $(count, xml).text() ; / output result $(#rating).html(result.join(); ); ););这段代码生成了5个链接，并将它们追加到id为rating容器中，当其中一个链接被点击时，该链接标明的分数就会以rating参数形式发送到rate.php，然后，结果将以XML形式会从服务器端传回来，添加到容器中，替代这些链接。如果你没有一个安装过PHP的webserver，你可以看看这个在线的例子.不使用javascript实现的例子可以访问softonic.de点击

26、Kurz bewerten!更多的AJAX方法可以从这里找到，或者看看API文档下面的AJAX filed under AJAX.（译者Keel注：这个在线实例从国内访问还是比较慢的，点击后要等一会儿才能看到结果，可以考虑对它进行修改，比如加上loading，投票后加上再投票的返回链接等。此外，这个例子中还是有很多需要进一步消化的地方，看不懂的地方请参考API文档。）一个在使用AJAX载入内容时经常发生的问题是：当载入一个事件句柄到一个HTML文档时，还需要在载入内容上应用这些事件，你不得不在内容加载完成后应用这些事件句柄，为了防止代码重复执行，你可能用到如下一个function:/ lets

27、 use the shortcut$(function() var addClickHandlers = function() $(a.clickMeToLoadContent).click(function() $(#target).load(this.href, addClickHandlers); ); ; addClickHandlers(););现在，addClickHandlers只在DOM载入完成后执行一次，这是在用户每次点击具有clickMeToLoadContent 这个样式的链接并且内容加载完成后.请注意addClickHandlers函数是作为一个局部变量定义的，而不是全

28、局变量(如：function addClickHandlers() .)，这样做是为了防止与其他的全局变量或者函数相冲突.另一个常见的问题是关于回调(callback)的参数。你可以通过一个额外的参数指定回调的方法，简单的办法是将这个回调方法包含在一个其它的function中:/ get some datavar foobar = .;/ specify handler, it needs data as a paramtervar handler = function(data) .;/ add click handler and pass foobar!$(a).click( functi

29、on(event) handler(foobar); );/ if you need the context of the original handler, use apply:$(a).click( function(event) handler.apply(this, foobar); );用到简单的AJAX后，我们可以认为已经非常之“web2.0”了，但是到现在为止，我们还缺少一些酷炫的效果。下一节将会谈到这些效果.本章的相关链接: jQuery AJAX Module jQuery API: Contains description and examples for append and all other jQuery methods ThickBox: A jQuery plugin that uses jQuery to enhance the famous lightboxAnimate me(让我生动起来):使用FX一些动态的效果可以使用show()和hide()来表现:$(document).ready(function()