Utils

Conjunto de Utilidades

Grupo de Funciones Utiles para nuestros proyectos

Source: Utils/index.js, line 1

Namespaces

Colors

Members

(static, constant) exports.camelCase :function

CamelCase

Type:

function

Source: Utils/Utils.js, line 7

(static, constant) exports.defineProperty :function

Alias Object.defineProperty

Type:

function

Source: Utils/Utils.js, line 87

(static, constant) exports.gOPD :function

Alias Object.getOwnPropertyDescriptor

Type:

function

Source: Utils/Utils.js, line 93

(static, constant) exports.strValue :function

Alias String.prototype.valueOf

Type:

function

Source: Utils/Utils.js, line 60

(static, constant) exports.toStr :function

Alias Object.prototype.toString

Type:

function

Source: Utils/Utils.js, line 66

(static, constant) exports.tryStringObject

Valida String u Object

Source: Utils/Utils.js, line 74

Methods

(static) cleanPreCode(textContent) → {String}

Limpia un texto pre-codificado

Parameters:

Name	Type	Description
`textContent`	String	Texto

Source: Utils/Utils.js, line 848

Returns:

Type:: String

(static) createScript(script) → {Element}

Analiza y crea un nuevo elemento script que añada al body

Util para el uso de Ajax, y cargas de html en linea

Parameters:

Name	Type	Description
`script`	String \| Element \| Array

Source: Utils/Utils.js, line 595

Returns:

El nuevo Script

Type:: Element

(static) createURI(u) → {String}

Crea una uri a partir de un String

Parameters:

Name	Type	Description
`u`	String	Dirección o path a convertir

Source: Utils/Utils.js, line 901

Returns:

URI bien formateada

Type:: String

Example

_$.createURI('mifile.php')
// return --> https://domain.ext/path/mifile.php

(static) each(arr, callback, thisArg)

ForEach Personalizado.

Extiende la funcionalidad del forEach por defecto de los Array para todo tipo de elementos.

Para saber más visite forEach en Developer Mozilla

Parameters:

Name	Type	Description
`arr`	Object \| Array	El Objecto a iterar
`callback`	function	Función a ejecutar
`thisArg`	Object \| Array	Valor de la constante this

Source: Utils/Utils.js, line 552

(static) empty(arg) → {Boolean}

Verifica si la variable dada esta vaciá

Parameters:

Name	Type	Description
`arg`	*	Variable, Objecto, matriz etc.. a verificar

Source: Utils/Utils.js, line 350

Returns:

Verdadero si esta vació

Type:: Boolean

Example

let a
empty(a) // true
empty(0) // true
empty(0.0) // true
empty(false) // true
empty([]) // true
empty({}) // true
empty("") // true
empty() // true
empty(1) // false

(static) extend(…Argumentos) → {String|Object|Array}

Extiende un objeto o matriz y combinar sus elementos

Parameters:

Name	Type	Attributes	Description
`Argumentos`	*	<repeatable>	Lista de Objetos a iterar

Source: Utils/Utils.js, line 146

Returns:

retorna el elemento, o la unión de ellos

Type:: String | Object | Array

(static) formatBytes(bytes, decimals) → {String}

Transforma un Byte en su unidad correspondiente

Parameters:

Name	Type	Description
`bytes`	Number	Bytes a dar formato
`decimals`	Number	Cantidad de decimales a mostrar

Source: Utils/Utils.js, line 694

Returns:

Type:: String

(static) getStyleComputed(el, prop, pseudoElt) → {Array}

Obtiene los estilos computados del elemento

Parameters:

Name	Type	Description
`el`	Element	El Elemento
`prop`	String	La Propiedad
`pseudoElt`	String	PseudoElt

Source: Utils/Utils.js, line 408

Returns:

Type:: Array

(static) hasProp(obj, prop) → {Boolean}

Busca y valida la propiedad del objeto dato

Parameters:

Name	Type	Description
`obj`	Object	objeto a verificar
`prop`	String	propiedad a buscar

Source: Utils/Utils.js, line 310

Returns:

verdadero si la propiedad existe dentro del objeto

Type:: Boolean

(static) htmlEntities(str) → {String}

Genera una cadena HTML codificada para mostrar en pre o navegador

Parameters:

Name	Type	Description
`str`	String	Cadena de código Html

Source: Utils/Utils.js, line 831

Returns:

Type:: String

Example

<div>
  <pre></pre>
  <script>
  _$("pre").html(_$.htmlEntities("<section><h2>Hola Mundo</h2></section>"))
  </script>
</div>

(static) isArray() → {Boolean}

Verifica si es una Array

Source: Utils/Utils.js, line 95

Returns:

Type:: Boolean

(static) isArrayish(obj) → {Boolean}

Verifica si es una Matriz

Parameters:

Name	Type	Description
`obj`	*

Source: Utils/Utils.js, line 256

Returns:

Verdadero si es un array

Type:: Boolean

(static) isElement(el) → {Boolean}

Verifica si es un elemento

Parameters:

Name	Type	Description
`el`	*

Source: Utils/Utils.js, line 442

Returns:

Verdadero si el es un Elemento del DOM

Type:: Boolean

(static) isFascinoElement(el) → {Boolean}

Verifica si es un Elemento Fascino

Parameters:

Name	Type	Description
`el`	*

Source: Utils/Utils.js, line 462

Returns:

Verdadero si es un elemento de Fascino o _$

Type:: Boolean

(static) isFunction(fn) → {Boolean}

Verifica si es una función

Parameters:

Name	Type	Description
`fn`	*

Source: Utils/Utils.js, line 289

Returns:

verdadero si es una función

Type:: Boolean

(static) isHiden(el) → {Boolean}

Verifica si el elemento esta oculto

Parameters:

Name	Type	Description
`el`	String \| Element

Source: Utils/Utils.js, line 515

Returns:

Verdadero si esta oculto

Type:: Boolean

(static) isNumber(num) → {Boolean}

Verifica si es un número

Parameters:

Name	Type	Description
`num`	*

Source: Utils/Utils.js, line 272

Returns:

verdadero si es un tipo numérico

Type:: Boolean

(static) isObject(obj) → {Boolean}

Verifica si es un objecto

Parameters:

Name	Type	Description
`obj`	*

Source: Utils/Utils.js, line 236

Returns:

verdadero si es un objecto

Type:: Boolean

(static) isSelector(selector) → {Boolean}

Verifica si es un selector valido

Parameters:

Name	Type	Description
`selector`	String

Source: Utils/Utils.js, line 331

Returns:

Verdadero si es un selector

Type:: Boolean

(static) isString(value) → {Boolean}

Verifica si es un texto valido

Parameters:

Name	Type	Description
`value`	*

Source: Utils/Utils.js, line 217

Returns:

verdadero si es un string

Type:: Boolean

(static) isURL(u) → {Boolean}

Valida una URL

Parameters:

Name	Type	Description
`u`	String \| URL	URI a validar

Source: Utils/Utils.js, line 525

Returns:

Type:: Boolean

(static) isVisible(el) → {Boolean}

Verifica si el elemento es visible en el DOM

Parameters:

Name	Type	Description
`el`	String \| Element

Source: Utils/Utils.js, line 480

Returns:

Verdadero si es visible

Type:: Boolean

(static) jsonToFormdata(obj) → {FromData}

Convierte un Objecto JSON a u objecto del tipo FromData

Parameters:

Name	Type	Description
`obj`	Object	El Objecto

Source: Utils/Utils.js, line 933

Returns:

Type:: FromData

(static) merge(n1, n2) → {Array}

Combinar 2 array

Parameters:

Name	Type	Description
`n1`	Array	Matriz n1
`n2`	Array	Matriz n2

Source: Utils/Utils.js, line 535

Returns:

El array resultante

Type:: Array

(static) normalizeData(data) → {Object}

Convierte los datos tipo texto JSON pasados por atributos a un objecto valido

Parameters:

Name	Type	Description
`data`	String

Source: Utils/Utils.js, line 779

Returns:

El objeto JSON

Type:: Object

(static) normalizeElements(s) → {Object|Element|Array|undefined}

Valida y obtiene un elemento dado

Parameters:

Name	Type	Description
`s`	String \| Array \| Fascino

Source: Utils/Utils.js, line 793

Returns:

El elemento en su expresión para su uso

Type:: Object | Element | Array | undefined

(static) normName(name) → {String|void}

Regula y normaliza el nombre de un atributo, función, o variable para su uso en Javascript

Parameters:

Name	Type	Description
`name`	String	variable

Source: Utils/Utils.js, line 684

Returns:

el nombre normalizado o indefinido

Type:: String | void

(static) not(arg) → {Boolean}

Verifica si la variable dada no es nula o indefinida

Parameters:

Name	Type	Description
`arg`	*	Variable

Source: Utils/Utils.js, line 398

Returns:

verdadero si esta nula o indefinida

Type:: Boolean

(static) parseHTML(data) → {Element|Array}

Esta función recibe una etiqueta e intenta crear un Object HTMLElement de la misma

Parameters:

Name	Type	Description
`data`	String	el texto HTML

Source: Utils/Utils.js, line 648

Returns:

El nuevo objeto o una matriz

Type:: Element | Array

(static) random(min, max) → {Number}

Genera un numero aleatorio entre rangos

Parameters:

Name	Type	Description
`min`	Number \| Undefined	Número minino
`max`	Number \| Undefined	Número máximo

Source: Utils/Utils.js, line 735

Returns:

Resultado aleatorio

Type:: Number

(static) randomMap(arr) → {Number|*}

Obtiene un valor Aleatorio de una Matriz o un Objeto

Parameters:

Name	Type	Description
`arr`	Object \| String	Matriz u Objecto

Source: Utils/Utils.js, line 753

Returns:

Valor de la Matriz u Objecto o -1 si no tiene éxito

Type:: Number | *

(static) script(el) → {void}

Normaliza y busca los elementos Script

Parameters:

Name	Type	Description
`el`	Element	El elemento script o padre del Script

Source: Utils/Utils.js, line 628

Returns:

Type:: void

(static) SetOptinsOfData(el, defaults) → {Object}

Establece opciones por defecto a los Simple plugins

Parameters:

Name	Type	Description
`el`	Element \| Fascino \| String	Elemento
`defaults`	Object	Opciones por defecto

Source: Utils/Utils.js, line 714

Returns:

Nuevas Opciones

Type:: Object

(static) strToArr(str, separator) → {Array}

Transforma una cadena de texto en una matriz

Parameters:

Name	Type	Description
`str`	String	La cadena
`separator`	String	El separador

Source: Utils/Utils.js, line 882

Returns:

Type:: Array

(static) template(html, options, conf) → {String}

Mini Motor de plantillas javascript

Parameters:

Name	Type	Description
`html`	String	Código HTML de la plantilla
`options`	Object	Opciones de plantilla para reemplazar
`conf`	Object	Configuraciones del motor

Source: Utils/Template.js, line 5

Returns:

Type:: String

Example

Uso

var html = `
   <div class='alert alert<%this.type%>' role="alert">
      <%this.content%>
   </div>
`;
var options = {
   type: 'info',
   content:'This is Alerts'
}

document.write(_$.template(html,options))

(static) toString(arg) → {Boolean|String}

Extensión de [object|function|array|string].toString([native])

Parameters:

Name	Type	Description
`arg`	string	tipo que contiene la función toString

Source: Utils/Utils.js, line 321

Returns:

El resultado del toString o falso

Type:: Boolean | String

(static) uniqueId(prefix) → {String}

Genera un Identificador único basado en la fecha y hora actual

Parameters:

Name	Type	Description
`prefix`	String	Prefijo del identificador

Source: Utils/Utils.js, line 815

Returns:

Identificador

Type:: String

(static) url(urlBase, params) → {URL}

Construye una URL valida para la API fetch o XMLHttpRequest

Parameters:

Name	Type	Description
`urlBase`	String	URL
`params`	Object	Conjunto de parametros de URLSearchParams

Source: Utils/Utils.js, line 917

Returns:

API URL

Type:: URL