jQuery入门指南教程
这个指南是一个对jQuery库的说明，要求读者了解HTML(DOM)和CSS的一些常识。它包括了一个简单的Hello World的例子，选择器和事件基础，AJAX、FX的用法，以及如何制作jQuery的插件。这个指南包括了很多代码，你可以copy它们，并试着修改它们，看看产生的效果。
内容提要
安装
一开始,我们需要一个jQuery的库,最新的下载可以到这里找到。这个指南提供一个基本包含实例的包供下载.
(译者Keel注:一定要下载这个包，光看文章不实践肯定是不行的。)
下载后解压缩，然后用你最喜欢的文本编辑器打开starterkit.html和custom.js这两个文件。(译者Keel注:这两个就是例子文件,所有的例子都用这两个例子作出,custom.js写jQuery代码,starterkit.html观察效果.建议用editPlus打开)
现在,我们就已经做好了一切准备来进行这个著名的"Hello world"例子.
本章的相关链接:
Hello jQuery
在做所有事情之前,我们要让jQuery读取和处理文档的DOM,必须尽可能快地在DOM载入后开始执行事件,所以,我们用一个ready事件作为处理HTML文档的开始.看看我们打开的custom.js这个文件,里面已经准备好了:
$(document).ready(function() {
// do stuff when DOM is ready
});
放一个简单的alert事件在需要等DOM完成载入,所以我们把任务稍稍变复杂一点:在点击任何一个链接时显示一个alert.
$(document).ready(function() {
$("a").click(function() {
alert("Hello world!");
});
});
这样在你点击页面的一个链接时都会触发这个"Hello world"的提示。
(译者Keel注:请照此代码修改custom.js并保存,然后用浏览器打开starterkit.html观察效果。)
让我们看一下这些修改是什么含义。$("a") 是一个jQuery选择器(selector),在这里，它选择所有的a标签（译者Keel注：即<a></a>），$号是 jQuery “类”(jQuery "class")的一个别称，因此$()构造了一个新的jQuery 对象(jQuery object)。函数 click() 是这个jQuery对象的一个方法，它绑定了一个单击事件到所有选中的标签(这里是所有的a标签),并在事件触发时执行了它所提供的alert方法.
这里有一个拟行相似功能的代码:
<a href="#" οnclick="alert('Hello world')">Link</a>
不同之处很明显,用jQuery不需要在每个a标签上写onclick事件,所以我们拥有了一个整洁的结构文档(HTML)和一个行为文档(JS),达到了将结构与行为分开的目的,就像我们使用CSS追求的一样.
下面我们会更多地了解到选择器与事件.
本章的相关链接:
Find me:使用选择器和事件
jQuery提供两种方式来选择html的elements，第一种是用CSS和Xpath选择器联合起来形成一个字符串来传送到jQuery的构造器（如：$("div > ul a")）；第二种是用jQuery对象的几个methods(方法)。这两种方式还可以联合起来混合使用。
为了测试一下这些选择器，我们来试着在我们starterkit.html中选择并修改第一个ordered list.
一开始，我们需要选择这个list本身，这个list有一个ID叫“orderedlist”，通常的javascript写法是document.getElementById("orderedlist").在jQuery中，我们这样做：
$(document).ready(function() {
$("#orderedlist").addClass("red");
});
这里将starterkit中的一个CSS样式red附加到了orderedlist上(译者Keel注：参考测试包中的css目录下的core.css，其中定义了red样式)。因此，在你刷新了starterkit.html后，你将会看到第一个有序列表(ordered list )背景色变成了红色，而第二个有序列表没有变化.
现在，让我们添加一些新的样式到list的子节点.
$(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");
});
});
还有大量的类似的CSS和XPath例子，更多的例子和列表可以在这里找到。（译者Keel注：入门看此文，修行在个人，要想在入门之后懂更多，所以这段话的几个链接迟早是要必看的！不会又要翻译吧...^_^!）
每一个onXXX事件都有效，如onclick,onchange,onsubmit等，都有jQuery等价表示方法（译者Keel注：jQuery不喜欢onXXX，所以都改成了XXX，去掉了on）。其他的一些事件，如ready和hover,也提供了相应的方法。
你可以在Visual jQuery找到全部的事件列表，在Events栏目下.
用这些选择器和事件你已经可以做很多的事情了，但这里有一个更强的好东东！
$(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文本, 追加一些文字，并将之设置为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，源文件有<form id="form">，这是非常不好的写法，你可以将这个ID改成form1或者testForm，然后用$("#form1")或者$("#testForm")来表示它，再进行测试。）
这个代码选择了所有ID为"form"的元素，并在其第一个上call了一个reset()。如果你有一个以上的form，你可以这样做：
$(document).ready(function() {
// use this to reset several forms at once
$("#reset").click(function() {
$("form").each(function() {
this.reset();
});
});
});
（译者Keel注：请注意一定要亲自将这些代码写在custom.js中并在starterkit.html上测试效果才能有所体会！必要时要观察starterkit.html的html代码）
这样你在点击Reset链接后，就选择了文档中所有的form元素，并对它们都执行了一次reset()。
还有一个你可能要面对的问题是不希望某些特定的元素被选择。jQuery 提供了filter() 和not() 方法来解决这个问题。 filter()以过滤表达式来减少不符合的被选择项, not()则用来取消所有符合过滤表达式的被选择项. 考虑一个无序的list，你想要选择所有的没有ul子元素的li元素。
$(document).ready(function() {
$("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");）
上面代码中的[expression] 语法是从XPath而来，可以在子元素和属性(elements and attributes)上用作过滤器，比如你可能想选择所有的带有name属性的链接:
$(document).ready(function() {
$("a[@name]").background("#eee");
});
这个代码给所有带有name属性的链接加了一个背景色。（译者Keel注：这个颜色太不明显了，建议写成$("a[@name]").background("red");）
更常见的情况是以name来选择链接，你可能需要选择一个有特点href属性的链接，这在不同的浏览器下对href的理解可能会不一致，所以我们的部分匹配("*=")的方式来代替完全匹配("=")：
$(document).ready(function() {
$("a[@href*=/content/gallery]").click(function() {
// do something with all links that point somewhere to /content/gallery
});
});
到现在为止，选择器都用来选择子元素或者是过滤元素。另外还有一种情况是选择上一个或者下一个元素，比如一个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();
}
});
});
这里我们用了一些链式表达法来减少代码量，而且看上去更直观更容易理解。像'#faq' 只选择了一次，利用end()方法，第一次find()方法会结束(undone)，所以我们可以接着在后面继续find('dt')，而不需要再写$('#faq').find('dt')。
在点击事件中的，我们用 $(this).next() 来找到dt下面紧接的一个dd元素，这让我们可以快速地选择在被点击问题下面的答案。
（译者Keel注：这个例子真是太酷了，FAQ中的答案可以收缩！从利用next()的思路到实现这些效果都有很多地方需要我们消化，注意 if (answer.is(':visible'))用法，注意answer.slideUp();不懂的地方赶紧查我在最开始提到的两个必看API文档）
除了选择同级别的元素外，你也可以选择父级的元素。可能你想在用户鼠标移到文章某段的某个链接时，它的父级元素--也就是文章的这一段突出显示，试试这个：
$(document).ready(function() {
$("a").hover(function() {
$(this).parents("p").addClass("highlight");
}, function() {
$(this).parents("p").removeClass("highlight");
});
});
测试效果可以看到，移到文章某段的链接时，它所在的段全用上highlight样式，移走之后又恢复原样。
（译者Keel注：highlight是core.css中定义的样式，你也可以改变它，注意这里有第二个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!");
});
});
现在，我们手上有了这些基础的知识，我们可以更进一步的探索其它方面的东西，就从AJAX开始！
本章的相关链接:
Rate me:使用AJAX
在这一部分我们写了一个小小的AJAX应用，它能够rate一些东西（译Keel注：就是对某些东西投票），就像在youtube.com上面看到的一样。
首先我们需要一些服务器端代码，这个例子中用到了一个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++) {
ratingMarkup[ratingMarkup.length] = "<a href='#'>" + i + "</a> ";
}
// 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: ",
$("average", 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 点击 "Kurz bewerten!"
更多的AJAX方法可以从这里 找到，或者看看API文档 下面的AJAX filed under AJAX.
（译者Keel注：这个在线实例从国内访问还是比较慢的，点击后要等一会儿才能看到结果，可以考虑对它进行修改，比如加上loading，投票后加上再投票的返回链接等。此外，这个例子中还是有很多需要进一步消化的地方，看不懂的地方请参考API文档。）
一个在使用AJAX载入内容时经常发生的问题是：当载入一个事件句柄到一个HTML文档时，还需要在载入内容上应用这些事件，你不得不在内容加载完成后应用这些事件句柄，为了防止代码重复执行，你可能用到如下一个function:
// lets use the shortcut
$(function() {
var addClickHandlers = function() {
$("a.clickMeToLoadContent").click(function() {
$("#target").load(this.href, addClickHandlers);
});
};
addClickHandlers();
});
现在，addClickHandlers只在DOM载入完成后执行一次，这是在用户每次点击具有clickMeToLoadContent 这个样式的链接并且内容加载完成后.
请注意addClickHandlers函数是作为一个局部变量定义的，而不是全局变量(如：function addClickHandlers() {...})，这样做是为了防止与其他的全局变量或者函数相冲突.
另一个常见的问题是关于回调(callback)的参数。你可以通过一个额外的参数指定回调的方法，简单的办法是将这个回调方法包含在一个其它的function中:
// get some data
var foobar = ...;
// specify handler, it needs data as a paramter
var handler = function(data) {
...
};
// add click handler and pass foobar!
$('a').click( function(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”了，但是到现在为止，我们还缺少一些酷炫的效果。下一节将会谈到这些效果.
本章的相关链接:
Animate me(让我生动起来):使用FX
一些动态的效果可以使用 show() 和 hide()来表现:
$(document).ready(function() {
$("a").toggle(function() {
$(".stuff").hide('slow');
}, function() {
$(".stuff").show('fast');
});
});
你可以与 animate()联合起来创建一些效果,如一个带渐显的滑动效果:
$(document).ready(function() {
$("a").toggle(function() {
$(".stuff").animate({
height: 'hide',
opacity: 'hide'
}, 'slow');
}, function() {
$(".stuff").animate({
height: 'show',
opacity: 'show'
}, 'slow');
});
});
很多不错的效果可以访问interface plugin collection. 这个站点提供了很多demos和文档
这些效果插件是位于jQuery插件列表的前面的，当然也有很多其他的插件，比如我们下一章讲到的表格排序插件。
本章的相关链接:
Sort me(将我有序化):使用tablesorter插件(表格排序)
这个表格排序插件能让我们在客户端按某一列进行排序，引入jQuery和这个插件的js文件，然后告诉插件你想要哪个表格拥有排序功能。
要测试这个例子，先在starterkit.html中加上像下面这一行的代码：
<script src="lib/jquery.tablesorter.js" type="text/javascript"></script>
然后可以这样调用不着:
$(document).ready(function() {
$("#large").tableSorter();
});
现在点击表格的第一行head区域，你可以看到排序的效果，再次点击会按倒过来的顺序进行排列。
这个表格还可以加一些突出显示的效果，我们可以做这样一个隔行背景色（斑马线）效果:
$(document).ready(function() {
$("#large").tableSorter({
stripingRowClass: ['odd','even'], // Class names for striping supplyed as a array.
stripRowsOnStartUp: true // Strip rows on tableSorter init.
});
});
关于这个插件的更多例子和文档可以在 tablesorter首页找到.
几乎所有的特件都是这样用的:先include插件的js文件,然后在某些元素上使用插件定义的方法,当然也有一些参数选项是可以配置的
经常更新的插件列表可以从jQuery官方站 on the jQuery site找到.
当你更经常地使用jQuery时,你会发现将你自己的代码打包成插件是很有用处的,它能方便地让你的公司或者其他人进行重用.下一章我们将谈到如何构建一个自己的插件.
本章的相关链接:
Plug me:制作自己的插件
写一个自己的jQuery插件是非常容易的,如果你按照下面的原则来做,可以让其他人也容易地结合使用你的插件.
- 为你的插件取一个名字,在这个例子里面我们叫它"foobar".
- 创建一个像这样的文件:jquery.[yourpluginname].js,比如我们创建一个jquery.foobar.js
- 创建一个或更多的插件方法,使用继承jQuery对象的方式,如:
jQuery.fn.foobar = function() {
// do something
}; - 可选的:创建一个用于帮助说明的函数,如:
jQuery.fooBar = {
height: 5,
calculateBar = function() { ... },
checkDependencies = function() { ... }
};你现在可以在你的插件中使用这些帮助函数了:
jQuery.fn.foobar = function() {
// do something
jQuery.foobar.checkDependencies(value);
// do something else
}; - 可选的l:创建一个默认的初始参数配置,这些配置也可以由用户自行设定,如:
jQuery.fn.foobar = function(options) {
var settings = {
value: 5,
name: "pete",
bar: 655
};
if(options) {
jQuery.extend(settings, options);
}
};现在可以无需做任何配置地使用插件了,默认的参数在此时生效:
$("...").foobar();或者加入这些参数定义:
$("...").foobar({
value: 123,
bar: 9
});
如果你release你的插件, 你还应该提供一些例子和文档,大部分的插件都具备这些良好的参考文档.
现在你应该有了写一个插件的基础,让我们试着用这些知识写一个自己的插件.
很多人试着控制所有的radio或者checkbox是否被选中,比如:
$("input[@type='checkbox']").each(function() {
this.checked = true;
// or, to uncheck
this.checked = false;
// or, to toggle
this.checked = !this.checked;
});
无论何时候，当你的代码出现each时，你应该重写上面的代码来构造一个插件,很直接地:
$.fn.check = function() {
return this.each(function() {
this.checked = true;
});
};
这个插件现在可以这样用:
$("input[@type='checkbox']").check();
现在你应该还可以写出uncheck()和toggleCheck()了.但是先停一下,让我们的插件接收一些参数.
$.fn.check = function(mode) {
var mode = mode || 'on'; // if mode is undefined, use 'on' as default
return this.each(function() {
switch(mode) {
case 'on':
this.checked = true;
break;
case 'off':
this.checked = false;
break;
case 'toggle':
this.checked = !this.checked;
break;
}
});
};
这里我们设置了默认的参数,所以将"on"参数省略也是可以的,当然也可以加上"on","off", 或 "toggle",如:
$("input[@type='checkbox']").check();
$("input[@type='checkbox']").check('on');
$("input[@type='checkbox']").check('off');
$("input[@type='checkbox']").check('toggle');
如果有多于一个的参数设置会稍稍有点复杂,在使用时如果只想设置第二个参数,则要在第一个参数位置写入null.
从上一章的tablesorter插件用法我们可以看到,既可以省略所有参数来使用或者通过一个 key/value 对来重新设置每个参数.
作为一个练习,你可以试着将 第四章 的功能重写为一个插件.这个插件的骨架应该是像这样的:
$.fn.rateMe = function(options) {
var container = this; // instead of selecting a static container with $("#rating"), we now use the jQuery context
var settings = {
url: "rate.php"
// put more defaults here
// remember to put a comma (",") after each pair, but not after the last one!
};
if(options) { // check if options are present before extending the settings
$.extend(settings, options);
}
// ...
// rest of the code
// ...
return this; // if possible, return "this" to not break the chain
});
Next steps(下一步)
如果你想做更好的javascript开发,建议你使用一个叫 FireBug的firefox插件. 它提供了断点调试(比alert强多了)、观察DOM变化等很多漂亮的功能
如果你还有未解决的问题，或者新的想法与建议，你可以使用jQuery的邮件列表 jQuery mailing list.
还有什么...
大大感谢John Resig创造了这么好的library! 感谢jQuery community 为John提供了如此多的咖啡和其他的一切!
---------------------------------------------------
jQuery是一款同prototype一样优秀js开发库类，特别是对css和XPath的支持，使我们写js变得更加方便！如果你不是个js高手又想写出优 秀的js效果，jQuery可以帮你达到目的！
下载地址：Starterkit （http://jquery.bassistance.de/jquery-starterkit.zip）
jQuery Downloads （http://jquery.com/src/）
下载完成后先加载到文档中，然后我们来看个简单的例子！
$(document).ready( function (){
$( " a " ).click( function () {
alert( " Hello world! " );
});
});
< script >
上边的效果是点击文档中所有 a标签时将弹出对话框，$("a") 是一个jQuery选择器，$本身表示一个jQuery类，所有$()是构造一个jQuery对象，click()是这个对象的方法，同理$(document)也是一个jQuery对象，ready(fn)是$(document)的方法，表示当document全部下载完毕时执行函数。
在进行下面内容之前我还要说明一点$("p")和$("#p")的区别,$("p")表示取所有p标签(<p></p>)的元素,$("#p")表示取id为"p"(<span id="p"></span>)的元素.
我将从以下几个内容来讲解jQuery的使用:
1:核心部分
2:DOM操作
3:css操作
4:javascript处理
5:动态效果
6:event事件
7:ajax支持
8:插件程序
一：核心部分
$(expr)
说明：该函数可以通过css选择器，Xpath或html代码来匹配目标元素，所有的jQuery操作都以此为基础
参数：expr：字符串，一个查询表达式或一段html字符串
例子：
未执行jQuery前：
<
p
>
one
</
p
>
<
div
>
<
p
>
two
</
p
>
</
div
>< p > three </ p >
< a href ="#" id ="test" onClick ="jq()" > jQuery </ a >
jQuery代码及功能：
alert($( " div > p " ).html());
}
运行：当点击id为test的元素时，弹出对话框文字为two，即div标签下p元素的内容
$( " <div><p>Hello</p></div> " ).appendTo( " body " );
}
运行：当点击id为test的元素时，向body中添加“<div><p>Hello</p></div>”
$(elem)
说明：限制jQuery作用于一个特定的dom元素，这个函数也接受xml文档和windows对象
参数： elem：通过jQuery对象压缩的DOM元素
例子：
未执行jQuery前：
< div >
< p > two </ p >
</ div >< p > three </ p >
< a href ="#" id ="test" onClick ="jq()" > jQuery </ a >
jQuery代码及功能：
alert($(document).find( " div > p " ).html());
}
运行：当点击id为test的元素时，弹出对话框文字为two，即div标签下p元素的内容
$(document.body).background( " black " );
}
运行：当点击id为test的元素时，背景色变成黑色
$(elems)
说明：限制jQuery作用于一组特定的DOM元素
参数： elem：一组通过jQuery对象压缩的DOM元素
例子：
未执行jQuery前：
<
form
id
="form1"
>
<
input
type
="text"
name
="textfield"
>
<
input
type
="submit"
name
="Submit"
value
="提交"
>
</
form
>
<
a
href
="#"
id
="test"
onClick
="jq()"
>
jQuery
</
a
>
jQuery代码及功能：
$(form1.elements ).hide();
}
运行：当点击id为test的元素时，隐藏form1表单中的所有元素。
$(fn)
说明：$(document).ready()的一个速记方式，当文档全部载入时执行函数。可以有多个$(fn)当文档载入时，同时执行所有函数！
参数：fn (Function):当文档载入时执行的函数！
例子：
$(document.body).background( " black " );
})
运行：当文档载入时背景变成黑色，相当于onLoad。
$(obj)
说明：复制一个jQuery对象，
参数：obj (jQuery): 要复制的jQuery对象
例子：
未执行jQuery前：
< div >
< p > two </ p >
</ div >
< p > three </ p >
< a href ="#" id ="test" onClick ="jq()" > jQuery </ a >
jQuery代码及功能：
var f = $( " div " );
alert($(f).find( " p " ).html())
}
运行：当点击id为test的元素时，弹出对话框文字为two，即div标签下p元素的内容。
each(fn)
说明：将函数作用于所有匹配的对象上
参数：fn (Function): 需要执行的函数
例子：
未执行jQuery前：
< img src ="1.jpg" />
< a href ="#" id ="test" onClick ="jq()" > jQuery </ a >
jQuery代码及功能：
$( " img " ).each( function (){
this .src = " 2.jpg " ; });
}
运行：当点击id为test的元素时，img标签的src都变成了2.jpg。
eq(pos)
说明：减少匹配对象到一个单独得dom元素
参数：pos (Number): 期望限制的索引，从0 开始
例子：
未执行jQuery前：
<
p
>
This is just a test.
</
p
>
<
p
>
So is this
</
p
>
<
a
href
="#"
id
="test"
onClick
="jq()"
>
jQuery
</
a
>
jQuery代码及功能：
alert($( " p " ).eq( 1 ).html())
}
运行：当点击id为test的元素时，alert对话框显示：So is this，即第二个<p>标签的内容
get() get(num)
说明：获取匹配元素，get(num)返回匹配元素中的某一个元素
参数：get (Number): 期望限制的索引，从0 开始
例子：
未执行jQuery前：
< p > So is this </ p >
< a href ="#" id ="test" onClick ="jq()" > jQuery </ a >
jQuery代码及功能：
alert($( " p " ).get( 1 ).innerHTML);
}
运行：当点击id为test的元素时，alert对话框显示：So is this，即第二个<p>标签的内容
注意get和eq的区别，eq返回的是jQuery对象，get返回的是所匹配的dom对象，所有取$("p").eq(1)对象的内容用jQuery方法html()，而取$("p").get(1)的内容用innerHTML
index(obj)
说明：返回对象索引
参数：obj (Object): 要查找的对象
例子：
未执行jQuery前：
< div id ="test2" ></ div >
< a href ="#" id ="test" onClick ="jq()" > jQuery </ a >
jQuery代码及功能：
alert($( " div " ).index(document.getElementById('test1')));
alert($( " div " ).index(document.getElementById('test2')));
}
运行：当点击id为test的元素时，两次弹出alert对话框分别显示0，1
size() Length
说明：当前匹配对象的数量，两者等价
例子：
未执行jQuery前：
< img src ="test2.jpg" />
< a href ="#" id ="test" onClick ="jq()" > jQuery </ a >
jQuery代码及功能：
alert($( " img " ).length);
}
运行：当点击id为test的元素时，弹出alert对话框显示2，表示找到两个匹配对象
二：DOM操作
属性
我们以<img id="a" scr="5.jpg"/>为例，在原始的javascript里面可以用var o=document.getElementById('a')取的id为a的节点对象，在用o.src来取得或修改该节点的scr属性，在jQuery 里$("#a")将得到jQuery对象[ <img id="a" scr="5.jpg"/> ]，然后可以用jQuery提供的很多方法来进行操作，如$("#a").scr()将得到5.jpg,$("#a").scr("1.jpg")将该对象src属性改为1,jpg。下面我们来讲jQuery提供的众多jQuery方法，方便大家快速对DOM对象进行操作
herf() herf(val)
说明：对jQuery对象属性herf的操作。
例子：
未执行jQuery前
jQuery代码及功能：
alert($( " #test " ).href());
$( " #test " ).href( " 2.html " );
}
运行：先弹出对话框显示id为test的连接url，在将其url改为2.html，当弹出对话框后会看到转向到2.html
同理，jQuery还提供类似的其他方法，大家可以分别试验一下：
herf() herf(val) html() html(val) id() id (val) name() name (val) rel() rel (val)
src() src (val) title() title (val) val() val(val)
操作
after(html) 在匹配元素后插入一段html
append(html)在匹配元素内部，且末尾插入指定html
同理还有append(elem) append(elems) before(html) before(elem) before(elems)请执行参照append和after的方来测试、理解！
appendTo(expr) 与append(elem)相反
<
p
id
="test"
>
after
</
p
><
a
href
="#"
onClick
="jq()"
>
jQuery
</
a
>
jQuery代码及功能
$( " a " ). appendTo ($( " #test " ));
}
执行后相当于
clone() 复制一个jQuery对象
jQuery代码及功能：
$( " #test " ).clone().appendTo($( " a " ));
}
复制$("#test")然后插入到<a>后,执行后相当于
wrap(elem) 将匹配对象包含在给出的对象内
< a href ="#" onClick ="jq()" > jQuery </ a >
$("p" ).wrap( document.getElementById('content') );
}
执行后相当于
遍历、组合
add(expr) 在原对象的基础上在附加符合指定表达式的jquery对象
<a href="#" onClick="jq()">jQuery</a>
jQuery代码及功能：
var f = $( " p " ).add( " span " );
for ( var i = 0 ;i < $(f).size();i ++ ){
alert($(f).eq(i).html());}
}
执行$("p")得到匹配<p>的对象，有两个，add("span")是在("p")的基础上加上匹配<span >的对象，所有一共有3个，从上面的函数运行结果可以看到$("p").add("span")是3个对象的集合，分别是 [<p>Hello</p>]，[<p><span>Hello Again</span></p>]，[<span>Hello Again</span>]。
add(el) 在匹配对象的基础上在附加指定的dom元素。
$("p").add(document.getElementById("a"));
add(els) 在匹配对象的基础上在附加指定的一组对象，els是一个数组。
<
p
>
Hello
</
p
><
p
><
span
>
Hello Again
</
span
></
p
>
jQuery代码及功能：
var f = $( " p " ).add([document.getElementById( " a " ), document.getElementById( " b " )])
for ( var i = 0 ;i < $(f).size();i ++ ){
alert($(f).eq(i).html());}
}
注意els是一个数组，这里的[ ]不能漏掉。
ancestors () 一依次以匹配结点的父节点的内容为对象,根节点除外（有点不好理解，看看下面例子就明白了）
< p > one </ p >
< span >
< u > two </ u >
</ span >
</ div >
jQuery代码及功能：
var f = $( " u " ).ancestors();
for ( var i = 0 ;i < $(f).size();i ++ ){
alert($(f).eq(i).html());}
}
第一个对象是以<u>的父节点的内容为对象，[ <u>two</u> ]
第一个对象是以<u>的父节点的父节点（div）的内容为对象，[<p>one</p><span><u>two</u></span> ]
一般一个文档还有<body>和<html>，依次类推下去。
ancestors (expr) 在ancestors（）的基础上之取符合表达式的对象
如上各例子讲var f改为var f= $("u").ancestors(“div”),则只返回一个对象：
[ <p>one</p><span><u>two</u></span> ]
children() 返回匹配对象的子介点
< div id ="ch" >
< span > two </ span >
</ div >
jQuery代码及功能：
alert($( " #ch " ).children().html());
}
$("#ch").children()得到对象[ <span>two</span> ].所以.html()的结果是”two”
children(expr) 返回匹配对象的子介点中符合表达式的节点
< span > two </ span >
< span id ="sp" > three </ span >
</ div >
jQuery代码及功能
alert($( " #ch " ).children(“#sp”).html());
}
$("#ch").children()得到对象[<span>two</span><span id="sp">three</span> ].
$("#ch").children(“#sp”)过滤得到[<span id="sp">three</span> ]
parent () parent (expr)取匹配对象父节点的。参照children帮助理解
contains(str) 返回匹配对象中包含字符串str的对象
<
p
>
This is just a test.
</
p
><
p
>
So is this
</
p
>
jQuery代码及功能：
alert($( " p " ).contains( " test " ).html());
}
$("p")得到两个对象，而包含字符串”test”只有一个。所有$("p").contains("test")返回 [ <p>This is just a test.</p> ]
end() 结束操作,返回到匹配元素清单上操作前的状态.
filter(expr) filter(exprs) 过滤现实匹配符合表达式的对象 exprs为数组，注意添加“[ ]”
jQuery代码及功能：
alert($( " p " ).filter( " .selected " ).html())
}
$("p")得到三个对象，$("p").contains("test")只返回class为selected的对象。
find(expr) 在匹配的对象中继续查找符合表达式的对象
Query代码及功能：
alert($( " p " ).find( " #a " ).html())
}
在$("p")对象中查找id为a的对象。
is(expr) 判断对象是否符合表达式,返回boolen值
Query代码及功能：
alert($( " #a " ).is( " p " ));
}
在$("#a ")是否符合jquery表达式。
大家可以用$("#a").is("div"); ("#a").is("#a")多来测试一下
next() next(expr) 返回匹配对象剩余的兄弟节点
jQuery代码及功能
alert($( " p " ).next().html());
alert($( " p " ).next( " .selected " ).html());
}
$("p").next()返回 [ <p id="a">Hello Again</p> , <p class="selected">And Again</p> ]两个对象
$("p").next(".selected)只返回 [<p class="selected">And Again</p> ]一个对象
prev () prev (expr) 参照next理解
not(el) not(expr) 从jQuery对象中移出匹配的对象，el为dom元素，expr为jQuery表达式。
< a href ="#" onclick ="js()" > jQuery </ a >
jQuery代码及功能：
alert($( " p " ).not(document.getElementById( " a " )).html());
alert($( " p " ).not(“#a”).html());
}
$("p")由两个对象，排除后的对象为[<p>one</p> ]
siblings () siblings (expr) jquery匹配对象中其它兄弟级别的对象
< div >
< p id ="a" > two </ p >
</ div >
< a href ="#" onclick ="js()" > jQuery </ a >
jQuery代码及功能：
alert($( " div " ).siblings().eq( 1 ).html());
}
$("div").siblings()的结果实返回两个对象[<p>one</p>，<a href="#" οnclick="js()">jQuery</a> ]
alert($("div").siblings(“a”)返回一个对象[<a href="#" οnclick="js()">jQuery</a> ]
其他
addClass(class) 为匹配对象添加一个class样式
removeClass (class) 将第一个匹配对象的某个class样式移出
attr (name) 获取第一个匹配对象的属性
jQuery代码及功能：
alert($( " img " ).attr( " src " ));
}
返回test.jpg
attr (prop) 为第一个匹配对象的设置属性，prop为hash对象，用于为某对象批量添加众多属性
jQuery代码及功能：
$( " img " ).attr({ src: " test.jpg " , alt: " Test Image " });
}
运行结果相当于<img src="test.jpg" alt="Test Image"/>
attr (key,value) 为第一个匹配对象的设置属性，key为属性名，value为属性值
jQuery代码及功能
$( " img " ).attr(“src”,”test.jpg”);
}
运行结果相当于<img src="test.jpg"/>
removeAttr (name) 将第一个匹配对象的某个属性移出
jQuery代码及功能：
$( " img " ). removeAttr( " alt " );
}
运行结果相当于<img />
toggleClass (class) 将当前对象添加一个样式，不是当前对象则移出此样式，返回的是处理后的对象
$("p")的结果是返回对象 [<p>Hello</p>,<p class="selected">Hello Again</p> ]
$("p").toggleClass("selected")的结果是实返回对象 [ <p class="selected">Hello</p>, <p>Hello Again</p> ]
css(name) 获取样式名为name的样式
$("#a").css("color") 将得到样式中color值red，("#a").css("background ")将得到blue
css(prop) prop是一个hash对象，用于设置大量的css样式
$("#b").css({ color: "red", background: "blue" });
最终效果是<p id="b" style="background:blue; color:red">test</p>,{ color: "red", background: "blue" }，hash对象，color为key，"red"为value，
css(key, value) 用于设置一个单独得css样式
$("#b").css("color","red");最终效果是<p id="b" style="color:red">test</p>
四：JavaScript处理
$.browser() 判断浏览器类型，返回boolen值
if ($.browser.msie) {
alert( " 这是一个IE浏览器 " );}
else if ($.browser.opera) {
alert( " 这是一个opera浏览器 " );}
})
当页面载入式判断浏览器类型，可判断的类型有msie、mozilla、opera、safari
$.each(obj, fn) obj为对象或数组，fn为在obj上依次执行的函数，注意区分$().each()
??? 分别将0，1，2为参数，传入到function(i)中
??? { name: "John", lang: "JS" }为一个hash对象，依次将hash中每组对象传入到函数中
$.extend(obj, prop) 用第二个对象扩展第一个对象
var options = { validate: true , name: " bar " };
$.extend(settings, options);
执行后settings对象为{ validate: true, limit: 5, name: "bar" }
可以用下面函数来测试
var settings = { validate: false , limit: 5 , name: " foo " };
var options = { validate: true , name: " bar " };
$.extend(settings, options);
$.each(settings, function (i){ alert( i + " = " + this ); });
})
$.grep(array,fn) 通过函数fn来过滤array，将array中的元素依次传给fn，fn必须返回一个boolen，如fn返回true，将被过滤
var arr = $.grep( [ 0 , 1 , 2 , 3 , 4 ], function (i){ return i > 2 ; });
$.each(arr, function (i){ alert(i); });
})
我们可以看待执行$.grep后数组[0,1,2,3,4]变成[0，1]
$.merge(first, second) 两个参数都是数组，排出第二个数组中与第一个相同的，再将两个数组合并
var arr = $.merge( [ 0 , 1 , 2 ], [ 2 , 3 , 4 ] )
$.each(arr, function (i){ alert(i); });
})
可以看出arr的结果为[0,1,2,3,4]
$.trim(str) 移出字符串两端的空格
$.trim(" hello, how are you? ")的结果是"hello, how are you?"
五：动态效果
在将这部分之前我们先看个例子，相信做网页的朋友都遇到n级菜单的情景，但点击某菜单按钮时，如果它的子菜单是显示的，则隐藏子菜单，如果子菜单隐藏，则显示出来，传统的javascript做法是先用getElementById取出子菜单所在容器的id，在判断该容器的style.display是否等于none，如果等于则设为block,如果不等于这设为none，如果在将效果设置复杂一点，当点击按钮时，不是忽然隐藏和显示子菜单，而是高度平滑的转变，这时就要通过setTimeout来设置子菜单的height了，再复杂一点透明度也平滑的消失和显现，这时显现下来需要编写很多代码，如果js 基础不好的朋友可能只能从别人写好的代码拿过来修改了！jQuery实现上面效果只需要1句话就行，$("#a").toggle("slow"),
,学完jQuery后还需要抄袭修改别人的代码吗？下面我们逐个介绍jQuery用于效果处理的方法。
hide() 隐藏匹配对象
<img src="1.jpg" style="width:150px"/>
<a href="#" onClick='$("img").toggle("slow")'>jQuery</a>
fadeIn(speeds) fadeOut(speeds) 根据速度调整透明度来显示或隐藏匹配对象，注意有别于hide(speed)和show(speed)，fadeIn和fadeOut都只调整透明度，不调整大小
点击连接后可以看到图片逐渐显示。
fadeIn(speed, callback) fadeOut(speed, callback) callback为函数，先通过调整透明度来显示或隐藏匹配对象，当调整结束后执行callback函数
<a href="#" onClick='$("img ").fadeIn("slow",function(){ alert("Animation Done."); })'> jQuery </a>
点击连接后可以看到图片逐渐显示,显示完全后弹出对话框
fadeTo(speed, opacity, callback) 将匹配对象以speed速度调整倒透明度opacity，然后执行函数callback。Opacity为最终显示的透明度(0-1).
<a href="#" onClick='$("img ").fadeTo("slow",0.55,function(){ alert("Animation Done."); })'> jQuery </a>
大家可以看一下自己看看效果，如果不用jQuery，编写原始javascript脚本可能很多代码！
slideDown(speeds) 将匹配对象的高度由0以指定速率平滑的变化到正常！
<a href="#" onClick='$("img ").slideDown("slow")'>jQuery</a>
slideDown(speeds,callback) 将匹配对象的高度由0变化到正常！变化结束后执行函数callback
slideUp("slow") slideUp(speed, callback) 匹配对象的高度由正常变化到0
slideToggle("slow") 如果匹配对象的高度正常则逐渐变化到0，若为0，则逐渐变化到正常
六：事件处理
hover(Function, Function) 当鼠标move over时触发第一个function，当鼠标move out时触发第二个function
样式：<style>.red{color:#FF0000}</style>
Html代码： <div id="a">sdf</div>
jQuery代码及效果
$( " #a " ).hover( function (){$( this ).addClass( " red " );},
function (){ $( this ).removeClass( " red " );
});
})
最终效果是当鼠标移到id为a的层上时图层增加一个red样式，离开层时移出red样式
toggle(Function, Function) 当匹配元素第一次被点击时触发第一个函数，当第二次被点击时触发第二个函数
样式：<style>.red{color:#FF0000}</style>
Html代码： <div id="a">sdf</div>
jQuery代码及效果
$( " #a " ). toggle ( function (){$( this ).addClass( " red " );},
function (){ $( this ).removeClass( " red " );
});
})
最终效果是当鼠标点击id为a的层上时图层增加一个red样式，离开层时移出red样式
bind(type, fn) 用户将一个事件和触发事件的方式绑定到匹配对象上。
trigger(type) 用户触发type形式的事件。$("p").trigger("click")
还有：unbind() unbind(type) unbind(type, fn)
Dynamic event(Function) 绑定和取消绑定提供函数的简捷方式
例：
$( this ).addClass( " red " );
})
也可以这样写：
$( this ).addClass( " red " );
});
最终效果是当鼠标点击id为a的层上时图层增加一个red样式，
jQuery提供的函数
用于browers事件
error(fn) load(fn) unload(fn) resize(fn) scroll(fn)
用于form事件
change(fn) select(fn) submit(fn)
用于keyboard事件
keydown(fn) keypress(fn) keyup(fn)
用于mouse事件
click(fn) dblclick(fn) mousedown(fn) mousemove(fn)
mouseout(fn) mouseover(fn) mouseup(fn)
用于UI事件
blur(fn) focus(fn)
以上事件的扩展再扩展为5类
举例，click(fn) 扩展 click() unclick() oneclick(fn) unclick(fn)
click(fn)：增加一个点击时触发某函数的事件
click()：可以在其他事件中执行匹配对象的click事件。
unclick ()：不执行匹配对象的click事件。
oneclick(fn)：只增加可以执行一次的click事件。
unclick (fn)：增加一个点击时不触发某函数的事件。
上面列举的用于browers、form、keyboard、mouse、UI的事件都可以按以上方法扩展。
七：Ajax支持
通用方式：
$.ajax(prop) 通过一个ajax请求，回去远程数据，prop是一个hash表，它可以传递的key/value有以下几种。
(String)type：数据传递方式(get或post)。
((String)url：数据请求页面的url
((String)data：传递数据的参数字符串，只适合post方式
((String)dataType：期待数据返回的数据格式(例如 "xml", "html", "script",或 "json")
((Boolean)ifModified： 当最后一次请求的相应有变化是才成功返回，默认值是false
((Number)timeout:设置时间延迟请求的时间。可以参考$.ajaxTimeout
((Boolean)global：是否为当前请求触发ajax全局事件，默认为true
((Function)error：当请求失败时触发的函数。
((Function)success：当请求成功时触发函数
((Function)complete：当请求完成后出发函数
jQuery代码及说明
success: function (msg){
$(div " #a " ).html(msg);
}
});
将ajax.htm返回的内容作为id为a的div内容
type: " get " ,
dataType: " html " ,
data: " name=John&location=Boston " ,
success: function (msg){
$( " #a " ).html(msg);
}
});
用get方式向ajax.aspx页面传参数，并将返回内容负给id为a的对象。
$.ajaxTimeout(time) 设置请求结束时间
$.ajaxTimeout( 5000 )
其它简化方式：
$.get(url, params, callback) 用get方式向远程页面传递参数，请求完成后处理函数，除了url外，其它参数任意选择！
{ name: " young " , age: " 25 " },
function (data){ alert( " Data Loaded: " + data); }
)
$.getIfModified(url, params, callback) 用get方式向远程页面传递参数，从最后一次请求后如果数据有变化才作出响应，执行函数callback
$.getJSON(url, params, callback) 用get方式向远程json对象传递参数，请求完成后处理函数callback。
$.getScript(url, callback) 用get方式载入并运行一个远程javascript文件。请求完成后处理函数callback。
$.post(url, params, callback) 用post方式向远程页面传递参数，请求完成后处理函数callback
load(url, params, callback) 载入一个远程文件并载入页面DOM中，并执行函数callback
向ajax.htm页面发出请求，将返回结果装入id为a的内容中，然后再执行函数callback。
loadIfModified(url, params, callback) 用get方式向远程页面传递参数，从最后一次请求后如果数据有变化才作出响应，将返回结果载入页面DOM中，并执行函数callback
ajaxStart(callback) 当ajax请求发生错误是时执行函数callback
ajaxComplete(callback) 当ajax请求完成时执行函数callback
ajaxError(callback) 当ajax请求发生错误时执行函数callback
ajaxStop(callback) 当ajax请求停止时执行函数callback
ajaxSuccess(callback) 当ajax请求成功时执行函数callback
八：jQuery插件
随着jQuery的广泛使用，已经出现了大量jQuery插件，如thickbox，iFX，jQuery-googleMap等，简单的引用这些源文件就可以方便的使用这些插件。这里我简单的介绍一些网址供大家参考，这些网站头提供了大量的demo，并且使用及其简单，及时E文不好，也能快速掌握！
http://jquery.com/plugins 官方推荐
http://interface.eyecon.ro/demos 效果超级棒，使用更简单，一定有你喜欢的！
http://www.dyve.net/jquery/
http://bassistance.de/jquery-plugins
还有其它很多插件，大家可以google以下，如果大家发现好的了，可以留言共享以下！
——————————————————————————————————————————————
至此jQuery已经介绍完毕，并合并整理提供给大家 下载 ，更多详细的使用请大家参考官方网站，下面我再推荐一些jQuery的学习网站方便大家更好的掌握这项工具！
http://keel.sike.googlepages.com/jQuery_getting_started.html 中文入门介绍，Keel翻译
http://jquery.com/api jquery提供全部基本方法的介绍及demo，方便大家查询！
561
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
