- 01
- 02
- 03
- 04
- 05
- 06
- 07
- 08
- 09
- 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
/**
* Queries the DOM for the HTML element based on selector string passed.
* @param {String} selector Selector we are querying for.
* @param {String} [parent] Parent is optional, if passed the function will look for a child element of that parent.
* @param {Boolean} [returnEmptyList] If set to true the function won't throw an error even if the element is not found.
* @return {Array} HTML objects.
*/
function getEl( selector, parent, returnEmptyList )
{
var classOnly,
match,
elPrefix,
selPrefix,
context,
safeNode,
nodes;
classOnly = /^\.([\w\-]+)$/;
match = classOnly.exec( selector );
elPrefix = '.js-';
selPrefix = selector.substring( 0, 4 );
if ( ( selPrefix !== elPrefix || !typeCheck.isString( selector ) ) && match !== null )
{
throw new Error( 'Please make sure you input a valid class name that begins with a proper prefix.' );
}
if ( typeCheck.isString( parent ) )
{
context = document.getElementsByClassName( parent.substring( 1 ) )[ 0 ];
}
else if ( typeCheck.isElement( parent ) )
{
context = parent;
}
else
{
context = document;
}
nodes = match === null ? context.querySelectorAll( selector ) : context.getElementsByClassName( match[ 1 ] );
safeNode = nodes.length > 0 && nodes;
if ( safeNode || !safeNode && returnEmptyList )
{
return [].slice.call( nodes ); //converts it to a proper array.
}
else
{
throw new Error( 'Element with selector "' + selector + '" does not exist on the page.' );
}
}