1.8.0 • Published 7 years ago

@cnbritain/merlin-frontend-utils-js v1.8.0

Weekly downloads
15
License
ISC
Repository
github
Last release
7 years ago

Modules

detect

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)

Adds a class to an element

Kind: static method of functions

ParamType
elHTMLNode
clsString

functions.addEvent(el, type, fn)

Adds an event to an element

Kind: static method of functions

ParamType
elHTMLNode
typeString
fnfunction

functions.addEventOnce(el, type, fn)

Adds an event that will fire once and then remove itself

Kind: static method of functions

ParamType
elHTMLNode
typeString
fnfunction

functions.addHtml(node)

Adds html to a node

Kind: static method of functions

ParamType
nodeHTMLElement

functions.ajax(options) ⇒ Promise

Basic ajax function

Kind: static method of functions

ParamType
optionsObject

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

ParamType
minNumber
maxNumber
value1Number

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

Creates an object for events

Kind: static method of functions

ParamTypeDescription
typeStringThe type of event
targetObjectThe thing that emitted the event
eventDataObjectSome data

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

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

Kind: static method of functions

ParamTypeDescription
fnfunction
waitNumberNumber of milliseconds
scopeObject
immediateBoolean

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

Creates a function that will delegate events to a selector

Kind: static method of functions

ParamType
selectorString
fnfunction
ctx*

functions.exitFullscreen(el)

Exits fullscreen mode for the element

Kind: static method of functions

ParamType
elHTMLNode

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

Fires an event on an element

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

ParamTypeDescription
elHTMLElement
typeStringThe type of event
bubbleBooleanShould the event bubble?
cancelableBooleanShould the event be cancelable?

functions.forEachShift(collection, fn)

Loop over a collection and shift the item from the collection

Kind: static method of functions

ParamType
collectionArray
fnfunction

functions.getElementOffset(el) ⇒ Object

Gets the elements offset. Based off of jquerys implementation

Kind: static method of functions

ParamType
elHTMLNode

functions.getEventTarget(e) ⇒ *

Gets the event target

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

ParamTypeDescription
eObjectThe event information

functions.getIframeFromWindow(window) ⇒ HTMLNode/Boolean

Gets the iframe element based on the window

Kind: static method of functions

ParamType
windowWindow

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

ParamType
elHTMLNode
selectorString

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

ParamType
elHTMLElement
selectorString

functions.getParentUntil(el, selector) ⇒ Object

Gets the parent till the selector or the root.

Kind: static method of functions

ParamType
elHTMLNode
selectorString

functions.getPreviousElementUntil(el, selector) ⇒ Object

Gets the previous element till the selector or the root

Kind: static method of functions

ParamType
elHTMLNode
selectorString

functions.getScrollLeft(el) ⇒ Number

Gets the scroll left of the element

Kind: static method of functions

ParamType
elHTMLNode/Window

functions.getScrollTop(el) ⇒ Number

Gets the scroll top of the element

Kind: static method of functions

ParamType
elHTMLNode/Window

functions.getNamespaceKey(abbr) ⇒ String

Creates a key based on the brand abbreviation

Kind: static method of functions

ParamType
abbrString

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

ParamType
elHTMLNode
clsString

functions.hasOwnProperty(obj, key) ⇒ Boolean

hasOwnProperty that prevents contamination from the object being tested

Kind: static method of functions

ParamType
objObject
keyString

functions.insertBefore(child, ref) ⇒ HTMLElement

Inserts the child element before the reference

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

ParamType
childHTMLElement
refHTMLElement

functions.isArticleAdSlot(placement) ⇒ Boolean

Checks if the placement is in an article slot

Kind: static method of functions

ParamType
placementString

functions.isDefined(value) ⇒ Boolean

Checks if a value is defined

Kind: static method of functions

ParamType
value*

functions.isEmptyString(value) ⇒ Boolean

Checks if the value is an empty string

Kind: static method of functions

ParamType
value*

functions.isHeaderAdSlot(placement) ⇒ Boolean

Checks if the placement is a header slot

Kind: static method of functions

ParamType
placementString

functions.isSplashAdSlot(placement) ⇒ Boolean

Checks if the placement is a splash slot

Kind: static method of functions

ParamType
placementString

functions.isWindow(win) ⇒ Boolean

Checks if win is a window element

Kind: static method of functions

ParamType
win*

functions.loadScript(url, options) ⇒ Promise

Loads a script file into the page

Kind: static method of functions

ParamType
urlString
optionsObject

functions.loadSocialScripts() ⇒ Promise

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

Kind: static method of functions

functions.not(value) ⇒ Boolean

Inverts the value

Kind: static method of functions

ParamType
value*

functions.onPageLoad(loadFn)

Runs loadFn once the page has loaded

Kind: static method of functions

ParamType
loadFnfunction

functions.onPageReady(readyFn)

Runs readyFn once the page is ready

Kind: static method of functions

ParamType
readyFnfunction

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

Pads a number

Kind: static method of functions

ParamType
valueNumber
widthNumber
chrString

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

ParamType
elHTMLNode
clsString

functions.removeElement(el)

Removes the element from the tree

Kind: static method of functions

ParamType
elHTMLElement

functions.removeEvent(el, type, fn)

Removes an event from an element

Kind: static method of functions

ParamType
elHTMLNode
typeString
fnfunction

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

Throttles an event being fired by the threshold

Kind: static method of functions

ParamTypeDescription
fnfunction
threshholdNumberMilliseconds to throttle by
scopeObject

functions.toBoolean(value) ⇒ Boolean

Converts a value to a boolean

Kind: static method of functions

ParamType
value*

functions.toggleClass(el, cls)

Toggles a class on an element

Kind: static method of functions

ParamType
elHTMLNode
clsString

functions.unescapeJinjaValue(value) ⇒ *

Unescapes a value from jinja

Kind: static method of functions

ParamType
value*