JQUERY使用手册.doc
翻译整理：Young.J 官方网站： jQuery是一款同prototype一样优秀js开发库类，特别是对css和 XPath的支持，使我们写js变得更加方便！如果你不是个js高手又想写出优 秀的js效果，jQuery可以帮你达到目的！ 下载地址：Starterkit （http:/jquery.bassistance.de/jquery-starterkit.zip） jQuery Downloads （ 下载完成后先加载到文档中，然后我们来看个简单的例子！<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></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(); 运行：当点击id为test的元素时，弹出对话框文字为two，即div标签下p元素的 内容 function jq() $("<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>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前： 运行：当点击id为test的元素时，隐藏form1表单中的所有元素。<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(); $(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，即第二个<p>标签的内容 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，即第二个<p>标签的内容 注意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，表示找到两个 匹配对象 二：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.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 jQuery代码及功能： <a href="#" id="test" onClick="jq()">jQuery</a>function jq() $("#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>jQuery代码及功能 function jq() $("a").after($("#test"); 执行后相当于 <a href="#" onClick="jq()">jQuery</a><p id="test">after</p>append(html)在匹配元素内部，且末尾插入指定html jQuery代码及功能： function jq() $("#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>jQuery代码及功能 function jq() $("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>后,执行后相当于 <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>jQuery代码及功能： function jq() $("#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") 后相当于 <p id="a"> P <div>div</div> </p>执行$("#a").appendTo($("div") 后 相当于 <div> div <p id="a">p</p> </div>执行$("#a").prepend ($("div") 后 相当于 <p id="a"> <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>"); 执行后相当于 <div class='wrap'><p>Test Paragraph.</p></div>wrap(elem) 将匹配对象包含在给出的对象内 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> <a href="#" onClick="jq()">jQuery</a>jQuery代码及功能： function jq() 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代码及功能： 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(); 第一个对象是以<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() 返回匹配对象的子介点 <p>one</p> <div id="ch"> <span>two</span> </div>jQuery代码及功能： function jq() alert($("#ch").children().html(); $("#ch").children()得到对象 <span>two</span> .所以.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()得到对象<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代码及功能： function jq() alert($("p").contains("test").html(); $("p")得到两个对象，而包含字符串”test”只有一个。所有$("p").contains("test")返回 <p>This is just a test.</p> end() 结束操作,返回到匹配元素清单上操作前的状态. filter(expr) filter(exprs) 过滤现实匹配符合表达式的对象 exprs为数组，注意添加“ ” <p>Hello</p><p>Hello Again</p><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><p id="a">Hello Again</p><p class="selected">And Again</p>Query代码及功能： function jq() alert($("p").find("#a").html() 在$("p")对象中查找id为a的对象。 is(expr) 判断对象是否符合表达式,返回boolen值 <p>Hello</p><p id="a">Hello Again</p><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><p id="a">Hello Again</p><p class="selected">And Again</p>jQuery代码及功能 function jq() 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表达式。 <p>one</p><p id="a">two</p> <a href="#" onclick="js()">jQuery</a>jQuery代码及功能： function js() alert($("p").not(document.getElementById("a").html(); alert($("p").not(“#a”).html(); $("p")由两个对象，排除后的对象为<p>one</p> siblings () siblings (expr) jquery匹配对象中其它兄弟级别的对象 <p>one</p> <div> <p id="a">two</p> </div> <a href="#" onclick="js()">jQuery</a>jQuery代码及功能： function js() alert($("div").siblings().eq(1).html(); $("div").siblings()的结果实返回两个对象<p>one</p>，<a href="#" onclick="js()">jQuery</a> alert($("div").siblings(“a”)返回一个对象<a href="#" onclick="js()">jQuery</a> 其他 addClass(class) 为匹配对象添加一个class样式 removeClass (class) 将第一个匹配对象的某个class样式移出 attr (name) 获取第一个匹配对象的属性 <img src="test.jpg"/><a href="#" onclick="js()">jQuery</a> jQuery代码及功能： function js() alert($("img").attr("src"); 返回test.jpg attr (prop) 为第一个匹配对象的设置属性，prop为hash对象，用于为某对象批量添加众多属性 <img/><a href="#" onclick="js()">jQuery</a>jQuery代码及功能： function js() $("img").attr( src: "test.jpg", alt: "Test Image" ); 运行结果相当于<img src="test.jpg" alt="Test Image"/> attr (key,value) 为第一个匹配对象的设置属性，key为属性名，value为属性值 <img/><a href="#" onclick="js()">jQuery</a>jQuery代码及功能 function js() $("img").attr(“src”,”test.jpg”); 运行结果相当于<img src="test.jpg"/> removeAttr (name) 将第一个匹配对象的某个属性移出 <img alt="test"/><a href="#" onclick="js()">jQuery</a>jQuery代码及功能： function js() $("img"). removeAttr("alt"); 运行结果相当于<img /> toggleClass (class) 将当前对象添加一个样式，不是当前对象则移出此样式，返回的是处理后的对象 <p>Hello</p><p class="selected">Hello Again</p><a href="#" onclick="js()">jQuery</a>$("p")的结果是返回对象 <p>Hello</p>,<p class="selected">Hello Again</p> $("p").toggleClass("selected")的结果是实返回对象 <p class="selected">Hello</p>, <p>Hello Again</p> 三：CSS操作 传统javascript对css的操作相当繁琐，比如<div id="a" style="background:blue">css</div>取它的background语法是 document.getElementById("a").style.background，而jQuery对css更方便的操 作，$("#a").background()，$("#a").background(“red”) $("#a")得到jQuery对象 <div id="a" /div> $("#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)，其他的看名字都知道什么作用了！ 当点击连接时,id为a的对象的display变为none。 <div id="a" style="background:blue; color:red">css</div><P 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" ); 最终效果是<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值 $(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 = v
