jQuery使用手册

翻译整理：Young.J
官方网站： http://jquery.com

    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 >

     上边的效果是点击文档中所有a标签时将弹出对话框，$("a") 是一个jQuery选择器，$本身表示一个jQuery类，所有$()是构造一个jQuery对象，click()是这个对象的方法，同理$(document)也是一个jQuery对象，ready(fn)是$(document)的方法，表示当document全部下载完毕时执行函数。
     在进行下面内容之前我还要说明一点$("p")和$("#p")的区别,$("p")表示取所有p标签(

)的元素,$("#p")表示取id为"p"(<span  id="p">)的元素.

我将从以下几个内容来讲解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());  
}

运行：当点击id为test的元素时，弹出对话框文字为two，即div标签下p元素的内容

function  jq(){
    $( "

Hello

" ).appendTo( " body " );
}

运行：当点击id为test的元素时，向body中添加“

Hello

”

$(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>

jQuery代码及功能：

function  jq(){
    alert($(document).find( " div > p " ).html());
}

运行：当点击id为test的元素时，弹出对话框文字为two，即div标签下p元素的内容

function  jq(){
   $(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(); 
}

运行：当点击id为test的元素时，隐藏form1表单中的所有元素。

$(fn)
说明：$(document).ready()的一个速记方式，当文档全部载入时执行函数。可以有多个$(fn)当文档载入时，同时执行所有函数！
参数：fn (Function):当文档载入时执行的函数！
例子：

$(  function (){
    $(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代码及功能：

function  jq(){
     var  f  =  $( " div " ); 
    alert($(f).find( " p " ).html()) 
}

运行：当点击id为test的元素时，弹出对话框文字为two，即div标签下p元素的内容。

each(fn)
说明：将函数作用于所有匹配的对象上
参数：fn (Function): 需要执行的函数
例子：
未执行jQuery前：

< img  src ="1.jpg" />
< img  src ="1.jpg" />
< a  href ="#"  id ="test"  onClick ="jq()" > jQuery <!---->a>

jQuery代码及功能：

function  jq(){
   $( " 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代码及功能：

function  jq(){
    alert($( " p " ).eq( 1 ).html())
}

运行：当点击id为test的元素时，alert对话框显示：So is this，即第二个

标签的内容

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代码及功能：

function  jq(){
    alert($( " p " ).get( 1 ).innerHTML);
}

运行：当点击id为test的元素时，alert对话框显示：So is this，即第二个

标签的内容
注意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代码及功能：

function  jq(){
    alert($( " div " ).index(document.getElementById('test1')));
    alert($( " div " ).index(document.getElementById('test2')));
}

运行：当点击id为test的元素时，两次弹出alert对话框分别显示0，1

size()   Length
说明：当前匹配对象的数量，两者等价
例子：
未执行jQuery前：

< img  src ="test1.jpg" />
< img  src ="test2.jpg" />
< a  href ="#"  id ="test"  onClick ="jq()" > jQuery <!---->a>

jQuery代码及功能：

function  jq(){
    alert($( " img " ).length);
}

运行：当点击id为test的元素时，弹出alert对话框显示2，表示找到两个匹配对象