@cnbritain/merlin-www-js-utils v3.0.1

Modules

detect

• detect
  • .getUserAgent ⇒ Object
  • .hasHistory : Boolean
  • .hasTouch : Boolean
  • .isAndroid : Boolean
  • .isIOS : Boolean
  • .isLinux : Boolean
  • .isMac : Boolean
  • .isWindows : Boolean
  • .supportBoxModel ⇒ Boolean
  • .supportsHTML5Video ⇒ Boolean

detect.getUserAgent ⇒ Object

Creates an object with user agent information

Kind: static property of detect
Url: http://stackoverflow.com/questions/5916900/how-can-you-detect-the-version-of-a-browser

detect.hasHistory : Boolean

window.history support

Kind: static property of detect

detect.hasTouch : Boolean

Touch support

Kind: static property of detect

detect.isAndroid : Boolean

Android useragent sniff

Kind: static property of detect

detect.isIOS : Boolean

iOS useragent sniff

Kind: static property of detect

detect.isLinux : Boolean

Linux useragent sniff

Kind: static property of detect

detect.isMac : Boolean

Macintoch useragent sniff

Kind: static property of detect

detect.isWindows : Boolean

Windows useragent sniff

Kind: static property of detect

detect.supportBoxModel ⇒ Boolean

Box model support

Kind: static property of detect

detect.supportsHTML5Video ⇒ Boolean

HTML5 video support

Kind: static property of detect

functions

• functions
  • .addClass(el, cls)
  • .addEvent(el, type, fn)
  • .addEventOnce(el, type, fn)
  • .addHtml(node)
  • .ajax(options) ⇒ Promise
  • .assign(target, ...source) ⇒ Object
  • .clamp(min, max, value1) ⇒ Number/Function
  • .cloneArray(src) ⇒ Array
  • .cloneArrayDeep(src) ⇒ Array
  • .cloneObject(src) ⇒ Object
  • .cloneObjectDeep(src) ⇒ Object
  • .createEventTemplate(type, target, eventData) ⇒ Object
  • .debounce(fn, wait, scope, immediate) ⇒ function
  • .delegate(selector, fn, ctx) ⇒ function
  • .exitFullscreen(el)
  • .fireEvent(el, type, bubble, cancelable) ⇒ Boolean
  • .forEachShift(collection, fn)
  • .getElementOffset(el) ⇒ Object
  • .getEventTarget(e) ⇒ *
  • .getIframeFromWindow(window) ⇒ HTMLNode/Boolean
  • .getObjectValues(obj, keys) ⇒ Array.<*>
  • .getParent(el, selector) ⇒ HTMLNode/Boolean
  • .getPrevious(el, selector) ⇒ HTMLElement/Boolean
  • .getParentUntil(el, selector) ⇒ Object
  • .getPreviousElementUntil(el, selector) ⇒ Object
  • .getScrollLeft(el) ⇒ Number
  • .getScrollTop(el) ⇒ Number
  • .getNamespaceKey(abbr) ⇒ String
  • .getWindowScrollLeft() ⇒ Number
  • .getWindowScrollTop() ⇒ Number
  • .hasClass(el, cls) ⇒ Boolean
  • .hasOwnProperty(obj, key) ⇒ Boolean
  • .inherit(src, props) ⇒ Object
  • .insertBefore(child, ref) ⇒ HTMLElement
  • .isArray(src) ⇒ Boolean
  • .isArticleAdSlot(placement) ⇒ Boolean
  • .isDefined(value) ⇒ Boolean
  • .isEmptyString(value) ⇒ Boolean
  • .isElement(value) ⇒ Boolean
  • .isHeaderAdSlot(placement) ⇒ Boolean
  • .isObject(src) ⇒ Boolean
  • .isSplashAdSlot(placement) ⇒ Boolean
  • .isWindow(win) ⇒ Boolean
  • .loadScript(url, options) ⇒ Promise
  • .loadSocialScripts() ⇒ Promise
  • .not(value) ⇒ Boolean
  • .onPageLoad(loadFn)
  • .onPageReady(readyFn)
  • .padValue(value, width, chr) ⇒ String
  • .randomUUID() ⇒ String
  • .removeClass(el, cls)
  • .removeElement(el)
  • .removeEvent(el, type, fn)
  • .throttle(fn, threshhold, scope) ⇒ function
  • .toBoolean(value) ⇒ Boolean
  • .toggleClass(el, cls)
  • .unescapeJinjaValue(value) ⇒ *

functions.addClass(el, cls)

Adds a class to an element

Kind: static method of functions

functions.addEvent(el, type, fn)

Adds an event to an element

Kind: static method of functions

functions.addEventOnce(el, type, fn)

Adds an event that will fire once and then remove itself

Kind: static method of functions

functions.addHtml(node)

Adds html to a node

Kind: static method of functions

functions.ajax(options) ⇒ Promise

Basic ajax function

Kind: static method of functions

functions.assign(target, ...source) ⇒ Object

Assigns the values of the other sources to the target

Kind: static method of functions

functions.clamp(min, max, value1) ⇒ Number/Function

Clamps a value to the min and max. Also set up to allow currying.

Kind: static method of functions

functions.cloneArray(src) ⇒ Array

Clones an array

Kind: static method of functions

functions.cloneArrayDeep(src) ⇒ Array

Clones an array while recursively cloning the items inside

Kind: static method of functions

functions.cloneObject(src) ⇒ Object

Clones an object

Kind: static method of functions

functions.cloneObjectDeep(src) ⇒ Object

Clones an object whilst recursively cloning the descendants

Kind: static method of functions

functions.createEventTemplate(type, target, eventData) ⇒ Object

Creates an object for events

Kind: static method of functions

functions.debounce(fn, wait, scope, immediate) ⇒ function

Debounce function, allows one function to be ran wait milliseconds after.

Kind: static method of functions

functions.delegate(selector, fn, ctx) ⇒ function

Creates a function that will delegate events to a selector

Kind: static method of functions

functions.exitFullscreen(el)

Exits fullscreen mode for the element

Kind: static method of functions

functions.fireEvent(el, type, bubble, cancelable) ⇒ Boolean

Fires an event on an element

Kind: static method of functions
Returns: Boolean - Was the event cancelled?

functions.forEachShift(collection, fn)

Loop over a collection and shift the item from the collection

Kind: static method of functions

functions.getElementOffset(el) ⇒ Object

Gets the elements offset. Based off of jquerys implementation

Kind: static method of functions

functions.getEventTarget(e) ⇒ *

Gets the event target

Kind: static method of functions
Returns: * - The target of the event

functions.getIframeFromWindow(window) ⇒ HTMLNode/Boolean

Gets the iframe element based on the window

Kind: static method of functions

functions.getObjectValues(obj, keys) ⇒ Array.<*>

Gets the values from an object. If keys are specified, it will only get the values of those keys.

Kind: static method of functions

functions.getParent(el, selector) ⇒ HTMLNode/Boolean

Gets the parent element matching the selector. If it doesn't match, returns nothing

Kind: static method of functions

functions.getPrevious(el, selector) ⇒ HTMLElement/Boolean

Gets the previous element matching the selector. If it doesn't match, returns false

Kind: static method of functions

functions.getParentUntil(el, selector) ⇒ Object

Gets the parent till the selector or the root.

Kind: static method of functions

functions.getPreviousElementUntil(el, selector) ⇒ Object

Gets the previous element till the selector or the root

Kind: static method of functions

functions.getScrollLeft(el) ⇒ Number

Gets the scroll left of the element

Kind: static method of functions

functions.getScrollTop(el) ⇒ Number

Gets the scroll top of the element

Kind: static method of functions

functions.getNamespaceKey(abbr) ⇒ String

Creates a key based on the brand abbreviation

Kind: static method of functions

functions.getWindowScrollLeft() ⇒ Number

Gets the scrollleft of the window

Kind: static method of functions

functions.getWindowScrollTop() ⇒ Number

Gets the scrolltop of the window

Kind: static method of functions

functions.hasClass(el, cls) ⇒ Boolean

Checks if the element has a class

Kind: static method of functions

functions.hasOwnProperty(obj, key) ⇒ Boolean

hasOwnProperty that prevents contamination from the object being tested

Kind: static method of functions

functions.inherit(src, props) ⇒ Object

Creates a new object based from src. Then copies over any properties.

Kind: static method of functions

functions.insertBefore(child, ref) ⇒ HTMLElement

Inserts the child element before the reference

Kind: static method of functions
Returns: HTMLElement - The child

functions.isArray(src) ⇒ Boolean

Checks if the src is an array

Kind: static method of functions

functions.isArticleAdSlot(placement) ⇒ Boolean

Checks if the placement is in an article slot

Kind: static method of functions

functions.isDefined(value) ⇒ Boolean

Checks if a value is defined

Kind: static method of functions

functions.isEmptyString(value) ⇒ Boolean

Checks if the value is an empty string

Kind: static method of functions

functions.isElement(value) ⇒ Boolean

Checks if the value is an element

Kind: static method of functions

functions.isHeaderAdSlot(placement) ⇒ Boolean

Checks if the placement is a header slot

Kind: static method of functions

functions.isObject(src) ⇒ Boolean

Checks if the src is an object

Kind: static method of functions

functions.isSplashAdSlot(placement) ⇒ Boolean

Checks if the placement is a splash slot

Kind: static method of functions

functions.isWindow(win) ⇒ Boolean

Checks if win is a window element

Kind: static method of functions

functions.loadScript(url, options) ⇒ Promise

Loads a script file into the page

Kind: static method of functions

functions.loadSocialScripts() ⇒ Promise

Loads any social scripts. Includes twitter, facebook, vine, instagram and imgur

Kind: static method of functions

functions.not(value) ⇒ Boolean

Inverts the value

Kind: static method of functions

functions.onPageLoad(loadFn)

Runs loadFn once the page has loaded

Kind: static method of functions

functions.onPageReady(readyFn)

Runs readyFn once the page is ready

Kind: static method of functions

functions.padValue(value, width, chr) ⇒ String

Pads a number

Kind: static method of functions

functions.randomUUID() ⇒ String

Generates a random id

Kind: static method of functions

functions.removeClass(el, cls)

Removes a class from an element

Kind: static method of functions

functions.removeElement(el)

Removes the element from the tree

Kind: static method of functions

functions.removeEvent(el, type, fn)

Removes an event from an element

Kind: static method of functions

functions.throttle(fn, threshhold, scope) ⇒ function

Throttles an event being fired by the threshold

Kind: static method of functions

functions.toBoolean(value) ⇒ Boolean

Converts a value to a boolean

Kind: static method of functions

functions.toggleClass(el, cls)

Toggles a class on an element

Kind: static method of functions

functions.unescapeJinjaValue(value) ⇒ *

Unescapes a value from jinja

Kind: static method of functions