var nyc = nyc || {};
/**
* @public
* @namespace
*/
nyc.util = {
/**
* @desc Check if browser is IE
* @public
* @static
* @function
* @returns {boolean}
*/
isIe: function(){
return 'ActiveXObject' in window;
},
/**
* @desc Check if OS is iOS
* @public
* @static
* @function
* @returns {boolean}
*/
isIos: function(){
return navigator.userAgent.match(/(iPad|iPhone|iPod|iOS)/g) != null;
},
/**
* @desc Check if OS is Android
* @public
* @static
* @function
* @returns {boolean}
*/
isAndroid: function(){
return navigator.userAgent.match(/(Android)/g) != null;
},
/**
* @desc Check if user agent is mobile
* @public
* @static
* @function
* @returns {boolean}
*/
isMobile: function(){
return nyc.util.isIos() || nyc.util.isAndroid() || navigator.userAgent.match(/(Mobile)/g) != null;
},
/**
* @desc Check if browser is Safari
* @public
* @static
* @function
* @returns {boolean}
*/
isSafari: function(){
return navigator.userAgent.indexOf('Safari') != -1 && navigator.userAgent.indexOf('Chrome') == -1;
},
/**
* @desc Format numeric HTML content to locale specific number format
* @public
* @static
* @function
* @param {nyc.util.FormatNumberHtmlOptions} options The options for formatting numbers
* @returns {JQuery} The elements that have been formatted
*/
formatNumberHtml: function(options){
var elems = $(options.elements);
if ('toLocaleString' in Number){
elems.each(function(_, n){
var num = $(n).html();
if (num.trim()){
var opts = options.options || {};
if (!options.options && num.indexOf('.') > -1){
opts = {style:"decimal", minimumFractionDigits: 4};
}
if (!isNaN(num) && navigator.language){
var lang = options.lang || navigator.language;
num = new Number(num).toLocaleString(lang, opts);
$(n).html(num);
}
}
});
}
return elems;
},
/**
* @desc Format HTML content to locale specific date format
* @public
* @static
* @function
* @param {nyc.util.FormatDateHtmlOptions} options The options for formatting dates
* @returns {JQuery} The elements that have been formatted
*/
formatDateHtml: function(options){
var elems = $(options.elements);
if ('toLocaleString' in Date){
elems.each(function(_, n){
var date = $(n).html();
if (date.trim()){
var opts = options.options || {};
var lang = options.lang || navigator.language;
try{
date = new Date(date).toLocaleString(lang, opts);
$(n).html(date);
}catch(ignore){}
}
});
}
return elems;
},
/**
* @desc A click event handler for HTML elements that will not fire twice on certain mobile devices
* @public
* @static
* @function
* @param {JQuery.Event} event The event object
* @param {function(Object)} handler The event handler function
* @param {Object=} scope The scope in which to invoke the event handler
*/
preventDblEventHandler: function(event, handler, scope){
var target = $(event.target), last = target.data('last-click'), now = new Date().getTime();
if ((last * 1) + 600 < now || !last){
if (scope){
handler.apply(scope, [event]);
}else{
handler(event);
}
}
target.data('last-click', now);
},
/**
* @desc A function to pad values
* @public
* @static
* @function
* @param {string|number} val The value to pad
* @param {number} len The length of the padded result
* @param {string} [chr=0] The padding character
* @return {string}
*/
pad: function(val, len, chr) {
var str = val + '';
while (str.length < len) {
str = (chr || '0') + str;
}
return str;
},
/**
* @desc A function format phone numbers
* @public
* @static
* @function
* @param {string} phone The phone number
* @return {string}
*/
formatPhone: function(phone) {
var formatted = ('' + phone).replace(/[^a-zA-Z0-9.]+/g, '');
if (formatted.length < 10){
return phone;
}
if (formatted.length > 10){
if (formatted.length == 11 && formatted.substr(0, 1)){
formatted = formatted.substr(1);
}else{
return phone;
}
}
return '(' + formatted.substr(0, 3) + ') ' + formatted.substr(3, 3) + '-' + formatted.substr(6, 4);
}
};
/**
* @desc Object type to hold arguments for {@link nyc.util.formatNumberHtml}
* @public
* @typedef {Object}
* @property {JQuery|string} elements The HTML elements to format
* @property {string=} lang The language code for formatting
* @property {Object=} options The options for Number#toLocaleString {@see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/toLocaleString}
*/
nyc.util.FormatNumberHtmlOptions;
/**
* @desc Object type to hold arguments for {@link nyc.util.formatDateHtml}
* @public
* @typedef {Object}
* @property {JQuery|string} elements The HTML elements to format
* @property {string=} lang The language code for formatting
* @property {Object=} options The options for Date#toLocaleString {@see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toLocaleString}
*/
nyc.util.FormatDateHtmlOptions;