jQuery1.9(辅助函数)学习之—— jQuery.param( obj ); 编辑

jQuery.param( obj );  返回一个String

 

描述: 创建一个数组或对象序列化的的字符串,适用于一个URL 地址查询字符串或Ajax请求。

 

 

jQuery.param( obj );

jQuery.param( obj, traditional );

 

  • obj
    类型: Array, Object
    用于数组或序列化的对象。
  • traditional
    类型: Boolean
    一个布尔值,指示是否执行了传统的“shallow”的序列化。

 

这个函数 可以将表单元素的值 转换为 序列化字符串 (更多细节查阅 .serialize() )。

在 jQuery 1.3中, 这个函数的返回值被用来代替函数作为一个字符串。

在 jQuery 1.4中, $.param() 方法将会通过深度递归的方式序列化对象,以便符合现代化脚本语言和框架的需求,比如 PHP 和 Ruby on Rails。 你可以通过设置 jQuery.ajaxSettings.traditional = true;废除这个全局功能。

如果传递的对象是一个数组,它必须是一个对象数组,其格式要跟.serializeArray()返回的格式一样:

jQuery1.9(辅助函数)学习之—— jQuery.param( obj ); 编辑
    [{name:"first",value:"Rick"},  
    {name:"last",value:"Astley"},  
    {name:"job",value:"Rock Star"}]  
jQuery1.9(辅助函数)学习之—— jQuery.param( obj ); 编辑

 注意: 因为一些框架解析序列化的数字的能力有限, 在传递 obj 参数时我们应该谨慎,尽量不要传递含有对象的数组,或者数组中嵌套其它数组。

 

注意: 由于目前对序列化字符串没有统一的规约,此方法无法对复杂数据结构进行编码,使之可以支持所有语言。 在此之前, $.param 方法将继续保持其目前的形式。

 

在 jQuery 1.4 HTML5中input元素也是序列化的元素。

我们可以显示一个对象的查询字符串 和一个相应的URI-decoded 版本,如下:

jQuery1.9(辅助函数)学习之—— jQuery.param( obj ); 编辑
    var myObject = {  
            a:{  
                one:1,  
                two:2,  
                three:3  
            },  
            b:[1,2,3]  
        };  
      
    var recursiveEncoded = $.param(myObject);  
    var recursiveDecoded = decodeURIComponent($.param(myObject));  
      
    alert(recursiveDecoded);  
    alert(recursiveEncoded);  
jQuery1.9(辅助函数)学习之—— jQuery.param( obj ); 编辑

recursiveEncodedrecursiveDecoded 的结果如下:

 

a%5Bone%5D=1&a%5Btwo%5D=2&a%5Bthree%5D=3&b%5B%5D=1&b%5B%5D=2&b%5B%5D=3
a[one]=1&a[two]=2&a[three]=3&b[]=1&b[]=2&b[]=3

 

在jQuery1.4之前,要模仿$.param()的行为,我们可以设置 traditional 参数为 true

jQuery1.9(辅助函数)学习之—— jQuery.param( obj ); 编辑
    var myObject = {  
    a: {  
    one: 1,  
    two: 2,  
    three: 3  
    },  
    b: [1,2,3]  
    };  
    var shallowEncoded = $.param(myObject, true);  
    var shallowDecoded = decodeURIComponent(shallowEncoded);  
    alert(shallowEncoded);  
    alert(shallowDecoded);  
jQuery1.9(辅助函数)学习之—— jQuery.param( obj ); 编辑

shallowEncodedshallowDecoded 的结果如下:

a=%5Bobject+Object%5D&b=1&b=2&b=3
a=[object+Object]&b=1&b=2&b=3

例子:

jQuery1.9(辅助函数)学习之—— jQuery.param( obj ); 编辑
    <!DOCTYPE html>  
    <html>  
    <head>  
    <style>div { color:red; }</style>  
    <script src="http://code.jquery.com/jquery-latest.js"></script>  
    </head>  
    <body>  
    <div id="results"></div>  
    <script>  
    var params = { width:1680, height:1050 };  
    var str = jQuery.param(params);  
    $("#results").text(str);  
    </script>  
    </body>  
    </html>  

 
jQuery1.9(辅助函数)学习之—— jQuery.param( obj ); 编辑

Demo:

width=1680&height=1050 

序列号一些复杂的对象:

jQuery1.9(辅助函数)学习之—— jQuery.param( obj ); 编辑
    // <=1.3.2:  
    $.param({ a: [2,3,4] }) // "a=2&a=3&a=4"  
    // >=1.4:  
    $.param({ a: [2,3,4] }) // "a[]=2&a[]=3&a[]=4"  
    // <=1.3.2:  
    $.param({ a: { b:1,c:2 }, d: [3,4,{ e:5 }] }) // "a=[object+Object]&d=3&d=4&d=[object+Object]"  
    // >=1.4:  
    $.param({ a: { b:1,c:2 }, d: [3,4,{ e:5 }] }) // "a[b]=1&a[c]=2&d[]=3&d[]=4&d[2][e]=5"  
jQuery1.9(辅助函数)学习之—— jQuery.param( obj ); 编辑

jQuery1.9(辅助函数)学习之—— jQuery.param( obj ); 编辑,布布扣,bubuko.com

jQuery1.9(辅助函数)学习之—— jQuery.param( obj ); 编辑

上一篇:jQuery1.9(辅助函数)学习之——.serializeArray();


下一篇:Google Earth Engine ——MCD19A2 V6数据产品是MODIS Terra和Aqua结合的大气校正多角度实施(MAIAC)陆地气溶胶光学深度(AOD)网格化2级产品,1公里分辨率