-
Notifications
You must be signed in to change notification settings - Fork 0
/
DOM.helpers.js
363 lines (322 loc) · 8.07 KB
/
DOM.helpers.js
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
/**
* @function tag
*
* A Function for Locating Elements by Tag Name Within an HTML DOM Document
*
* @param name {Element} element, default `document`
* @param elem {String} tag name
*
* @returns {Array} Elements collection
**/
function tag( name, elem ) {
// If the context element is not provided, search the whole document
return ( elem || document ).getElementsByTagName( name );
}
/**
* @function hasAttribute
*
* Determining Whether an Element Has a Certain Attribute
*
* @param elem {Element} element, default `document`
* @param name {String} class name
*
* @returns {Boolean} true/false
**/
function hasAttribute ( elem, name ) {
return elem.getAttribute( name ) !== null;
}
/**
* @function attr
*
* Getting and Setting the Values of Element Attributes
*
* @param elem {Element} element
* @param name {String} attribute name
* @param value {String} attribute value
*
* @returns {Boolean} true/false
**/
function attr( elem, name, value ) {
// Make sure that a valid name was provided
if ( !name || name.constructor != String ) return '';
// Figure out if the name is one of the weird naming cases
name = {
'for' : 'htmlFor',
'class' : 'className'
}[ name ] || name;
// If the user is setting a value, also
if ( typeof value != 'undefined' ) {
// Set the quick way first
elem[ name ] = value;
// If we can, use setAttribute()
if ( elem.setAttribute ) {
elem.setAttribute( name, value );
}
}
// Return the value of the attribute
return elem[ name ] || elem.getAttribute( name ) || '';
}
/**
* @function cleanWhitespace
*
* A Workaround for the White-Space Bug in XML Documents
*
* @param element {Element} element, default `document`
*
**/
function cleanWhitespace( element ) {
// If no element is provided, do the whole HTML document
element = element || document;
// Use the first child as a starting point
var cur = element.firstChild;
// Go unitl there are no more child nodes
while ( cur !== null ) {
// If the node is a text node, and it contains nothing but whitespace
if( cur.nodeType == 3 && ! /\S/.test( cur.nodeValue ) ) {
// Remove the text node
element.removeChild( cur );
// Otherwise, if it's an element
} else if ( cur.nodeType == 1 ) {
// Recurse down through the document
cleanWhitespace( cur );
}
cur = cur.nextSibling; // Move through the child nodes
}
}
/**
* @function prev
*
* A Function for Finding the Previous Sibling Element in Relation to an Element
*
* @param elem {Element} HTML element
*
**/
function prev( elem ) {
do {
elem = elem.previousSibling;
} while ( elem && elem.nodeType != 1 );
return elem;
}
/**
* @function prev
*
* A Function for Finding the Next Sibling Element in Relation to an Element
*
* @param elem {Element} HTML element
*
**/
function next( elem ) {
do {
elem = elem.nextSibling;
} while ( elem && elem.nodeType != 1 );
return elem;
}
/**
* @function first
*
* A Function for Finding the First Child Element of an Element
*
* @param elem {Element} HTML element
*
**/
function first( elem ) {
elem = elem.firstChild;
return elem && elem.nodeType != 1 ? next( elem ) : elem;
}
/**
* @function last
*
* A Function for Finding the Last Child Element of an Element
*
* @param elem {Element} HTML element
*
**/
function last( elem ) {
elem = elem.lastChild;
return elem && elem.nodeType != 1 ? prev( elem ) : elem;
}
/**
* @function parent
*
* A Function for Finding the the Parent of an Element
*
* @param elem {Element} HTML element
*
**/
function parent( elem, num ) {
num = num || 1;
for ( var i = 0; i < num; i += 1 ) {
if ( elem !== null ) {
elem = elem.parentNode;
}
}
return elem;
}
/**
* @function hasClass
*
* A Function That Searches fo All Elements That Have a Particular Class Name
*
* @param name {String} class name
* @param type {Element} HTML element
*
**/
function hasClass( name, type ) {
var r = [];
// Locate the class name (allows for multiple class names)
var re = new RegExp( '(^|\\s)' + name + '(\\s|$)' );
// Limit search by type, or look through all elements
var e = document.getElementsByTagName( type || '*' );
for( var j = 0; j < e.length; j++ ) {
// If the element has the class, add it to return
var str = e[ j ].getAttribute( 'class' );
if( re.test( str ) ) {
r.push( e[ j ] );
}
}
return r;
}
/**
* @function text
*
* A Generic Function for Treiving the Text Contents of an Element
*
* @param element {Element} HTML element
*
**/
function text( element ) {
var txt = '';
// If an element was passed, get its children,
// otherwise assume it's an array
element = element.childNodes || element;
// Look through all child nodes
for ( var j = 0; j < element.length; j++ ) {
// If it's not an element, append its text value
// Otherwise, recurse through all the element's children
txt += element[ j ].nodeType != 1 ? element[ j ].nodeValue : text( element[ j ].childNodes );
}
// Return the matched text
return txt;
}
/**
* @function create
*
* A Generic Function for Creating a New DOM Element
*
* @param elem {Element} HTML element
*
* @returns {Element} HTML Element
**/
function create( elem ) {
//return document.createElementNS ? document.createElementNS( 'http://www.w3.org/1999/xhtml', elem ) : document.createElement( elem );
if ( document.createElementNS ) {
return document.createElementNS( 'http://www.w3.org/1999/xhtml', elem );
}
return document.createElement( elem );
}
/**
* @function checkElem
*
* A Helper Function for Converting an Array of Mixed DOM Node/HTML String Arguments into a
* Pure Array of DOM Nodes
*
* @param elem {Element} HTML Element
*
* @returns {Element} HTML Element
**/
function checkElem( elem ) {
var r = [];
// Force the argument into an array, if it isn't already
if ( elem.constructor != Array ) {
elem = [ elem ];
}
for ( var i = 0; i < elem.length; i++ ) {
// If there is a String
if ( elem[ i ].constructor == String ) {
// Create a temporary element to house the HTML
var div = document.createElement( 'div' );
// Inject the HTML, to convert it into a DOM structure
div.innerHTML = elem[ i ];
// Extract the DOM Structure back out of the temp div
for ( var j = 0; j < div.childNodes.length; j++ ) {
r[ r.length ] = div.childNodes[ j ];
}
} else if ( elem[ i ].length ) {
// if it's an array Assum that it's an array of DOM Nodes
for ( var k = 0; k < elem[ i ].length; k++ ) {
r[ r.length ] = elem[ i ][ k ];
}
} else {
// Otherwise, assume it's a DOM Node
r[ r.length ] = elem[ i ];
}
}
return r;
}
/**
* @function before
*
* A Function for Inserting an Element Before Another Element
*
* @param parent {Element} HTML Elements
* @param before {Element} HTML Element
* @param elem {Element} HTML Element
*
**/
function before( parent, before, elem ) {
// Check if no parent node was provided
if ( elem == null ) {
elem = before;
before = parent;
parent = before.parentNode;
}
// Get the new array of elements
var elems = checkElem( elem );
// Move through the array backwards, because we're prepending elments
for ( var i = elems.length - 1; i >= 0; i-- ) {
parent.insertBefore( elems[ i ], before );
}
}
/**
* @function append
*
* A Function for Appending an Element As a Child of Another Element
*
* @param parent {Element} HTML Elements
* @param elem {Element} HTML Element
*
**/
function append( parent, elem ) {
// Get the array of elements
var elems = checkElem( elem );
// Append them all to the element
for ( var i = 0; i <= elems.length; i++ ) {
parent.appendChild( elems[ i ] );
}
}
/**
* @function remove
*
* A Function for Removing a Node from the DOM
*
* @param elem {Element} HTML Element
*
**/
function remove( elem ) {
if ( elem ) {
elem.parentNode.removeChild( elem );
}
}
/**
* @function empty
*
* A Function for Removing All Child Nodes from an Element
*
* @param elem {Element} HTML Element
*
**/
function empty( elem ) {
while ( elem.firstChild ) {
remove( elem.firstChild );
}
}