Documentation

Utils

isEmpty #

Arguments
el	`Node` `Element` `Dom`

Returns: Boolean

Check if the node or element has empty content.

var is = this.utils.isEmpty(el);

isEmptyHtml #

Arguments
html	`String`

Returns: Boolean

Check as follows: if HTML contains nothing but spaces, empty tags and br tags, then the HTML string is empty.

var is = this.utils.isEmptyHtml(html);

getChildNodes #

Arguments
el	`Node` `Element` `Dom`

Returns: Array

Return all child nodes (with text nodes) from the element recursively.

var nodes = this.utils.getChildNodes(el);

getChildElements #

Arguments
el	`Node` `Element` `Dom`

Returns: Array

Return all child nodes (without text nodes) from the element recursively.

var elements = this.utils.getChildElements(el);

getFirstNode #

Arguments
el	`Node` `Element` `Dom`

Returns: Node

Return the first node (maybe a text node) from the element.

var node = this.utils.getFirstNode(el);

getLastNode #

Arguments
el	`Node` `Element` `Dom`

Returns: Node

Return the last node (maybe a text node) from the element.

var node = this.utils.getLastNode(el);

getFirstElement #

Arguments
el	`Node` `Element` `Dom`

Returns: Element

Return the first element (not a text node) from the element.

var element = this.utils.getFirstElement(el);

getLastElement #

Arguments
el	`Node` `Element` `Dom`

Returns: Element

Return the last element (not a text node) from the element.

var element = this.utils.getLastElement(el);

createTmpContainer #

Arguments
html	`String` `Nodelist` `Node` `Element` `Dom`

Returns: Element

Create a temporary div container that will contain the specified html. It can get both a string and DOM elements. Returns the created Dom element.

var container = this.utils.createTmpContainer(html);

createFragment #

Arguments
html	`String` `Nodelist` `Node` `Element` `Dom`

Returns: Object

Create the object from HTML or nodelist/node/element with following data:

frag - documentFragment;
nodes - the array of nodes in the fragment;
first - the first node in the fragment;
last - the last node in the fragment.

var frag = this.utils.createFragment(html);
console.log(frag.nodes);

isFragment #

Arguments
frag	`Object`

Returns: Boolean

Check if the passed object is the fragment which created with utils. createFragment method.

var isFragment = this.utils.isFragment(frag);

parseHtml #

Arguments
html	`String` `Nodelist` `Node` `Element` `Dom`

Returns: Object

Create the object from HTML or nodelist/node/element with following data:

html - HTML string
nodes - Dom nodes from the passed argument.

var data = this.utils.parseHtml('<p>my html</p>');
var data = this.utils.parseHtml(node);
console.log(data.html, data.nodes);

ucfirst #

Arguments
str	`String`

Returns: String

Make the first letter of the string is upper case.

var str = this.utils.ucfirst('mystring'); // return 'Mystring'

removeFromArrayByValue #

Arguments
arr	`Array`
value	`Mixed`

Returns: Array

Remove item from the specified array by value.

' var arr = this.utils.removeFromArrayByValue([2, 3, 1], 1);
// returns [2, 3];

removeEmptyAttr #

Arguments
el	`Node` `Element` `Dom`
name	`String`

Returns: Boolean

Remove an attribute from the specified element if it has an empty value.

Return true if the value was empty and the attribute is removed, or if the element does not have such one.

Return false if the value was not empty and the attribute was not removed.

var isRemoved = this.utils.removeEmptyAttr(el, 'style');

cloneAttributes #

Arguments
elFrom	`Node` `Element` `Dom`
elTo	`Node` `Element` `Dom`

Returns: Node

Clone the attributes of one element to another. Return the element to which the attributes were cloned.

var elTo = this.utils.cloneAttributes(elFrom, elTo);

normalizeTextNodes #

Arguments
el	`Node` `Element` `Dom`

Glue text nodes into one in the element.

this.utils.normalizeTextNodes(el);

isRgb #

Arguments
str	`String`

Returns: Boolean

Check if the string is the RGB color string.

var isRgb = this.utils.isRgb('rgb(0, 0, 0);'); // true
var isRgb = this.utils.isRgb('rgba(255, 255, 255, .5);'); // true

rgb2hex #

Arguments
str	`String`

Returns: String

Return the RGB color string to the HEX one.

var hex = this.utils.rgb2hex('rgb(0, 0, 0);'); // #000000
var hex = this.utils.rgb2hex('rgba(255, 255, 255, .5);'); // #ffffff

replaceToTag #

Arguments
el	`Node` `Element` `Dom`
tag	`String`

Returns: Object

Replace the tag of passed element to the specified one with cloning all attributes. Returns the wrapped Dom object.

var $span = this.utils.replaceToTag(el, 'span');

toParams #

Arguments
obj	`Object`

Returns: String

Return the sring like 'key1: value1; key2: value2;' from params object.

var obj = { color: 'red', 'font-weight': 'bold' };
var str = this.utils.toParams(obj);
// returns 'color:red;font-weight:bold;'

styleToObj #

Arguments
str	`String`

Returns: Object

Return the object with params from the CSS style string.

var el = document.getElementById('my-element');
var obj = this.utils.styleToObj(el.getAttribute('style'));

checkProperty #

Arguments
obj	`Object`
level1 ... levelN	`String` `Array`

Returns: Boolean

Check for the existence of keys in the most deeply nested objects.

var is = this.utils.checkProperty(obj, 'level1', 'level2', 'propertyname');
var is = this.utils.checkProperty(obj, ['level1', 'level2', 'propertyname']);

escapeRegExp #

Arguments
str	`String`

Returns: String

Return the escaped regular expression string.

var escapedRegExpString= this.utils.escapeRegExp(str);

extendData #

Arguments
data	`Object`
extraData	`Object`

Extend an object with values, including values in the input and form fields if the additional object has key elements with field and form selectors.

The values of the input and form fields are appended as values: field-name: value.

var data = {
    name: 'my-name'
};

var extraData = {
        id: 10,
        elements: '#my-input-1, #my-input-2, #my-form'
};

data = this.utils.extendData(data, extraData);

Services

Utils