JQuery 使用手册 (转)
from : http://carrot.javaeye.com/blog/215536
jQuery是一款同prototype一样优秀js开发库类，特别是对css和XPath的支持，使我们写js变得更加方便！如果你不是个js高手又想写出优 秀的js效果，jQuery可以帮你达到目的！
下载地址：Starterkit （ http://jquery.bassistance.de/jquery-starterkit.zip ）
jQuery Downloads （ http://jquery.com/src/ ）
下载完成后先加载到文档中，然后我们来看个简单的例子！
<
script language
=
"
javascript
"
type
=
"
text/javascript
"
>
$(document).ready( function (){
$( " a " ).click( function () {
alert( " Hello world! " );
});
});
< script >
$(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代码及功能：
function
jq(){
alert($( " div > p " ).html());
}
alert($( " div > p " ).html());
}
运行：当点击id为test的元素时，弹出对话框文字为two，即div标签下p元素的内容
function
jq(){
$( " <div><p>Hello</p></div> " ).appendTo( " body " );
}
$( " <div><p>Hello</p></div> " ).appendTo( " body " );
}
运行：当点击id为test的元素时，向body中添加“<div><p>Hello</p></div>”
$(elem)
说明：限制jQuery作用于一个特定的dom元素，这个函数也接受xml文档和windows对象
参数： elem：通过jQuery对象压缩的DOM元素
例子：
未执行jQuery前：
<
p
>
one
</
p
>
< div >
< p > two </ p >
</ div >< p > three </ p >
< a href ="#" id ="test" onClick ="jq()" > jQuery </ a >
< div >
< p > two </ p >
</ div >< p > three </ p >
< a href ="#" id ="test" onClick ="jq()" > jQuery </ a >
jQuery代码及功能：
function
jq(){
alert($(document).find( " div > p " ).html());
}
alert($(document).find( " div > p " ).html());
}
运行：当点击id为test的元素时，弹出对话框文字为two，即div标签下p元素的内容
function
jq(){
$(document.body).background( " black " );
}
$(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代码及功能：
function
jq(){
$(form1.elements ).hide();
}
$(form1.elements ).hide();
}
运行：当点击id为test的元素时，隐藏form1表单中的所有元素。
$(fn)
说明：$(document).ready()的一个速记方式，当文档全部载入时执行函数。可以有多个$(fn)当文档载入时，同时执行所有函数！
参数：fn (Function):当文档载入时执行的函数！
例子：
$(
function
(){
$(document.body).background( " black " );
})
$(document.body).background( " black " );
})
运行：当文档载入时背景变成黑色，相当于onLoad。
$(obj)
说明：复制一个jQuery对象，
参数：obj (jQuery): 要复制的jQuery对象
例子：
未执行jQuery前：
<
p
>
one
</
p
>
< div >
< p > two </ p >
</ div >
< p > three </ p >
< a href ="#" id ="test" onClick ="jq()" > jQuery </ a >
jQuery代码及功能：
< div >
< p > two </ p >
</ div >
< p > three </ p >
< a href ="#" id ="test" onClick ="jq()" > jQuery </ a >
function
jq(){
var f = $( " div " );
alert($(f).find( " p " ).html())
}
运行：当点击id为test的元素时，弹出对话框文字为two，即div标签下p元素的内容。
var f = $( " div " );
alert($(f).find( " p " ).html())
}
each(fn)
说明：将函数作用于所有匹配的对象上
参数：fn (Function): 需要执行的函数
例子：
未执行jQuery前：
<
img
src
="1.jpg"
/>
< img src ="1.jpg" />
< a href ="#" id ="test" onClick ="jq()" > jQuery </ a >
jQuery代码及功能：
< img src ="1.jpg" />
< a href ="#" id ="test" onClick ="jq()" > jQuery </ a >
function
jq(){
$( " img " ).each( function (){
this .src = " 2.jpg " ; });
}
运行：当点击id为test的元素时，img标签的src都变成了2.jpg。$( " img " ).each( function (){
this .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
>
function
jq(){
alert($( " p " ).eq( 1 ).html())
}
运行：当点击id为test的元素时，alert对话框显示：So is this，即第二个<p>标签的内容alert($( " p " ).eq( 1 ).html())
}
get() get(num)
说明：获取匹配元素，get(num)返回匹配元素中的某一个元素
参数：get (Number): 期望限制的索引，从0 开始
例子：
未执行jQuery前：
<
p
>
This is just a test.
</
p
>
< p > So is this </ p >
< a href ="#" id ="test" onClick ="jq()" > jQuery </ a >
jQuery代码及功能：
< p > So is this </ p >
< a href ="#" id ="test" onClick ="jq()" > jQuery </ a >
function
jq(){
alert($( " p " ).get( 1 ).innerHTML);
}
运行：当点击id为test的元素时，alert对话框显示：So is this，即第二个<p>标签的内容alert($( " p " ).get( 1 ).innerHTML);
}
注意get和eq的区别，eq返回的是jQuery对象，get返回的是所匹配的dom对象，所有取$("p").eq(1)对象的内容用jQuery方法html()，而取$("p").get(1)的内容用innerHTML
index(obj)
说明：返回对象索引
参数：obj (Object): 要查找的对象
例子：
未执行jQuery前：
<
div
id
="test1"
></
div
>
< div id ="test2" ></ div >
< a href ="#" id ="test" onClick ="jq()" > jQuery </ a >
jQuery代码及功能：
< div id ="test2" ></ div >
< a href ="#" id ="test" onClick ="jq()" > jQuery </ a >
function
jq(){
alert($( " div " ).index(document.getElementById('test1')));
alert($( " div " ).index(document.getElementById('test2')));
}
运行：当点击id为test的元素时，两次弹出alert对话框分别显示0，1alert($( " div " ).index(document.getElementById('test1')));
alert($( " div " ).index(document.getElementById('test2')));
}
size() Length
说明：当前匹配对象的数量，两者等价
例子：
未执行jQuery前：
<
img
src
="test1.jpg"
/>
< img src ="test2.jpg" />
< a href ="#" id ="test" onClick ="jq()" > jQuery </ a >
jQuery代码及功能：
< img src ="test2.jpg" />
< a href ="#" id ="test" onClick ="jq()" > jQuery </ a >
function
jq(){
alert($( " img " ).length);
}
运行：当点击id为test的元素时，弹出alert对话框显示2，表示找到两个匹配对象
alert($( " img " ).length);
}
二：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前
<
a
href
="1.htm"
id
="test"
onClick
="jq()"
>
jQuery
</
a
>
jQuery代码及功能：
function
jq(){
alert($( " #test " ).href());
$( " #test " ).href( " 2.html " );
}
运行：先弹出对话框显示id为test的连接url，在将其url改为2.html，当弹出对话框后会看到转向到2.htmlalert($( " #test " ).href());
$( " #test " ).href( " 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
<
a
href
="#"
id
="test"
onClick
="jq()"
>
jQuery
</
a
>
jQuery代码及功能：
function
jq(){
$( " #test " ).after( " <b>Hello</b> " );
}
执行后相当于：
$( " #test " ).after( " <b>Hello</b> " );
}
<
a
href
="#"
id
="test"
onClick
="jq()"
>
jQuery
</
a
><
b
>
Hello
</
b
>
after(elem) after(elems) 将指定对象elem或对象组elems插入到在匹配元素后
<
p
id
="test"
>
after
</
p
><
a
href
="#"
onClick
="jq()"
>
jQuery
</
a
>
function
jq(){
$( " a " ).after($( " #test " ));
}
执行后相当于
$( " a " ).after($( " #test " ));
}
<
a
href
="#"
onClick
="jq()"
>
jQuery
</
a
><
p
id
="test"
>
after
</
p
>
append(html)在匹配元素内部，且末尾插入指定html
<
a
href
="#"
id
="test"
onClick
="jq()"
>
jQuery
</
a
>
jQuery代码及功能：
function jq(){
$("#test").append("<b>Hello</b> ");
}
执行后相当于
$("#test").append("<b>Hello</b> ");
}
<a href="#" onClick="jq()">jQuery<b>Hello</b></a>
同理还有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
>
function
jq(){
$( " a " ). appendTo ($( " #test " ));
}
执行后相当于
$( " a " ). appendTo ($( " #test " ));
}
<
p
id
="test"
>
after
<
a
href
="#"
onClick
="jq()"
>
jQuery
</
a
>
</
p
>
clone() 复制一个jQuery对象
<
p
id
="test"
>
after
</
p
><
a
href
="#"
onClick
="jq()"
>
jQuery
</
a
>
jQuery代码及功能：
function
jq(){
$( " #test " ).clone().appendTo($( " a " ));
}
复制$("#test")然后插入到<a>后,执行后相当于
$( " #test " ).clone().appendTo($( " a " ));
}
<
p
id
="test"
>
after
</
p
><
a
href
="#"
onClick
="jq()"
>
jQuery
</
a
><
p
id
="test"
>
after
</
p
>
empty() 删除匹配对象的所有子节点
<
div
id
="test"
>
<
span
>
span
</
span
>
<
p
>
after
</
p
>
</
div
>
<
a
href
="#"
onClick
="jq()"
>
jQuery
</
a
>
function
jq(){
$( " #test " ).empty();
}
执行后相当于
$( " #test " ).empty();
}
<
div
id
="test"
></
div
><
a
href
="#"
onClick
="jq()"
>
jQuery
</
a
>
insertAfter(expr) insertBefore(expr)
按照官方的解释和我的几个简单测试insertAfter(expr)相当于before(elem),insertBefore(expr)相当于after (elem)
prepend (html) prepend (elem) prepend (elems) 在匹配元素的内部且开始出插入
通过下面例子区分append(elem) appendTo(expr) prepend (elem)
<
p
id
="a"
>
p
</
p
>
< div > div </ div >
执行$("#a").append($("div")) 后相当于
< div > div </ div >
<
p
id
="a"
>
P
< div > div </ div >
</ p >
执行$("#a").appendTo($("div")) 后 相当于
P
< div > div </ div >
</ p >
<
div
>
div
< p id ="a" > p </ p >
</ div >
执行$("#a").prepend ($("div")) 后 相当于
div
< p id ="a" > p </ p >
</ div >
<
p
id
="a"
>
< div > div </ div >
P
</ p >
< div > div </ div >
P
</ p >
remove() 删除匹配对象
注意区分empty()，empty()移出匹配对象的子节点，remove()，移出匹配对象
wrap(htm) 将匹配对象包含在给出的html代码内
<
p
>
Test Paragraph.
</
p
>
<
a
href
="#"
onClick
="jq()"
>
jQuery
</
a
>
jQuery代码及功能：
function
jq(){
$( " p " ).wrap( " <div class='wrap'></div> " );
}
执行后相当于
$( " p " ).wrap( " <div class='wrap'></div> " );
}
<
div
class
='wrap'
><
p
>
Test Paragraph.
</
p
></
div
>
wrap(elem) 将匹配对象包含在给出的对象内
<
p
>
Test Paragraph.
</
p
><
div
id
="content"
></
div
>
< a href ="#" onClick ="jq()" > jQuery </ a >
< a href ="#" onClick ="jq()" > jQuery </ a >
轻量级啊,比 prototype,ext 轻量多了.