翻译整理的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"()的元素.

我将从以下几个内容来讲解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 >  
    < 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 >
< 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 >
< 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 >
< 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" />
< 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 >
< 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 >
< 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 >
< 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" />
< href ="#"  id ="test"  onClick ="jq()" > jQuery a >
jQuery代码及功能:
function  jq(){
    alert($(
" img " ).length);
}
运行:当点击id为test的元素时,弹出alert对话框显示2,表示找到两个匹配对象
 


                                                   二:DOM操作
属性
我们以为例,在原始的javascript里面可以用var o=document.getElementById('a')取的id为a的节点对象,在用o.src来取得或修改该节点的scr属性,在jQuery里$("#a")将得到jQuery对象[ ],然后可以用jQuery提供的很多方法来进行操作,如$("#a").scr()将得到5.jpg,$("#a").scr("1.jpg")将该对象src属性改为1,jpg。下面我们来讲jQuery提供的众多jQuery方法,方便大家快速对DOM对象进行操作
herf()   herf(val)
说明:对jQuery对象属性herf的操作。
例子:
未执行jQuery前
< 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.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
< href ="#"  id ="test"  onClick ="jq()" > jQuery a >
jQuery代码及功能:
function  jq(){  
       $(
" #test " ).after( " Hello " );  
}
执行后相当于:
< href ="#"  id ="test"  onClick ="jq()" > jQuery a >< b > Hello b >

after(elem)  after(elems)  将指定对象elem或对象组elems插入到在匹配元素后
< id ="test" > after p >< href ="#"  onClick ="jq()" > jQuery a >
jQuery代码及功能
function  jq(){  
     $(
" a " ).after($( " #test " ));  
}
执行后相当于
< href ="#"  onClick ="jq()" > jQuery a >< id ="test" > after p >

append(html)在匹配元素内部,且末尾插入指定html
< href ="#"  id ="test"  onClick ="jq()" > jQuery a >
jQuery代码及功能:
function jq(){ 
     $("#test").append("
< b > Hello b > ");  
}
执行后相当于
< href ="#"  onClick ="jq()" > jQuery < b > Hello b > a >
同理还有append(elem)  append(elems) before(html) before(elem) before(elems)请执行参照append和after的方来测试、理解!

appendTo(expr)  与append(elem)相反
< id ="test" > after p >< href ="#"  onClick ="jq()" > jQuery a >
jQuery代码及功能
function  jq(){  
      $(
" a " ). appendTo ($( " #test " ));  
}
执行后相当于
< id ="test" > after < href ="#"  onClick ="jq()" > jQuery a >   p >

clone() 复制一个jQuery对象
< id ="test" > after p >< href ="#"  onClick ="jq()" > jQuery a >
jQuery代码及功能:
function  jq(){  
     $(
" #test " ).clone().appendTo($( " a " ));  
}
复制$("#test")然后插入到后,执行后相当于
< id ="test" > after p >< href ="#"  onClick ="jq()" > jQuery a >< id ="test" > after p >

empty() 删除匹配对象的所有子节点
< div  id ="test" >
  
< span > span span >
  
< p > after p >
div >
< href ="#"  onClick ="jq()" > jQuery a >
jQuery代码及功能:
function  jq(){  
    $(
" #test " ).empty();  
}
执行后相当于
< div  id ="test" > div >< 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)
< id ="a" > p p >
< div > div div >
执行$("#a").append($("div")) 后相当于
< id ="a" >

  
< div > div div >
p >
执行$("#a").appendTo($("div")) 后 相当于
< div >
   div
   
< id ="a" > p p >
div >
执行$("#a").prepend ($("div")) 后 相当于
< id ="a" >
   
< div > div div >

p >

remove()  删除匹配对象
注意区分empty(),empty()移出匹配对象的子节点,remove(),移出匹配对象

wrap(htm) 将匹配对象包含在给出的html代码内
< p > Test Paragraph. p >   < href ="#"  onClick ="jq()" > jQuery a >
jQuery代码及功能:
function  jq(){  
      $(
" p " ).wrap( "
" ); 
}
执行后相当于
< div  class ='wrap' >< p > Test Paragraph. p > div >

wrap(elem) 将匹配对象包含在给出的对象内
< p > Test Paragraph. p >< div  id ="content" > div >
< href ="#"  onClick ="jq()" > jQuery a >
jQuery代码及功能:
function  jq(){  
      $(
"p"
).wrap( document.getElementById('content') );
}
执行后相当于
<div id="content"><p>Test Paragraph.p>div>

遍历、组合
add(expr)  在原对象的基础上在附加符合指定表达式的jquery对象
< p > Hello p >< p >< span > Hello Again span > p >
<href="#" onClick="jq()">jQuerya>
jQuery代码及功能:
function  jq(){
     
var  f = $( " p " ).add( " span " );    
     
for ( var  i = 0 ;i  <  $(f).size();i ++ ){
     alert($(f).eq(i).html());}
}
执行$("p")得到匹配

的对象,有两个,add("span")是在("p")的基础上加上匹配的对象,所有一共有3个,从上面的函数运行结果可以看到$("p").add("span")是3个对象的集合,分别是[

Hello

],[

Hello Again

],[Hello Again]。

add(el)  在匹配对象的基础上在附加指定的dom元素。
        $("p").add(document.getElementById("a"));

add(els)  在匹配对象的基础上在附加指定的一组对象,els是一个数组
< p > Hello p >< p >< span > Hello Again span > p >
jQuery代码及功能:
function  jq(){
     
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 ()  一依次以匹配结点的父节点的内容为对象,根节点除外(有点不好理解,看看下面例子就明白了)
< div >
    
< p > one p >
    
< span >
    
< u > two u >
    
span >
div >
jQuery代码及功能:
function  jq(){
     
var  f =  $( " u " ).ancestors();
     
for ( var  i = 0 ;i  <  $(f).size();i ++ ){
      alert($(f).eq(i).html());}
}
第一个对象是以的父节点的内容为对象,[ two ]
第一个对象是以的父节点的父节点(div)的内容为对象,[

one

two ]
一般一个文档还有和,依次类推下去。

ancestors (expr)  在ancestors()的基础上之取符合表达式的对象
如上各例子讲var f改为var f= $("u").ancestors(“div”),则只返回一个对象:
[

one

two  ]

children()  返回匹配对象的子介点
< p > one p >
< div  id ="ch" >    
     
< span > two span >
div >
jQuery代码及功能:
function  jq(){
    alert($(
" #ch " ).children().html());
}
$("#ch").children()得到对象[ two ].所以.html()的结果是”two”

children(expr)  返回匹配对象的子介点中符合表达式的节点
< div  id ="ch" >    
      
< span > two span >
      
< span  id ="sp" > three span >
div >
jQuery代码及功能
function  jq(){
    alert($(
" #ch " ).children(“#sp”).html());
}
$("#ch").children()得到对象[twothree ].
$("#ch").children(“#sp”)过滤得到[three ]

parent ()  parent (expr)取匹配对象父节点的。参照children帮助理解

contains(str)  返回匹配对象中包含字符串str的对象
< p > This is just a test. p >< p > So is this p >
jQuery代码及功能:
function  jq(){
    alert($(
" p " ).contains( " test " ).html());
}
$("p")得到两个对象,而包含字符串”test”只有一个。所有$("p").contains("test")返回 [

This is just a test.

]

end() 结束操作,返回到匹配元素清单上操作前的状态.

filter(expr)   filter(exprs)   过滤现实匹配符合表达式的对象 exprs为数组,注意添加“[ ]”
< p > Hello p >< p > Hello Again p >< class ="selected" > And Again p >
jQuery代码及功能:
function  jq(){
    alert($(
" p " ).filter( " .selected " ).html())
}
$("p")得到三个对象,$("p").contains("test")只返回class为selected的对象。

find(expr)  在匹配的对象中继续查找符合表达式的对象
< p > Hello p >< id ="a" > Hello Again p >< class ="selected" > And Again p >
Query代码及功能:
function  jq(){
    alert($(
" p " ).find( " #a " ).html())
}
在$("p")对象中查找id为a的对象。

is(expr)  判断对象是否符合表达式,返回boolen值
< p > Hello p >< id ="a" > Hello Again p >< class ="selected" > And Again p >
Query代码及功能:
function  jq(){
    alert($(
" #a " ).is( " p " ));
}
在$("#a ")是否符合jquery表达式。
大家可以用$("#a").is("div");  ("#a").is("#a")多来测试一下

next()  next(expr)  返回匹配对象剩余的兄弟节点
< p > Hello p >< id ="a" > Hello Again p >< class ="selected" > And Again p >
jQuery代码及功能
function  jq(){
        alert($(
" p " ).next().html());
        alert($(
" p " ).next( " .selected " ).html());
}
$("p").next()返回 [

Hello Again

,

And Again

]两个对象
$("p").next(".selected)只返回 [

And Again

]一个对象

prev ()  prev (expr)  参照next理解

not(el)  not(expr)  从jQuery对象中移出匹配的对象,el为dom元素,expr为jQuery表达式。
< p > one p >< id ="a" > two p >
< href ="#"  onclick ="js()" > jQuery a >
jQuery代码及功能:
function  js(){
     alert($(
" p " ).not(document.getElementById( " a " )).html());
     alert($(
" p " ).not(“#a”).html());
}
$("p")由两个对象,排除后的对象为[

one

]

siblings ()  siblings (expr)  jquery匹配对象中其它兄弟级别的对象
< p > one p >
< div >
  
< id ="a" > two p >
div >
< href ="#"  onclick ="js()" > jQuery a >
jQuery代码及功能:
function  js(){
       alert($(
" div " ).siblings().eq( 1 ).html());
}
$("div").siblings()的结果实返回两个对象[

one

jQuery ]
alert($("div").siblings(“a”)返回一个对象[jQuery ]

其他
addClass(class)   为匹配对象添加一个class样式
removeClass (class)   将第一个匹配对象的某个class样式移出

attr (name)   获取第一个匹配对象的属性
< img  src ="test.jpg" />< href ="#"  onclick ="js()" > jQuery a >  
jQuery代码及功能:
function  js(){
     alert($(
" img " ).attr( " src " ));
}
返回test.jpg

attr (prop)   为第一个匹配对象的设置属性,prop为hash对象,用于为某对象批量添加众多属性
< img />< href ="#"  onclick ="js()" > jQuery a >
jQuery代码及功能:
function  js(){
     $(
" img " ).attr({ src:  " test.jpg " , alt:  " Test Image "  }); 
}
运行结果相当于Test Image

attr (key,value)   为第一个匹配对象的设置属性,key为属性名,value为属性值
< img />< a href = " # "  onclick = " js() " > jQuery a >
jQuery代码及功能
function  js(){
     $(
" img " ).attr(“src”,”test.jpg”); 
}
运行结果相当于

removeAttr (name)   将第一个匹配对象的某个属性移出
< img  alt ="test" />< href ="#"  onclick ="js()" > jQuery a >
jQuery代码及功能:
function  js(){
     $(
" img " ). removeAttr( " alt " ); 
}
运行结果相当于

toggleClass (class)   将当前对象添加一个样式,不是当前对象则移出此样式,返回的是处理后的对象
< p > Hello p >< class ="selected" > Hello Again p >< href ="#"  onclick ="js()" > jQuery a >
$("p")的结果是返回对象 [

Hello

,

Hello Again

]
$("p").toggleClass("selected")的结果是实返回对象 [

Hello

,

Hello Again

]
 

         :CSS操作

      传统javascript对css的操作相当繁琐,比如
css
取它的background语法是 document.getElementById("a").style.background,而jQuery对css更方便的操作,$("#a").background(),$("#a").background(“red”)
$("#a")得到jQuery对象[
]
$("#a").background()将取出该对象的background样式。
$("#a").background(“red”)将该对象的background样式设为redjQuery提供了以下方法,来操作css
background ()   background (val)     color()    color(val)     css(name)    css(prop)   
css(key, value)      float()   float(val)   height()   height(val)  width()  width(val) 
left()   left(val)       overflow()   overflow(val)   position()   position(val)  top()   top(val)


这里需要讲解一下css(name)  css(prop)  css(key, value),其他的看名字都知道什么作用了!
< div  id ="a"  style ="background:blue; color:red" > css div >< id ="b" > test P >

css(name)  获取样式名为name的样式
$("#a").css("color") 将得到样式中color值red,("#a").css("background ")将得到blue

css(prop)  prop是一个hash对象,用于设置大量的css样式
$("#b").css({ color: "red", background: "blue" });
最终效果是

test

,{ color: "red", background: "blue" },hash对象,color为key,"red"为value,

css(key, value)  用于设置一个单独得css样式
$("#b").css("color","red");最终效果是

test



                                              :JavaScript处理

$.browser()  判断浏览器类型,返回boolen值
$( function (){
    
if ($.browser.msie) {
        alert(
" 这是一个IE浏览器 " );}
    
else   if ($.browser.opera) {
        alert(
" 这是一个opera浏览器 " );}
})
当页面载入式判断浏览器类型,可判断的类型有msie、mozilla、opera、safari

$.each(obj, fn)  obj为对象或数组,fn为在obj上依次执行的函数,注意区分$().each()
$.each( [ 0 , 1 , 2 ],  function (i){ alert(  " Item # "   +  i  +   " "   +   this  ); });
    分别将0,1,2为参数,传入到function(i)中
$.each({ name:  " John " , lang:  " JS "  },   function (i){ alert(  " Name:  "   +  i  +   " , Value:  "   +   this  );
    { name: "John", lang: "JS" }为一个hash对象,依次将hash中每组对象传入到函数中

$.extend(obj, prop)  用第二个对象扩展第一个对象
var  settings  =  { validate:  false , limit:  5 , name:  " foo "  };
var  options  =  { validate:  true , name:  " bar "  };
$.extend(settings, options);
执行后settings对象为{ validate: true, limit: 5, name: "bar" }
可以用下面函数来测试
$( function (){
       
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,将被过滤
$( function (){
        
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)  两个参数都是数组,排出第二个数组中与第一个相同的,再将两个数组合并
$( function (){ 
        
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()  隐藏匹配对象
< id ="a" > Hello Again p >< href ="#"  onClick ='  ("#a").hide()' > jQuery a >
当点击连接时,id为a的对象的display变为none。

show() 显示匹配对象

hide(speed)  以一定的速度隐藏匹配对象,其大小(长宽)和透明度都逐渐变化到0,speed有3级("slow", "normal",  "fast"),也可以是自定义的速度。

show(speed)  以一定的速度显示匹配对象,其大小(长宽)和透明度都由0逐渐变化到正常

hide(speed, callback)  show(speed, callback) 当显示和隐藏变化结束后执行函数callback

toggle()    toggle(speed) 如果当前匹配对象隐藏,则显示他们,如果当前是显示的,就隐藏,toggle(speed),其大小(长宽)和透明度都随之逐渐变化。
<img src="1.jpg" style="width:150px"/>
<href="#" onClick='$("img").toggle("slow")'>jQuerya>

fadeIn(speeds)   fadeOut(speeds)  根据速度调整透明度来显示或隐藏匹配对象,注意有别于hide(speed)和show(speed),fadeIn和fadeOut都只调整透明度,不调整大小
<img src="1.jpg" style="display:none"/><href="#" onClick='$("img ").fadeIn("slow")'> jQuery a>
点击连接后可以看到图片逐渐显示。

fadeIn(speed, callback)  fadeOut(speed, callback)   callback为函数,先通过调整透明度来显示或隐藏匹配对象,当调整结束后执行callback函数
<img src="1.jpg"/>
<href="#" onClick='$("img ").fadeIn("slow",function(){ alert("Animation Done."); })'> jQuery a>
点击连接后可以看到图片逐渐显示,显示完全后弹出对话框

fadeTo(speed, opacity, callback)  将匹配对象以speed速度调整倒透明度opacity,然后执行函数callback。Opacity为最终显示的透明度(0-1).
<img src="1.jpg"/><br>
<href="#" onClick='$("img ").fadeTo("slow",0.55,function(){ alert("Animation Done."); })'> jQuery a>
大家可以看一下自己看看效果,如果不用jQuery,编写原始javascript脚本可能很多代码!

slideDown(speeds)  将匹配对象的高度由0以指定速率平滑的变化到正常!
<img src="1.jpg" style="display:none"/>
<href="#" onClick='$("img ").slideDown("slow")'>jQuerya>

slideDown(speeds,callback)  将匹配对象的高度由0变化到正常!变化结束后执行函数callback

slideUp("slow")  slideUp(speed, callback) 匹配对象的高度由正常变化到0

slideToggle("slow") 如果匹配对象的高度正常则逐渐变化到0,若为0,则逐渐变化到正常 


 :事件处理

 hover(Function, Function)    当鼠标move over时触发第一个function,当鼠标move out时触发第二个function
样式:
Html代码:
sdf

jQuery代码及效果
$( function (){
  $(
" #a " ).hover( function (){$( this ).addClass( " red " );},
                           
function (){ $( this ).removeClass( " red " ); 
                          });
})
最终效果是当鼠标移到id为a的层上时图层增加一个red样式,离开层时移出red样式

toggle(Function, Function)    当匹配元素第一次被点击时触发第一个函数,当第二次被点击时触发第二个函数
样式:
Html代码:
sdf

jQuery代码及效果
$( function (){
  $(
" #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)    绑定和取消绑定提供函数的简捷方式
例:
$( " #a " ).bind( " click " , function () { 
                                       $(
this ).addClass( " red " );
})
也可以这样写:
$( " #a " ).click( function () { 
                        $(
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代码及说明

$.ajax({url:  " ajax.htm " ,
          success:
function (msg){ 
                         $(div
" #a " ).html(msg);
                } 
    });
将ajax.htm返回的内容作为id为a的div内容
$.ajax({ url:  " ajax.aspx " ,
              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外,其它参数任意选择

$.get(  " ajax.htm "  ,  function (data){ $( " #a " ).html(data)  })
$.get(   " ajax.asp "
            { 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
$( " #a " ).load( " ajax.htm " function () { alert( " load is done " ); } );
仰天一笑 徐羽 向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,方便大家查询!

你可能感兴趣的:(翻译整理的jQuery使用查询手册)