96c5a559ec75ddc7909b3bd3faf9323d323839ec
[redakcja.git] / src / redakcja / static / js / lib / jquery / jquery.xmlns.js
1 //
2 //  jquery.xmlns.js:  xml-namespace selector support for jQuery
3 //
4 //  This plugin modifies the jQuery tag and attribute selectors to
5 //  support optional namespace specifiers as defined in CSS 3:
6 //
7 //    $("elem")      - matches 'elem' nodes in the default namespace
8 //    $("|elem")     - matches 'elem' nodes that don't have a namespace
9 //    $("NS|elem")   - matches 'elem' nodes in declared namespace 'NS'
10 //    $("*|elem")    - matches 'elem' nodes in any namespace
11 //    $("NS|*")      - matches any nodes in declared namespace 'NS'
12 //
13 //  A similar synax is also supported for attribute selectors, but note
14 //  that the default namespace does *not* apply to attributes - a missing
15 //  or empty namespace selector selects only attributes with no namespace.
16 //
17 //  In a slight break from the W3C standards, and with a nod to ease of
18 //  implementation, the empty namespace URI is treated as equivalent to
19 //  an unspecified namespace.  Plenty of browsers seem to make the same
20 //  assumption...
21 //
22 //  Namespace declarations live in the $.xmlns object, which is a simple
23 //  mapping from namespace ids to namespace URIs.  The default namespace
24 //  is determined by the value associated with the empty string.
25 //
26 //    $.xmlns.D = "DAV:"
27 //    $.xmlns.FOO = "http://www.foo.com/xmlns/foobar"
28 //    $.xmlns[""] = "http://www.example.com/new/default/namespace/"
29 //
30 //  Unfortunately this is a global setting - I can't find a way to do
31 //  query-object-specific namespaces since the jQuery selector machinery
32 //  is stateless.  However, you can use the 'xmlns' function to push and
33 //  pop namespace delcarations with ease:
34 //
35 //    $().xmlns({D:"DAV:"})     // pushes the DAV: namespace
36 //    $().xmlns("DAV:")         // makes DAV: the default namespace
37 //    $().xmlns(false)          // pops the namespace we just pushed
38 //    $().xmlns(false)          // pops again, returning to defaults
39 //
40 //  To execute this as a kind of "transaction", pass a function as the
41 //  second argument.  It will be executed in the context of the current
42 //  jQuery object:
43 //
44 //    $().xmlns("DAV:",function() {
45 //      //  The default namespace is DAV: within this function,
46 //      //  but it is reset to the previous value on exit.
47 //      return this.find("response").each(...);
48 //    }).find("div")
49 //
50 //  If you pass a string as a function, it will be executed against the
51 //  current jQuery object using find(); i.e. the following will find all
52 //  "href" elements in the "DAV:" namespace:
53 //
54 //    $().xmlns("DAV:","href")
55 //
56 // 
57 //  And finally, the legal stuff:
58 //
59 //    Copyright (c) 2009, Ryan Kelly.
60 //    TAG and ATTR functions derived from jQuery's selector.js.
61 //    Dual licensed under the MIT and GPL licenses.
62 //    http://docs.jquery.com/License
63 //
64
65 (function($) {
66
67 //  Some common default namespaces, that are treated specially by browsers.
68 //
69 var default_xmlns = {
70     "xml": "http://www.w3.org/XML/1998/namespace",
71     "xmlns": "http://www.w3.org/2000/xmlns/",
72     "html": "http://www.w3.org/1999/xhtml/"
73 };
74  
75
76 //  A reverse mapping for common namespace prefixes.
77 //
78 var default_xmlns_rev = {}
79 for(var k in default_xmlns) {
80     default_xmlns_rev[default_xmlns[k]] = k;
81 }
82
83
84 //  $.xmlns is a mapping from namespace identifiers to namespace URIs.
85 //  The default default-namespace is "*", and we provide some additional
86 //  defaults that are specified in the XML Namespaces standard.
87 //
88 $.extend({xmlns: $.extend({},default_xmlns,{"":"*"})});
89
90
91 //  jQuery method to push/pop namespace declarations.
92 //
93 //  If a single argument is specified:
94 //    * if it's a mapping, push those namespaces onto the stack
95 //    * if it's a string, push that as the default namespace
96 //    * if it evaluates to false, pop the latest namespace
97 //
98 //  If two arguments are specified, the second is executed "transactionally"
99 //  using the namespace declarations found in the first.  It can be either a
100 //  a selector string (in which case it is passed to this.find()) or a function
101 //  (in which case it is called in the context of the current jQuery object).
102 //  The given namespace mapping is automatically pushed before executing and
103 //  popped afterwards.
104 //
105 var xmlns_stack = [];
106 $.fn.extend({xmlns: function(nsmap,func) {
107     if(typeof nsmap == "string") {
108         nsmap = {"":nsmap};
109     }
110     if(nsmap) {
111         xmlns_stack.push($.xmlns);
112         $.xmlns = $.extend({},$.xmlns,nsmap);
113         if(func !== undefined) {
114             if(typeof func == "string") {
115                 return this.find(func).xmlns(undefined)
116             } else {
117                 var self = this;
118                 try {
119                     self = func.call(this);
120                     if(!self) {
121                         self = this;
122                     }
123                 } finally {
124                     self.xmlns(undefined);
125                 }
126                 return self
127             }
128         } else {
129             return this;
130         }
131     } else {
132         $.xmlns = (xmlns_stack ? xmlns_stack.pop() : {});
133         return this;
134     }
135 }});
136
137
138 //  Convert a namespace prefix into a namespace URI, based
139 //  on the delcarations made in $.xmlns.
140 //
141 var getNamespaceURI = function(id) {
142     // No namespace id, use the default.
143     if(!id) {
144         return $.xmlns[""];
145     }
146     // Strip the pipe character from the specifier
147     id = id.substr(0,id.length-1);
148     // Certain special namespaces aren't mapped to a URI
149     if(id == "" || id == "*") {
150         return id;
151     }
152     var ns = $.xmlns[id];
153     if(typeof(ns) == "undefined") {
154         throw "Syntax error, undefined namespace prefix '" + id + "'";
155     }
156     return ns;
157 };
158
159
160 //  Update the regex used by $.expr to parse selector components for a
161 //  particular type of selector (e.g. "TAG" or "ATTR").
162 //
163 //  This logic is taken straight from the jQuery/Sizzle sources.
164 //
165 var setExprMatchRegex = function(type,regex) {
166   $.expr.match[type] = new RegExp(regex.source + /(?![^\[]*\])(?![^\(]*\))/.source);
167   if($.expr.leftMatch) {
168       $.expr.leftMatch[type] = new RegExp(/(^(?:.|\r|\n)*?)/.source + $.expr.match[type].source.replace(/\\(\d+)/g, function(all, num){
169           return "\\" + (num - 0 + 1);
170       }));
171   }
172 }
173
174
175
176 //  Modify the TAG match regexp to include optional namespace selector.
177 //  This is basically (namespace|)?(tagname).
178 //
179 setExprMatchRegex("TAG",/^((?:((?:[\w\u00c0-\uFFFF\*_-]*\|)?)((?:[\w\u00c0-\uFFFF\*_-]|\\.)+)))/);
180
181
182 //  Perform some capability-testing.
183 //
184 var div = document.createElement("div");
185
186 //  Sometimes getElementsByTagName("*") will return comment nodes,
187 //  which we will have to remove from the results.
188 //
189 var gebtn_yields_comments = false;
190 div.appendChild(document.createComment(""));
191 if(div.getElementsByTagName("*").length > 0) {
192     gebtn_yields_comments = true;
193 }
194
195 //  Some browsers return node.localName in upper case, some in lower case.
196 //
197 var localname_is_uppercase = true;
198 if(div.localName && div.localName == "div") {
199     localname_is_uppercase = false;
200 }
201
202 //  Allow the testing div to be garbage-collected.
203 //
204 div = null;
205
206
207 //  Modify the TAG find function to account for a namespace selector.
208 //
209 $.expr.find.TAG = function(match,context,isXML) {
210     var ns = getNamespaceURI(match[2]);
211     var ln = match[3];
212     var res;
213     if(typeof context.getElementsByTagNameNS != "undefined") {
214         //  Easy case - we have getElementsByTagNameNS
215         res = context.getElementsByTagNameNS(ns,ln);
216     } else if(typeof context.selectNodes != "undefined") {
217         //  Use xpath if possible (not available on HTML DOM nodes in IE)
218         if(context.ownerDocument) {
219             context.ownerDocument.setProperty("SelectionLanguage","XPath");
220         } else {
221             context.setProperty("SelectionLanguage","XPath");
222         }
223         var predicate = "";
224         if(ns != "*") {
225             if(ln != "*") {
226                 predicate="namespace-uri()='"+ns+"' and local-name()='"+ln+"'";
227             } else {
228                 predicate="namespace-uri()='"+ns+"'";
229             }
230         } else {
231             if(ln != "*") {
232                 predicate="local-name()='"+ln+"'";
233             }
234         }
235         if(predicate) {
236             res = context.selectNodes("descendant-or-self::*["+predicate+"]");
237         } else {
238             res = context.selectNodes("descendant-or-self::*");
239         }
240     } else {
241         //  Otherwise, we need to simulate using getElementsByTagName
242         res = context.getElementsByTagName(ln); 
243         if(gebtn_yields_comments && ln == "*") {
244             var tmp = [];
245             for(var i=0; res[i]; i++) {
246                 if(res[i].nodeType == 1) {
247                     tmp.push(res[i]);
248                 }
249             }
250             res = tmp;
251         }
252         if(res && ns != "*") {
253             var tmp = [];
254             for(var i=0; res[i]; i++) {
255                if(res[i].namespaceURI == ns || res[i].tagUrn == ns) {
256                    tmp.push(res[i]);
257                }
258             }
259             res = tmp;
260         }
261     }
262     return res;
263 };
264
265
266 //  Check whether a node is part of an XML document.
267 //  Copied verbatim from jQuery sources, needed in TAG preFilter below.
268 //
269 var isXML = function(elem){
270     return elem.nodeType === 9 && elem.documentElement.nodeName !== "HTML" ||
271             !!elem.ownerDocument && elem.ownerDocument.documentElement.nodeName !== "HTML";
272 };
273
274
275 //  Modify the TAG preFilter function to work with modified match regexp.
276 //  This normalises case of the tag name if we're in a HTML document.
277 //
278 $.expr.preFilter.TAG = function(match, curLoop, inplace, result, not, isXML) {
279   var ln = match[3];
280   if(!isXML) {
281       if(localname_is_uppercase) {
282           ln = ln.toUpperCase();
283       } else {
284           ln = ln.toLowerCase();
285       }
286   }
287   return [match[0],getNamespaceURI(match[2]),ln];
288 };
289
290
291 //  Modify the TAG filter function to account for a namespace selector.
292 //
293 $.expr.filter.TAG = function(elem,match) {
294     var ns = match[1];
295     var ln = match[2];
296     var e_ns = elem.namespaceURI ? elem.namespaceURI : elem.tagUrn;
297     var e_ln = elem.localName ? elem.localName : elem.tagName;
298     if(ns == "*" || e_ns == ns || (ns == "" && !e_ns)) {
299         return ((ln == "*" && elem.nodeType == 1)  || e_ln == ln);
300     }
301     return false;
302 };
303
304
305 //  Modify the ATTR match regexp to extract a namespace selector.
306 //  This is basically ([namespace|])(attrname)(op)(quote)(pattern)(quote)
307 //
308 setExprMatchRegex("ATTR",/\[\s*((?:((?:[\w\u00c0-\uFFFF\*_-]*\|)?)((?:[\w\u00c0-\uFFFF_-]|\\.)+)))\s*(?:(\S?=)\s*(['"]*)(.*?)\5|)\s*\]/);
309
310
311 //  Modify the ATTR preFilter function to account for new regexp match groups,
312 //  and normalise the namespace URI.
313 //
314 $.expr.preFilter.ATTR = function(match, curLoop, inplace, result, not, isXML) {
315     var name = match[3].replace(/\\/g, "");
316     if(!isXML && $.expr.attrMap[name]) {
317         match[3] = $.expr.attrMap[name];
318     }
319     if( match[4] == "~=" ) {
320         match[6] = " " + match[6] + " ";
321     }
322     if(!match[2] || match[2] == "|") {
323         match[2] = "";
324     } else {
325         match[2] = getNamespaceURI(match[2]);
326     }
327     return match;
328 };
329
330
331 //  Modify the ATTR filter function to account for namespace selector.
332 //  Unfortunately this means factoring out the attribute-checking code
333 //  into a separate function, since it might be called multiple times.
334 //
335 var filter_attr = function(result,type,check) {
336     var value = result + "";
337     return result == null ?
338                 type === "!=" :
339                 type === "=" ?
340                 value === check :
341                 type === "*=" ?
342                 value.indexOf(check) >= 0 :
343                 type === "~=" ?
344                 (" " + value + " ").indexOf(check) >= 0 :
345                 !check ?
346                 value && result !== false :
347                 type === "!=" ?
348                 value != check :
349                 type === "^=" ?
350                 value.indexOf(check) === 0 :
351                 type === "$=" ?
352                 value.substr(value.length - check.length) === check :
353                 type === "|=" ?
354                 value === check || value.substr(0,check.length+1)===check+"-" :
355                 false;
356 }
357
358
359 $.expr.filter.ATTR = function(elem, match) {
360     var ns = match[2];
361     var name = match[3];
362     var type = match[4];
363     var check = match[6];
364     var result;
365     //  No namespace, just use ordinary attribute lookup.
366     if(ns == "") {
367         result = $.expr.attrHandle[name] ?
368                      $.expr.attrHandle[name](elem) :
369                      elem[name] != null ?
370                          elem[name] :
371                          elem.getAttribute(name);
372         return filter_attr(result,type,check);
373     }
374     //  Directly use getAttributeNS if applicable and available
375     if(ns != "*" && typeof elem.getAttributeNS != "undefined") {
376         return filter_attr(elem.getAttributeNS(ns,name),type,check);
377     }
378     //  Need to iterate over all attributes, either because we couldn't
379     //  look it up or because we need to match all namespaces.
380     var attrs = elem.attributes;
381     for(var i=0; attrs[i]; i++) {
382         var ln = attrs[i].localName;
383         if(!ln) {
384             ln = attrs[i].nodeName
385             var idx = ln.indexOf(":");
386             if(idx >= 0) {
387                 ln = ln.substr(idx+1);
388             }
389         }
390         if(ln == name) {
391             result = attrs[i].nodeValue;
392             if(ns == "*" || attrs[i].namespaceURI == ns) {
393                 if(filter_attr(result,type,check)) {
394                     return true;
395                 }
396             }
397             if(attrs[i].namespaceURI === "" && attrs[i].prefix) {
398                 if(attrs[i].prefix == default_xmlns_rev[ns]) {
399                     if(filter_attr(result,type,check)) {
400                         return true;
401                     }
402                 }
403             }
404         }
405     }
406     return false;
407 };
408
409
410 })(jQuery);
411