jQuery的基本用法

一、jQuery的基本用法:
随着WEB2.0及ajax思想在互联网上的快速发展传播，陆续出现了一些优秀的Js框架，其中比较著名的Prototype、YUI、 jQuery、mootools、Bindows以及国内的JSVM框架等，jQuery是继prototype之后的又一个优秀Javascript框架。它是由 John Resig 于 2006 年初创建的，它有助于简化 JavaScript 以及Ajax 编程。
它具有如下一些特点：
   1. 代码简练、语义易懂、学习快速、文档丰富。
   2. jQuery是一个轻量级的脚本，其代码非常小巧，最新版的JavaScript包只有20K左右。
   3. jQuery支持CSS1-CSS3,以及基本的xPath。
   4. jQuery是跨浏览器的，它支持的浏览器包括IE 6.0+, FF 1.5+, Safari 2.0+, Opera 9.0+。
   5. 可以很容易的为jQuery扩展其他功能。
   6. 能将JS代码和HTML代码完全分离，便于代码和维护和修改。
   7. 插件丰富，除了jQuery本身带有的一些特效外，可以通过插件实现更多功能，如表单验证、
tab导航、拖放效果、表格排序、DataGrid，树形菜单、图像特效以及ajax上传等。使用方法(同prototype)在需要使用JQuery的页面中引入JQuery的js文件即可。
例如：<script type="text/javascript" src="js/jquery.js"></script>
引入之后便可在页面的任意地方使用jQuery提供的语法。

二、学习教程及参考资料
请参照《jQuery中文API手册》和http://jquery.org.cn/visual/cn/index.xml 
推荐两篇不错的jquery教程：《jQuery的起点教程》和《使用 jQuery 简化 Ajax 开发》(说明：以上文档都放在了【附件】中)

三、语法总结和注意事项
1、关于页面元素的引用
通过jquery的$()引用元素包括通过id、class、元素名以及元素的层级关系及dom或者xpath条件等方法，且返回的对象为jquery对象（集合对象），不能直接调用dom定义的方法。如:

1.      $("#msg").html();-->通过ID   

2.      $("div").html(); $("input").val(); -->通过元素名(jQuery获取的是一个集合)   

3.      $("div p");             -->第一行代码得到所有<div>标签下的<p>元素。   

4.      $("div.container")      -->第二行代码得到 class为container的<div>元素      

5.      $("div #msg");          -->第三行代码得到<div>标签下面id为msg的元素。   

6.      $("table a",context);   -->第四行代码得到context为上下文的table里面所有的连接元素。    

 

2、jQuery对象与dom对象的相互转换
2.1只有jquery对象才能使用jquery定义的方法。注意dom对象和jquery对象是有区别的，普通的dom对象一般可以通过$()转换成jquery对象。
如：$(document.getElementById("msg"))则为jquery对象，可以使用jquery的方法。

2.2由于jquery对象本身是一个集合。所以如果jquery对象要转换为dom对象则必须取出其中的某一项，一般可通过索引取出。
如：$("#msg")[0]，$("div").eq(1)[0]，$("div").get()[1]，$("td")[5]这些都是dom对象，可以使用dom中的方法，但不能再使用Jquery的方法。

以下几种写法都是正确的：

1.      $("#msg").html();   

2.      $("#msg")[0].innerHTML;   

3.      $("#msg").eq(0)[0].innerHTML;   

4.      $("#msg").get(0).innerHTML;  

对于获取的元素集合，获取其中的某一项（通过索引指定）可以使用eq或get(n)方法或者索引号获取，要注意，eq返回的是jquery对象，而 get(n)和索引返回的是dom元素对象。如要获取第三个 <div>元素的内容。有如下两种方法：

1.      $("div").eq(2).html();              //调用jquery对象的方法   

2.      $("div").get(2).innerHTML;       //调用dom的方法属性  

 

3、同一函数实现set和get
Jquery中的很多方法都是如此，主要包括如下几个：

1.      $("#msg").html();              //返回id为msg的元素节点的html内容。   

2.      $("#msg").html("<b>new content</b>");         

3.      //将“<b>new content</b>” 作为html串写入id为msg的元素节点内容中,页面显示粗体的new content   

4.      $("#msg").text();              //返回id为msg的元素节点的文本内容。   

5.      $("#msg").text("<b>new content</b>");         

6.      //将“<b>new content</b>” 作为普通文本串写入id为msg的元素节点内容中,页面显示<b>new content</b>   

7.      $("#msg").height();              //返回id为msg的元素的高度   

8.      $("#msg").height("300");       //将id为msg的元素的高度设为300   

9.      $("#msg").width();              //返回id为msg的元素的宽度   

10.   $("#msg").width("300");       //将id为msg的元素的宽度设为300   

11.   $("input").val(");       //返回表单输入框的value值   

12.   $("input").val("test");       //将表单输入框的value值设为test   

13.   $("#msg").click();       //触发id为msg的元素的单击事件   

14.   $("#msg").click(fn);       //为id为msg的元素单击事件添加函数  

同样blur,focus,select,submit事件都可以有这两种调用方法

4、几个有用的jQuery方法:
0)集合处理功能
对于jquery返回的集合内容无需我们自己循环遍历并对每个对象分别做处理，jquery已经为我们提供的很方便的方法进行集合的处理。
包括两种形式：

1.      $("p").each(function(i){this.style.color=['#f00','#0f0','#00f'][i]}) 

2.      //为索引分别为0，1，2的p元素分别设定不同的字体颜色。   

3.      $("tr").each(function(i){this.style.backgroundColor=['#ccc','#fff'][i%2]})

4.      //实现表格的隔行换色效果   

5.      $("p").click(function(){alert($(this).html())})                

6.      //为每个p元素增加了click事件，单击某个p元素则弹出其内容  

1)$.browser.浏览器类型：检测浏览器类型。有效参数：safari, opera, msie, mozilla。如检测是否ie：$.browser.isie，是ie浏览器则返回true。

2)$.each(obj, fn)：通用的迭代函数。可用于近似地迭代对象和数组（代替循环）。
如

1.      $.each( [0,1,2], function(i, n){ alert( "Item #" + i + ": " + n ); });  

等价于：

1.      var tempArr=[0,1,2];   

2.      for(var i=0;i<tempArr.length;i++){   

3.             alert("Item #"+i+": "+tempArr[i]);   

4.      }  

3)也可以处理json数据，如

1.     $.each( { name: "John", lang: "JS" }, function(i, n){ alert( "Name: " + i + ", Value: "    

2.     + n ); });  

结果为：

1.     Name:name, Value:John   

2.     Name:lang, Value:JS  

4)$.map(array, fn)：数组映射。把一个数组中的项目(处理转换后)保存到到另一个新数组中，并返
回生成的新数组。
如：

1.     var tempArr=$.map( [0,1,2], function(i){ return i + 4; });   

2.     tempArr内容为：[4,5,6]   

3.     var tempArr=$.map( [0,1,2], function(i){ return i > 0 ? i + 1 : null; });   

4.     tempArr内容为：[2,3]  

5)$.merge(arr1,arr2):合并两个数组并删除其中重复的项目。
如：

1.     $.merge( [0,1,2], [2,3,4] )       //返回[0,1,2,3,4]  

6)$.trim(str)：删除字符串两端的空白字符。
如：

1.     $.trim("  hello, how are you?   ");    //返回"hello,how are you? "  

 

5、操作元素的样式
主要包括以下几种方式：

1.     $("#msg").css("background");              //返回元素的背景颜色   

2.     $("#msg").css("background","#ccc")       //设定元素背景为灰色   

3.     $("#msg").height(300); $("#msg").width("200");       //设定宽高   

4.     $("#msg").css({ color: "red", background: "blue" });//以名值对的形式设定样式   

5.     $("#msg").addClass("select");       //为元素增加名称为select的class   

6.     $("#msg").removeClass("select");       //删除元素名称为select的class   

7.     $("#msg").toggleClass("select");       //如果存在（不存在）就删除（添加）名称为select的class  

6、完善的事件处理功能
Jquery已经为我们提供了各种事件处理方法，我们无需在html元素上直接写事件，而可以直接为通过jquery获取的对象添加事件。
如：

1.     $("#msg").click(function(){alert("good")})    //为元素添加了单击事件   

2.     $("p").click(function(i){this.style.color=['#f00','#0f0','#00f'][i]})   //为三个不同的p  

元素单击事件分别设定不同的处理
jQuery中几个自定义的事件：
（1）hover(fn1,fn2)：当鼠标移动到一个匹配的元素上面时，会触发指定的第一个函数。当鼠标移出这个元素时，会触发指定的第二个函数。

1.     //当鼠标放在表格的某行上时将class置为over，离开时置为out。   

2.     $("tr").hover(function(){   

3.     $(this).addClass("over");   

4.     },   

5.            function(){   

6.            $(this).addClass("out");   

7.     });  

（2）ready(fn):当DOM载入就绪可以查询及操纵时绑定一个要执行的函数。

1.     $(document).ready(function(){alert("Load Success")})   

2.     //页面加载完毕提示“Load Success”,不同于onload事件，onload需要页面内容加载完毕（图片等   

3.     ），而ready只要页面html代码下载完毕即触发。与$(fn)等价  

（3）toggle(evenFn,oddFn): 每次点击时切换要调用的函数。如果点击了一个匹配的元素，则触发指定的第一个函数，当再次点击同一元素时，则触发指定的第二个函数。随后的每次点击都重复对这两个函数的轮番调用。

1.     //每次点击时轮换添加和删除名为selected的class。   

2.     $("p").toggle(function(){   

3.            $(this).addClass("selected");     

4.     },function(){   

5.            $(this).removeClass("selected");   

6.     });  

（4）trigger(eventtype): 在每一个匹配的元素上触发某类事件。例如：

1.     $("p").trigger("click");       //触发所有p元素的click事件  

（5）bind(eventtype,fn)，unbind(eventtype): 事件的绑定与反绑定从每一个匹配的元素中（添加）删除绑定的事件。例如：

1.     $("p").bind("click", function(){alert($(this).text());});    

2.     //为每个p元素添加单击事件   

3.     $("p").unbind();       //删除所有p元素上的所有事件   

4.     $("p").unbind("click")       //删除所有p元素上的单击事件  

7、扩展我们需要的功能

1.     $.extend({   

2.            min: function(a, b){return a < b?a:b; },   

3.            max: function(a, b){return a > b?a:b; }   

4.     });       //为jquery扩展了min,max两个方法  

使用扩展的方法（通过“$.方法名”调用）：

1.     alert("a=10,b=20,max="+$.max(10,20)+",min="+$.min(10,20));   

----------->ajax编程,请见其它笔记.

8、渐入淡出

1.     $("#msg").fadeIn("fast");      

2.     $("#msg").fadeOut("slow");    

没错，上面两行代码已经分别实现了一个id为Msg的jquery对象的渐入和淡出。做一个像Gmail一样的动态加载通知条，用jquery就那么简单。两个函数接受的参数除了快慢等，还可以接收整型，作为渐入或淡出的完成时间，单位为MS。

9.plugin这也是一个插件的时代。jquery插件给我的感觉清一色的清洁，简单。如Jtip，要使用它的功能，只需要在你的元素的class上加上Jtip,并引入jtip.js及其样式即可以了。其他事情插件全包。我喜欢jquery的一个重要原因是发现她已经有了很多很好，很精彩的插件。
 
10.解决自定义方法或其他类库与jQuery的冲突很多时候我们自己定义了$(id)方法来获取一个元素，或者其他的一些js类库如prototype也都定义了$方法，如果同时把这些内容放在一起就会引起变量方法定义冲突，Jquery对此专门提供了方法用于解决此问题。使用jquery中的jQuery.noConflict();方法即可把变量$的控制权让渡给第一个实现它的那个库或之前自定义的$方法。之后应用 Jquery的时候只要将所有的$换成jQuery即可，如原来引用对象方法$("#msg")改为jQuery("#msg")。
如：

1.     jQuery.noConflict();   

2.     // 开始使用jQuery   

3.     jQuery("div   p").hide();   

4.     // 使用其他库的 $()   

5.     $("content").style.display = 'none';  

 
(二)基于jQuery的Ajax用法:
基于JQuery框架的AJAX
在JQuery中，AJAX有三种实现方式：$.ajax(),$.post,$.get()。
(1)使用$.post实现Ajax向页面发送数据 ($.get()的用法与此相似)

1.     $.post(’save.cgi’, {text: ‘my string’,number: 23}, function() {   

2.     alert(’Your data has been saved.’);   

3.     });  

(2)如果您确实需要编写一些复杂的 Ajax 脚本，那么需要用到 $.ajax() 函数。您可以指定 xml、script、html 或者 json，jQuery 将自动为回调函数准备合适的结果，这样您便可以立即使用该结果。还可以指定 beforeSend、error、success 或者 complete 回调函数，向用户提供更多有关Ajax 体验的反馈。
$.ajax() 使 Ajax 由复杂变简单

1.     $.ajax({   

2.     url: ‘document.xml’,   

3.     type: ‘GET’,   

4.     dataType: ‘xml’,   

5.     timeout: 1000,   

6.     error: function(){   

7.     alert(’Error loading XML document’);   

8.     },   

9.     success: function(xml){   

10.  // do something with xml   

11.  }   

12.  });  

 
另一实例:
    XHTML(主要):
    代码: 复制内容到剪贴板

1.     <div id="result" style="backgroundrange;border:1px solid    

2.     width:300px;height:400px;"></div>  

3.     <form id="formtest" action="" method="post">  

4.     <p><span>输入姓名:</span><input type="text" name="username" id="input1" /></p>  

5.     <p><span>输入年龄:</span><input type="text" name="age" id="input2" /></p>  

6.     <p><span>输入性别:</span><input type="text" name="sex" id="input3" /></p>  

7.     <p><span>输入工作:</span><input type="text" name="job" id="input4" /></p>  

8.     </form>  

9.     <button id="send_ajax">提交</button>  

10.  <button id="test_post">OST提交</button>  

11.  <button id="test_get">GET提交</button>  

    JS:
    1、引入jquery框架：
    代码: 复制内容到剪贴板

1.     <script  type="text/javascript" src="../js/jquery.js"></script>  

    2、构建AJAX，JQUERY的好处是不需要在XHTML中使用JS代码来触发事件了，可以直接封装在JS文件中：
    代码: 复制内容到剪贴板

1.         <script type="text/javascript">   

2.         //$.ajax()方式   

3.         $(document).ready(function (){   

4.            $('#send_ajax').click(function (){ //直接把onclick事件写在了JS中，而不需要混在   

5.     XHTML中了   

6.                   var params=$('input').serialize(); //序列化表单的值，与prototype中的   

7.     form.serialize()相同   

8.                  $.ajax({   

9.                        url ：'ajax_test.php',  //后台处理程序   

10.                     type:'post',    //数据发送方式   

11.                   dataType:'json',  //接受数据格式   

12.                     data:params,  //要传递的数据   

13.                     success:update_page  //回传函数(这里是函数名)   

14.                     });   

15.              });   

16.      });   

17.      function update_page (json) { //回传函数实体，参数为XMLhttpRequest.responseText   

18.             var str="姓名:"+json.username+"";   

19.             str+="年龄:"+json.age+"";   

20.             str+="性别:"+json.sex+"";   

21.             str+="工作:"+json.job;   

22.             $("#result").html(str);   

23.      }   

 
(三)Struts2 + jQuery 的简单例子使用
JSON插件提供了一种名为json的ResultType，一旦为某个Action指定了一个类型为json的Result，则该Result无需映射到任何视图资源。因为,JSON插件允许我们在JavaScript中异步调用Action，且负责将Action里的状态信息序列化成JSON格式的数据，并将该数据返回给客户端页面的JavaScript 。这样就可以完成Ajax交互。
1、将struts2的json插件加入web工程的lib，jsonplugin的下载地址：
http://code.google.com/p/jsonplugin/downloads/list 

2、struts.xml添加专为ajax使用的package  

1.     <package name="ajax" extends="json-default">  

2.             <action name="ajaxRequest"  class="org.david.struts2.HelloWorld">  

3.                 <result type="json"></result>  

4.             </action>  

5.     </package>           

            
3、在页面中引入 jquery的js文件库      

1.     <SCRIPT type="text/javascript" src="js/jquery-1.2.6.min.js"></script>   

2.     <SCRIPT type="text/javascript">   

3.                function clickButton()   

4.                {       

5.                    var url = 'ajaxRequest.action';   

6.                    var params = {   

7.                               name:$('#name').attr('value'),   

8.                               contactEmail:$('#contactEmail').attr('value'),   

9.                               subject:$('#subject').attr('value'),   

10.                            content:$('#content').attr('value')                   

11.                        }; //通过id获得输入值   

12.                  jQuery.post(url, params, callbackFun, 'json');   

13.                }    

14.  /url：响应aciton；params：传入参数；callbackFun：响应完成后的回调函数；   

15.             function callbackFun(data)   

16.             {   

17.                  alert("SUCCESS");   

18.             }   

19.      </SCRIPT>  

4、action逻辑与普通的ation写法无大区别。
     JSON将Action里的状态信息序列化成JSON格式的数据