bgneal@1
|
1 /* document.getElementsBySelector(selector)
|
bgneal@1
|
2 - returns an array of element objects from the current document
|
bgneal@1
|
3 matching the CSS selector. Selectors can contain element names,
|
bgneal@1
|
4 class names and ids and can be nested. For example:
|
bgneal@1
|
5
|
bgneal@1
|
6 elements = document.getElementsBySelect('div#main p a.external')
|
bgneal@1
|
7
|
bgneal@1
|
8 Will return an array of all 'a' elements with 'external' in their
|
bgneal@1
|
9 class attribute that are contained inside 'p' elements that are
|
bgneal@1
|
10 contained inside the 'div' element which has id="main"
|
bgneal@1
|
11
|
bgneal@1
|
12 New in version 0.4: Support for CSS2 and CSS3 attribute selectors:
|
bgneal@1
|
13 See http://www.w3.org/TR/css3-selectors/#attribute-selectors
|
bgneal@1
|
14
|
bgneal@1
|
15 Version 0.4 - Simon Willison, March 25th 2003
|
bgneal@1
|
16 -- Works in Phoenix 0.5, Mozilla 1.3, Opera 7, Internet Explorer 6, Internet Explorer 5 on Windows
|
bgneal@1
|
17 -- Opera 7 fails
|
bgneal@1
|
18 */
|
bgneal@1
|
19
|
bgneal@1
|
20 function getAllChildren(e) {
|
bgneal@1
|
21 // Returns all children of element. Workaround required for IE5/Windows. Ugh.
|
bgneal@1
|
22 return e.all ? e.all : e.getElementsByTagName('*');
|
bgneal@1
|
23 }
|
bgneal@1
|
24
|
bgneal@1
|
25 document.getElementsBySelector = function(selector) {
|
bgneal@1
|
26 // Attempt to fail gracefully in lesser browsers
|
bgneal@1
|
27 if (!document.getElementsByTagName) {
|
bgneal@1
|
28 return new Array();
|
bgneal@1
|
29 }
|
bgneal@1
|
30 // Split selector in to tokens
|
bgneal@1
|
31 var tokens = selector.split(' ');
|
bgneal@1
|
32 var currentContext = new Array(document);
|
bgneal@1
|
33 for (var i = 0; i < tokens.length; i++) {
|
bgneal@1
|
34 token = tokens[i].replace(/^\s+/,'').replace(/\s+$/,'');;
|
bgneal@1
|
35 if (token.indexOf('#') > -1) {
|
bgneal@1
|
36 // Token is an ID selector
|
bgneal@1
|
37 var bits = token.split('#');
|
bgneal@1
|
38 var tagName = bits[0];
|
bgneal@1
|
39 var id = bits[1];
|
bgneal@1
|
40 var element = document.getElementById(id);
|
bgneal@1
|
41 if (tagName && element.nodeName.toLowerCase() != tagName) {
|
bgneal@1
|
42 // tag with that ID not found, return false
|
bgneal@1
|
43 return new Array();
|
bgneal@1
|
44 }
|
bgneal@1
|
45 // Set currentContext to contain just this element
|
bgneal@1
|
46 currentContext = new Array(element);
|
bgneal@1
|
47 continue; // Skip to next token
|
bgneal@1
|
48 }
|
bgneal@1
|
49 if (token.indexOf('.') > -1) {
|
bgneal@1
|
50 // Token contains a class selector
|
bgneal@1
|
51 var bits = token.split('.');
|
bgneal@1
|
52 var tagName = bits[0];
|
bgneal@1
|
53 var className = bits[1];
|
bgneal@1
|
54 if (!tagName) {
|
bgneal@1
|
55 tagName = '*';
|
bgneal@1
|
56 }
|
bgneal@1
|
57 // Get elements matching tag, filter them for class selector
|
bgneal@1
|
58 var found = new Array;
|
bgneal@1
|
59 var foundCount = 0;
|
bgneal@1
|
60 for (var h = 0; h < currentContext.length; h++) {
|
bgneal@1
|
61 var elements;
|
bgneal@1
|
62 if (tagName == '*') {
|
bgneal@1
|
63 elements = getAllChildren(currentContext[h]);
|
bgneal@1
|
64 } else {
|
bgneal@1
|
65 try {
|
bgneal@1
|
66 elements = currentContext[h].getElementsByTagName(tagName);
|
bgneal@1
|
67 }
|
bgneal@1
|
68 catch(e) {
|
bgneal@1
|
69 elements = [];
|
bgneal@1
|
70 }
|
bgneal@1
|
71 }
|
bgneal@1
|
72 for (var j = 0; j < elements.length; j++) {
|
bgneal@1
|
73 found[foundCount++] = elements[j];
|
bgneal@1
|
74 }
|
bgneal@1
|
75 }
|
bgneal@1
|
76 currentContext = new Array;
|
bgneal@1
|
77 var currentContextIndex = 0;
|
bgneal@1
|
78 for (var k = 0; k < found.length; k++) {
|
bgneal@1
|
79 if (found[k].className && found[k].className.match(new RegExp('\\b'+className+'\\b'))) {
|
bgneal@1
|
80 currentContext[currentContextIndex++] = found[k];
|
bgneal@1
|
81 }
|
bgneal@1
|
82 }
|
bgneal@1
|
83 continue; // Skip to next token
|
bgneal@1
|
84 }
|
bgneal@1
|
85 // Code to deal with attribute selectors
|
bgneal@1
|
86 if (token.match(/^(\w*)\[(\w+)([=~\|\^\$\*]?)=?"?([^\]"]*)"?\]$/)) {
|
bgneal@1
|
87 var tagName = RegExp.$1;
|
bgneal@1
|
88 var attrName = RegExp.$2;
|
bgneal@1
|
89 var attrOperator = RegExp.$3;
|
bgneal@1
|
90 var attrValue = RegExp.$4;
|
bgneal@1
|
91 if (!tagName) {
|
bgneal@1
|
92 tagName = '*';
|
bgneal@1
|
93 }
|
bgneal@1
|
94 // Grab all of the tagName elements within current context
|
bgneal@1
|
95 var found = new Array;
|
bgneal@1
|
96 var foundCount = 0;
|
bgneal@1
|
97 for (var h = 0; h < currentContext.length; h++) {
|
bgneal@1
|
98 var elements;
|
bgneal@1
|
99 if (tagName == '*') {
|
bgneal@1
|
100 elements = getAllChildren(currentContext[h]);
|
bgneal@1
|
101 } else {
|
bgneal@1
|
102 elements = currentContext[h].getElementsByTagName(tagName);
|
bgneal@1
|
103 }
|
bgneal@1
|
104 for (var j = 0; j < elements.length; j++) {
|
bgneal@1
|
105 found[foundCount++] = elements[j];
|
bgneal@1
|
106 }
|
bgneal@1
|
107 }
|
bgneal@1
|
108 currentContext = new Array;
|
bgneal@1
|
109 var currentContextIndex = 0;
|
bgneal@1
|
110 var checkFunction; // This function will be used to filter the elements
|
bgneal@1
|
111 switch (attrOperator) {
|
bgneal@1
|
112 case '=': // Equality
|
bgneal@1
|
113 checkFunction = function(e) { return (e.getAttribute(attrName) == attrValue); };
|
bgneal@1
|
114 break;
|
bgneal@1
|
115 case '~': // Match one of space seperated words
|
bgneal@1
|
116 checkFunction = function(e) { return (e.getAttribute(attrName).match(new RegExp('\\b'+attrValue+'\\b'))); };
|
bgneal@1
|
117 break;
|
bgneal@1
|
118 case '|': // Match start with value followed by optional hyphen
|
bgneal@1
|
119 checkFunction = function(e) { return (e.getAttribute(attrName).match(new RegExp('^'+attrValue+'-?'))); };
|
bgneal@1
|
120 break;
|
bgneal@1
|
121 case '^': // Match starts with value
|
bgneal@1
|
122 checkFunction = function(e) { return (e.getAttribute(attrName).indexOf(attrValue) == 0); };
|
bgneal@1
|
123 break;
|
bgneal@1
|
124 case '$': // Match ends with value - fails with "Warning" in Opera 7
|
bgneal@1
|
125 checkFunction = function(e) { return (e.getAttribute(attrName).lastIndexOf(attrValue) == e.getAttribute(attrName).length - attrValue.length); };
|
bgneal@1
|
126 break;
|
bgneal@1
|
127 case '*': // Match ends with value
|
bgneal@1
|
128 checkFunction = function(e) { return (e.getAttribute(attrName).indexOf(attrValue) > -1); };
|
bgneal@1
|
129 break;
|
bgneal@1
|
130 default :
|
bgneal@1
|
131 // Just test for existence of attribute
|
bgneal@1
|
132 checkFunction = function(e) { return e.getAttribute(attrName); };
|
bgneal@1
|
133 }
|
bgneal@1
|
134 currentContext = new Array;
|
bgneal@1
|
135 var currentContextIndex = 0;
|
bgneal@1
|
136 for (var k = 0; k < found.length; k++) {
|
bgneal@1
|
137 if (checkFunction(found[k])) {
|
bgneal@1
|
138 currentContext[currentContextIndex++] = found[k];
|
bgneal@1
|
139 }
|
bgneal@1
|
140 }
|
bgneal@1
|
141 // alert('Attribute Selector: '+tagName+' '+attrName+' '+attrOperator+' '+attrValue);
|
bgneal@1
|
142 continue; // Skip to next token
|
bgneal@1
|
143 }
|
bgneal@1
|
144 // If we get here, token is JUST an element (not a class or ID selector)
|
bgneal@1
|
145 tagName = token;
|
bgneal@1
|
146 var found = new Array;
|
bgneal@1
|
147 var foundCount = 0;
|
bgneal@1
|
148 for (var h = 0; h < currentContext.length; h++) {
|
bgneal@1
|
149 var elements = currentContext[h].getElementsByTagName(tagName);
|
bgneal@1
|
150 for (var j = 0; j < elements.length; j++) {
|
bgneal@1
|
151 found[foundCount++] = elements[j];
|
bgneal@1
|
152 }
|
bgneal@1
|
153 }
|
bgneal@1
|
154 currentContext = found;
|
bgneal@1
|
155 }
|
bgneal@1
|
156 return currentContext;
|
bgneal@1
|
157 }
|
bgneal@1
|
158
|
bgneal@1
|
159 /* That revolting regular expression explained
|
bgneal@1
|
160 /^(\w+)\[(\w+)([=~\|\^\$\*]?)=?"?([^\]"]*)"?\]$/
|
bgneal@1
|
161 \---/ \---/\-------------/ \-------/
|
bgneal@1
|
162 | | | |
|
bgneal@1
|
163 | | | The value
|
bgneal@1
|
164 | | ~,|,^,$,* or =
|
bgneal@1
|
165 | Attribute
|
bgneal@1
|
166 Tag
|
bgneal@1
|
167 */
|