|
602
|
1 |
YUI.add('querystring-stringify', function (Y, NAME) { |
|
|
2 |
|
|
|
3 |
/** |
|
|
4 |
* Provides Y.QueryString.stringify method for converting objects to Query Strings. |
|
|
5 |
* |
|
|
6 |
* @module querystring |
|
|
7 |
* @submodule querystring-stringify |
|
|
8 |
*/ |
|
|
9 |
|
|
|
10 |
var QueryString = Y.namespace("QueryString"), |
|
|
11 |
stack = [], |
|
|
12 |
L = Y.Lang; |
|
|
13 |
|
|
|
14 |
/** |
|
|
15 |
* Provides Y.QueryString.escape method to be able to override default encoding |
|
|
16 |
* method. This is important in cases where non-standard delimiters are used, if |
|
|
17 |
* the delimiters would not normally be handled properly by the builtin |
|
|
18 |
* (en|de)codeURIComponent functions. |
|
|
19 |
* Default: encodeURIComponent |
|
|
20 |
* |
|
|
21 |
* @method escape |
|
|
22 |
* @for QueryString |
|
|
23 |
* @static |
|
|
24 |
**/ |
|
|
25 |
QueryString.escape = encodeURIComponent; |
|
|
26 |
|
|
|
27 |
/** |
|
|
28 |
* <p>Converts an arbitrary value to a Query String representation.</p> |
|
|
29 |
* |
|
|
30 |
* <p>Objects with cyclical references will trigger an exception.</p> |
|
|
31 |
* |
|
|
32 |
* @method stringify |
|
|
33 |
* @for QueryString |
|
|
34 |
* @public |
|
|
35 |
* @param obj {Any} any arbitrary value to convert to query string |
|
|
36 |
* @param cfg {Object} (optional) Configuration object. The three |
|
|
37 |
* supported configurations are: |
|
|
38 |
* <ul><li>sep: When defined, the value will be used as the key-value |
|
|
39 |
* separator. The default value is "&".</li> |
|
|
40 |
* <li>eq: When defined, the value will be used to join the key to |
|
|
41 |
* the value. The default value is "=".</li> |
|
|
42 |
* <li>arrayKey: When set to true, the key of an array will have the |
|
|
43 |
* '[]' notation appended to the key. The default value is false. |
|
|
44 |
* </li></ul> |
|
|
45 |
* @param name {String} (optional) Name of the current key, for handling children recursively. |
|
|
46 |
* @static |
|
|
47 |
*/ |
|
|
48 |
QueryString.stringify = function (obj, c, name) { |
|
|
49 |
var begin, end, i, l, n, s, |
|
|
50 |
sep = c && c.sep ? c.sep : "&", |
|
|
51 |
eq = c && c.eq ? c.eq : "=", |
|
|
52 |
aK = c && c.arrayKey ? c.arrayKey : false; |
|
|
53 |
|
|
|
54 |
if (L.isNull(obj) || L.isUndefined(obj) || L.isFunction(obj)) { |
|
|
55 |
return name ? QueryString.escape(name) + eq : ''; |
|
|
56 |
} |
|
|
57 |
|
|
|
58 |
if (L.isBoolean(obj) || Object.prototype.toString.call(obj) === '[object Boolean]') { |
|
|
59 |
obj =+ obj; |
|
|
60 |
} |
|
|
61 |
|
|
|
62 |
if (L.isNumber(obj) || L.isString(obj)) { |
|
|
63 |
return QueryString.escape(name) + eq + QueryString.escape(obj); |
|
|
64 |
} |
|
|
65 |
|
|
|
66 |
if (L.isArray(obj)) { |
|
|
67 |
s = []; |
|
|
68 |
name = aK ? name + '[]' : name; |
|
|
69 |
l = obj.length; |
|
|
70 |
for (i = 0; i < l; i++) { |
|
|
71 |
s.push( QueryString.stringify(obj[i], c, name) ); |
|
|
72 |
} |
|
|
73 |
|
|
|
74 |
return s.join(sep); |
|
|
75 |
} |
|
|
76 |
// now we know it's an object. |
|
|
77 |
|
|
|
78 |
// Check for cyclical references in nested objects |
|
|
79 |
for (i = stack.length - 1; i >= 0; --i) { |
|
|
80 |
if (stack[i] === obj) { |
|
|
81 |
throw new Error("QueryString.stringify. Cyclical reference"); |
|
|
82 |
} |
|
|
83 |
} |
|
|
84 |
|
|
|
85 |
stack.push(obj); |
|
|
86 |
s = []; |
|
|
87 |
begin = name ? name + '[' : ''; |
|
|
88 |
end = name ? ']' : ''; |
|
|
89 |
for (i in obj) { |
|
|
90 |
if (obj.hasOwnProperty(i)) { |
|
|
91 |
n = begin + i + end; |
|
|
92 |
s.push(QueryString.stringify(obj[i], c, n)); |
|
|
93 |
} |
|
|
94 |
} |
|
|
95 |
|
|
|
96 |
stack.pop(); |
|
|
97 |
s = s.join(sep); |
|
|
98 |
if (!s && name) { |
|
|
99 |
return name + "="; |
|
|
100 |
} |
|
|
101 |
|
|
|
102 |
return s; |
|
|
103 |
}; |
|
|
104 |
|
|
|
105 |
|
|
|
106 |
}, '@VERSION@', {"requires": ["yui-base"]}); |