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定义的方法。
如:
$("#msg").html();-->通过ID
$("div").html(); $("input").val(); -->通过元素名(jQuery获取的是一个集合)
$("div p");             -->第一行代码得到所有<div>标签下的<p>元素。
$("div.container")      -->第二行代码得到 class为container的<div>元素 
$("div #msg");          -->第三行代码得到<div>标签下面id为msg的元素。
$("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的方法。

以下几种写法都是正确的：
$("#msg").html();
$("#msg")[0].innerHTML;
$("#msg").eq(0)[0].innerHTML;
$("#msg").get(0).innerHTML;
对于获取的元素集合，获取其中的某一项（通过索引指定）可以使用eq或get(n)方法或者索引号获
取，要注意，eq返回的是jquery对象，而 get(n)和索引返回的是dom元素对象。
如要获取第三个 <div>元素的内容。有如下两种方法：
$("div").eq(2).html();              //调用jquery对象的方法
$("div").get(2).innerHTML;       //调用dom的方法属性
3、同一函数实现set和get
Jquery中的很多方法都是如此，主要包括如下几个：
$("#msg").html();              //返回id为msg的元素节点的html内容。
$("#msg").html("<b>new content</b>");    
//将“<b>new content</b>” 作为html串写入id为msg的元素节点内容中,页面显示粗体的new
content
$("#msg").text();              //返回id为msg的元素节点的文本内容。
$("#msg").text("<b>new content</b>");    
//将“<b>new content</b>” 作为普通文本串写入id为msg的元素节点内容中,页面显示<b>new
content</b>
$("#msg").height();              //返回id为msg的元素的高度
$("#msg").height("300");       //将id为msg的元素的高度设为300
$("#msg").width();              //返回id为msg的元素的宽度
$("#msg").width("300");       //将id为msg的元素的宽度设为300
$("input").val(");       //返回表单输入框的value值
$("input").val("test");       //将表单输入框的value值设为test
$("#msg").click();       //触发id为msg的元素的单击事件
$("#msg").click(fn);       //为id为msg的元素单击事件添加函数
同样blur,focus,select,submit事件都可以有这两种调用方法

4、几个有用的jQuery方法:
0)
集合处理功能 ???
对于jquery返回的集合内容无需我们自己循环遍历并对每个对象分别做处理，jquery已经为我们提
供的很方便的方法进行集合的处理。
包括两种形式：
$("p").each(function(i){this.style.color=['#f00','#0f0','#00f'][i]})    
//为索引分别为0，1，2的p元素分别设定不同的字体颜色。
$("tr").each(function(i){this.style.backgroundColor=['#ccc','#fff'][i%2]})    
//实现表格的隔行换色效果
$("p").click(function(){alert($(this).html())})           
//为每个p元素增加了click事件，单击某个p元素则弹出其内容
1)$.browser.浏览器类型：检测浏览器类型。有效参数：safari, opera, msie, mozilla。如检测是
否ie：$.browser.isie，是ie浏览器则返回true。
2)$.each(obj, fn)：通用的迭代函数。可用于近似地迭代对象和数组（代替循环）。
如
$.each( [0,1,2], function(i, n){ alert( "Item #" + i + ": " + n ); });
等价于：
var tempArr=[0,1,2];
for(var i=0;i<tempArr.length;i++){
       alert("Item #"+i+": "+tempArr[i]);
}
3)也可以处理json数据，如
$.each( { name: "John", lang: "JS" }, function(i, n){ alert( "Name: " + i + ", Value: "
+ n ); });
结果为：
Name:name, Value:John
Name:lang, Value:JS
4)$.map(array, fn)：数组映射。把一个数组中的项目(处理转换后)保存到到另一个新数组中，并返
回生成的新数组。
如：
var tempArr=$.map( [0,1,2], function(i){ return i + 4; });
tempArr内容为：[4,5,6]
var tempArr=$.map( [0,1,2], function(i){ return i > 0 ? i + 1 : null; });
tempArr内容为：[2,3]
5)$.merge(arr1,arr2):合并两个数组并删除其中重复的项目。
如：
$.merge( [0,1,2], [2,3,4] )       //返回[0,1,2,3,4]
6)$.trim(str)：删除字符串两端的空白字符。
如：
$.trim(" hello, how are you?   ");    //返回"hello,how are you? "
5、操作元素的样式
主要包括以下几种方式：
$("#msg").css("background");              //返回元素的背景颜色
$("#msg").css("background","#ccc")       //设定元素背景为灰色
$("#msg").height(300); $("#msg").width("200");       //设定宽高
$("#msg").css({ color: "red", background: "blue" });//以名值对的形式设定样式
$("#msg").addClass("select");       //为元素增加名称为select的class
$("#msg").removeClass("select");       //删除元素名称为select的class
$("#msg").toggleClass("select");       //如果存在（不存在）就删除（添加）名称为select的class

6、完善的事件处理功能
Jquery已经为我们提供了各种事件处理方法，我们无需在html元素上直接写事件，而可以直接为通
过jquery获取的对象添加事件。
如：
$("#msg").click(function(){alert("good")})    //为元素添加了单击事件
$("p").click(function(i){this.style.color=['#f00','#0f0','#00f'][i]})   //为三个不同的p
元素单击事件分别设定不同的处理
jQuery中几个自定义的事件：
（1）hover(fn1,fn2)：当鼠标移动到一个匹配的元素上面时，会触发指定的第一个函数。当鼠标移
出这个元素时，会触发指定的第二个函数。
//当鼠标放在表格的某行上时将class置为over，离开时置为out。
$("tr").hover(function(){
$(this).addClass("over");
},
       function(){
       $(this).addClass("out");
});
（2）ready(fn):当DOM载入就绪可以查询及操纵时绑定一个要执行的函数。
$(document).ready(function(){alert("Load Success")})
//页面加载完毕提示“Load Success”,不同于onload事件，onload需要页面内容加载完毕（图片等
），而ready只要页面html代码下载完毕即触发。与$(fn)等价

（3）toggle(evenFn,oddFn): 每次点击时切换要调用的函数。如果点击了一个匹配的元素，则触发
指定的第一个函数，当再次点击同一元素时，则触发指定的第二个函数。随后的每次点击都重复对
这两个函数的轮番调用。
       //每次点击时轮换添加和删除名为selected的class。
       $("p").toggle(function(){
              $(this).addClass("selected");
       },function(){
              $(this).removeClass("selected");
       });
（4）trigger(eventtype): 在每一个匹配的元素上触发某类事件。
例如：
       $("p").trigger("click");       //触发所有p元素的click事件
（5）bind(eventtype,fn)，unbind(eventtype): 事件的绑定与反绑定
从每一个匹配的元素中（添加）删除绑定的事件。
例如：
$("p").bind("click", function(){alert($(this).text());});
//为每个p元素添加单击事件
$("p").unbind();       //删除所有p元素上的所有事件
$("p").unbind("click")       //删除所有p元素上的单击事件

7、扩展我们需要的功能
$.extend({
       min: function(a, b){return a < b?a:b; },
       max: function(a, b){return a > b?a:b; }
});       //为jquery扩展了min,max两个方法
使用扩展的方法（通过“$.方法名”调用）：
alert("a=10,b=20,max="+$.max(10,20)+",min="+$.min(10,20));
----------->ajax编程,请见其它笔记.

8、渐入淡出
$("#msg").fadeIn("fast"); 
$("#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")。
如：
jQuery.noConflict();
// 开始使用jQuery
jQuery("div   p").hide();
// 使用其他库的 $()
$("content").style.display = 'none';

(二)基于jQuery的Ajax用法:
基于JQuery框架的AJAX
在JQuery中，AJAX有三种实现方式：$.ajax(),$.post,$.get()。

(1)使用$.post实现Ajax向页面发送数据 ($.get()的用法与此相似)
$.post(’save.cgi’, {text: ‘my string’,number: 23}, function() {
alert(’Your data has been saved.’);
});

(2)如果您确实需要编写一些复杂的 Ajax 脚本，那么需要用到 $.ajax() 函数。您可以指定 xml、
script、html 或者 json，jQuery 将自动为回调函数准备合适的结果，这样您便可以立即使用该结果。还可以指定 beforeSend、error、success 或者 complete 回调函数，向用户提供更多有关Ajax 体验的反馈。
$.ajax() 使 Ajax 由复杂变简单
$.ajax({
url: ‘document.xml’,
type: ‘GET’,
dataType: ‘xml’,
timeout: 1000,
error: function(){
alert(’Error loading XML document’);
},
success: function(xml){
// do something with xml
}
});

另一实例:
    XHTML(主要):
    代码: 复制内容到剪贴板
    <div id="result" style="backgroundrange;border:1px solid
red;width:300px;height:400px;"></div>
    <form id="formtest" action="" method="post">
    <p><span>输入姓名:</span><input type="text" name="username" id="input1" /></p>
    <p><span>输入年龄:</span><input type="text" name="age" id="input2" /></p>
    <p><span>输入性别:</span><input type="text" name="sex" id="input3" /></p>
    <p><span>输入工作:</span><input type="text" name="job" id="input4" /></p>
    </form>
    <button id="send_ajax">提交</button>
    <button id="test_post">OST提交</button>
    <button id="test_get">GET提交</button>
    JS:
    1、引入jquery框架：
    代码: 复制内容到剪贴板
    <script type="text/javascript" src="../js/jquery.js"></script>
    2、构建AJAX，JQUERY的好处是不需要在XHTML中使用JS代码来触发事件了，可以直接封装在JS
文件中：
    代码: 复制内容到剪贴板
    <script type="text/javascript">
    //$.ajax()方式
    $(document).ready(function (){
       $('#send_ajax').click(function (){ //直接把onclick事件写在了JS中，而不需要混在
XHTML中了
              var params=$('input').serialize(); //序列化表单的值，与prototype中的
form.serialize()相同
             $.ajax({
                   url ：'ajax_test.php', //后台处理程序
                   type:'post',    //数据发送方式
                 dataType:'json', //接受数据格式
                   data:params, //要传递的数据
                   success:update_page //回传函数(这里是函数名)
                   });
            });
    });
    function update_page (json) { //回传函数实体，参数为XMLhttpRequest.responseText
           var str="姓名:"+json.username+"";
           str+="年龄:"+json.age+"";
           str+="性别:"+json.sex+"";
           str+="工作:"+json.job;
           $("#result").html(str);
    }

(三)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
<package name="ajax" extends="json-default">
        <action name="ajaxRequest" class="org.david.struts2.HelloWorld">
            <result type="json"></result>
        </action>
</package>      
           
3、在页面中引入 jquery的js文件库     
<SCRIPT type="text/javascript" src="js/jquery-1.2.6.min.js"></script>
<SCRIPT type="text/javascript">
            function clickButton()
            {  
                var url = 'ajaxRequest.action';
                var params = {
                           name:$('#name').attr('value'),
                           contactEmail:$('#contactEmail').attr('value'),
                           subject:$('#subject').attr('value'),
                           content:$('#content').attr('value')              
                       }; //通过id获得输入值
                 jQuery.post(url, params, callbackFun, 'json');
               }
//url：响应aciton；params：传入参数；callbackFun：响应完成后的回调函数；
            function callbackFun(data)
            {
                 alert("SUCCESS");
            }
     </SCRIPT>
4、action逻辑与普通的ation写法无大区别。
     JSON将Action里的状态信息序列化成JSON格式的数据