Fascino

new Fascino()

Fascino, Encantador Framework JS para su fácil uso

Source: core.js, line 93

Extends

module:Core.Selector

Classes

Fascino

Methods

(static) addFn(name, fn) → {Fascino}

Añade funciones a Fascino

Parameters:

Name	Type	Description
`name`	String	Nombre de la función
`fn`	function	Función a asignar

Source: core.js, line 127

Returns:

Type:: Fascino

(static) border(val, pseudo) → {Object|Fascino}

Obtiene o Establece el relleno del Elemento dado

Parameters:

Name	Type	Description
`val`	String \| Number \| null	Valor del Elemento a establecer
`pseudo`	String	Important

Source: core.js, line 2072

Returns:

Type:: Object | Fascino

(static) margin(val, pseudo) → {Object|Fascino}

Obtiene o Establece el relleno del Elemento dado

Parameters:

Name	Type	Description
`val`	String \| Number \| null	Valor del Elemento a establecer
`pseudo`	String	Important

Source: core.js, line 2062

Returns:

Type:: Object | Fascino

(static) padding(val, pseudo) → {Object|Fascino}

Obtiene o Establece el relleno del Elemento dado

Parameters:

Name	Type	Description
`val`	String \| Number \| null	Valor del Elemento a establecer
`pseudo`	String	Important

Source: core.js, line 2052

Returns:

Type:: Object | Fascino

addClass(…arg) → {Fascino}

Agrega clases al elemento dado

Parameters:

Name	Type	Attributes	Description
`arg`	String	<repeatable>	Lista de clases separadas por coma(,)

Source: core.js, line 1186

Returns:

Type:: Fascino

Example

_$(mi-elem).addClass('miclass')
_$(mi-elem).addClass('miclass1', 'miclass2' /*...*\)

adopt() → {Array}

Transfiere un node desde otro document al documento del método

Source: core.js, line 706

Returns:

Type:: Array

after(html, position) → {Fascino}

Agrega un elemento o etiquetas HTML después del elemento dado

Parameters:

Name	Type	Default	Description
`html`	String \| Element
`position`	String	afterbegin	la posición equivale a afterbegin o afterend; @default afterbegin

Source: core.js, line 1067

Returns:

Type:: Fascino

append(node, options) → {Fascino}

Agrega un elemento al padre seleccionado

Parameters:

Name	Type	Description
`node`	Element \| Fascino \| String
`options`	Object

Source: core.js, line 565

Returns:

Type:: Fascino

appendTo(node, options) → {Fascino}

Agrega el elemento seleccionado al nuevo padre

Parameters:

Name	Type	Description
`node`	Element \| Fascino \| String
`options`	Object

Source: core.js, line 594

Returns:

Type:: Fascino

attr(…args) → {String|Array|Object|Fascino}

Obtiene o Establece los Atributos de un elemento

Parameters:

Name	Type	Attributes	Description
`args`	String \| Array \| Object \| function	<repeatable>

Source: core.js, line 1690

Returns:

Type:: String | Array | Object | Fascino

Example

Uso

miElement.attr('name', 'paswd') // Establece el Atributo Name a passwd
miElement.attr({
  id:'miElementID', // Establece el Id a miElementID y cambia el placeholder
  placeholder:'Escribe Aquí'
})
miElement.attr() // Re-establece los Atributos y retorna un NodeMap con ellos en caso de no poseer atributos retornara un Objecto Fascino
miElement.attr('name') // Retorna 'passwd' o false
miElement.attr(['name', 'id']) // Retorna un objecto {miElementID: {name: 'passwd', id:'miElementID'}}
// Ademas podemos pasar una función que se invocara dentro de un bucle que recorre los atributos
miElement.attr( function(attrName, attrValue, Attr) {
  console.log(
      this, // El Elemento iterado
      attrName, // El nombre del atributo
      attrValue, // El Valor del Attributo
      Attr // Lista de todos los atributos
)
})

before(html, position) → {Fascino}

Agrega un elemento o HTML antes del elemento dado

Parameters:

Name	Type	Default	Description
`html`	String \| Element
`position`	String	beforebegin	la posición equivale a beforebegin o beforeend; @default beforebegin

Source: core.js, line 1084

Returns:

Type:: Fascino

children(sel) → {Array}

Obtiene los hijos de un elemento

Parameters:

Name	Type	Description
`sel`	String \| Element	Selector o elemento hijo a buscar

Source: core.js, line 456

Returns:

Lista de hijos

Type:: Array

cleanAttr() → {Fascino}

Elimina todos los atributos de un elemento

Source: core.js, line 1827

Returns:

Type:: Fascino

clone(deep) → {Array}

Clona el elemento seleccionado

Parameters:

Name	Type	Default	Description
`deep`	Boolean	false	Verdadero si los hijos del nodo también deben ser clonados

Source: core.js, line 671

Returns:

Type:: Array

closest(sel) → {Fascino|Element|Array|Null}

Busca el ascendiente más cercano al elemento seleccionado

Parameters:

Name	Type	Description
`sel`	String \| Element	Selector del ascendiente a buscar

Source: core.js, line 828

Returns:

Type:: Fascino | Element | Array | Null

contains(s) → {Boolean}

Verifica si el elemento es hijo del Elemento seleccionado

Parameters:

Name	Type	Description
`s`	String \| Element	Selector CSS

Source: core.js, line 446

Returns:

Type:: Boolean

contents() → {Array}

Obtiene el contenido de un Iframe o Template

Source: core.js, line 719

Returns:

Type:: Array

data(…args) → {String|Array|Object|Fascino}

Establece u Obtiene los datos del Elemento Dataset

Parameters:

Name	Type	Attributes	Description
`args`	String \| Array \| Object	<repeatable>

Source: core.js, line 1857

Returns:

Type:: String | Array | Object | Fascino

Example

Uso

miElement.data('role', 'dialog')  // Establece el Rol a dialog
// Esteble al data-json al objecto dado
miElement.data({
  json:{
     a: 1,
     b: 2
}
})
miElement.data() // Retorna un Objecto con todos los datos del Atributo data
miElement.data('role') // Retorna Dialog
miElement.data(['role','json']) // Retornara un Objecto {miElementID: {role: 'dialog', json: {a:1,b:2}}}

each(…arg) → {Fascino}

Recorre los elementos

Parameters:

Name	Type	Attributes	Description
`arg`	function \| Array	<repeatable>	Argumentos

Source: core.js, line 270

Returns:

Type:: Fascino

emptyHtml() → {Fascino}

Vacía el contenido HTML de un elemento

Source: core.js, line 858

Returns:

Type:: Fascino

emptyVal() → {Fascino}

Vacía el valor de un elemento

Source: core.js, line 869

Returns:

Type:: Fascino

eq(i) → {Fascino}

Busca, valida y obtiene el elemento dado por su posición dentro de la matriz de elementos

Parameters:

Name	Type	Description
`i`	Number	posición del elemento

Source: core.js, line 357

Returns:

Type:: Fascino

even() → {Element|Fascino}

Obtiene los numero pares de la matriz

Source: core.js, line 415

Returns:

Type:: Element | Fascino

fadeIn(fn, time) → {Fascino}

Muestra un elemento con desvanecimiento suave

Parameters:

Name	Type	Default	Description
`fn`	function		Funcion a ejecutar despues del efecto
`time`	Number	600	Tiempo del desvanecimiento

Source: core.js, line 1608

Returns:

Type:: Fascino

fadeOut(fn, time) → {Fascino}

Funcion que Oculta con un desvanecimiento suave

Parameters:

Name	Type	Default	Description
`fn`	function		Función a ejecutar luego de ocultar
`time`	Number	600	Tiempo del desvanecimiento

Source: core.js, line 1644

Returns:

Type:: Fascino

filter(fn) → {Fascino}

Crea una nueva selección de elemento que cumplan con la condición dada en la función

Parameters:

Name	Type	Description
`fn`	function	Función para filtrar

Source: core.js, line 385

Returns:

Type:: Fascino

find(sel) → {Fascino}

Busca un elemento hijo por su selector CSS

Parameters:

Name	Type	Description
`sel`	String \| Element	Selector CSS valido

Source: core.js, line 428

Returns:

Type:: Fascino

fire(name, data) → {void|Fascino}

Dispara o Crea un Evento Personalizado

Parameters:

Name	Type	Description
`name`	String	Nombre del Evento
`data`	Object	Información del Evento

Source: core.js, line 1972

Returns:

Type:: void | Fascino

first() → {Element}

Obtiene el primer elemento de la matriz

Source: core.js, line 375

Returns:

Type:: Element

get(i) → {Element}

Obtiene el Elemento solicitado por su posición dentro de la matriz de Elementos, El Elemeto obtenido es de tipo Element

Parameters:

Name	Type	Description
`i`	Number	Posición

Source: core.js, line 344

Returns:

Type:: Element

getEvent(name, index) → {Object}

Obtiene las lista de eventos asignados aun elemento, si no se pasa ningun argumento se obtendran todos los eventos

Parameters:

Name	Type	Description
`name`	String	Nombre del Evento
`index`	Number	Posición del evento a buscar

Source: core.js, line 2046

Returns:

Type:: Object

hasAttr(attr) → {Boolean}

Verifica si el elemento tiene el atributo dado

Parameters:

Name	Type	Description
`attr`	String

Source: core.js, line 1790

Returns:

Type:: Boolean

hasClass(className) → {Boolean}

Verifica si el elemento posee una clase

Parameters:

Name	Type	Description
`className`	String	Nombre de la clase

Source: core.js, line 1236

Returns:

Verdadero si existe

Type:: Boolean

hasData(key) → {Boolean}

Verifica si el Elemento tiene un atributo data dado

Parameters:

Name	Type	Description
`key`	String	Nombre sin el data

Source: core.js, line 1884

Returns:

Type:: Boolean

height(val) → {Number|String|Fascino}

Obtiene o establece la altura del elemento

Parameters:

Name	Type	Description
`val`	Number \| String

Source: core.js, line 1531

Returns:

Type:: Number | String | Fascino

hide(callback) → {Fascino}

Oculta un ELemento y ejecuta la función dada

Parameters:

Name	Type	Description
`callback`	function

Source: core.js, line 1551

Returns:

Type:: Fascino

hover(fnOver, fnOut) → {Fascino}

Crea el evento hover

Parameters:

Name	Type	Description
`fnOver`	function	Función de entrada
`fnOut`	function	Función de Salida

Source: core.js, line 2035

Returns:

Type:: Fascino

html(html) → {Fascino|String}

Obtiene o Establece el contenido HTML del elemento seleccionado

Parameters:

Name	Type	Description
`html`	String \| Fascino \| Element

Source: core.js, line 1112

Returns:

Type:: Fascino | String

import(deep) → {Array}

Crea una copia de un nodo desde un documento externo

Parameters:

Name	Type	Default	Description
`deep`	Boolean	true	Verdadero si los hijos del nodo también deben ser importados

Source: core.js, line 690

Returns:

Type:: Array

index(parent, nodeName) → {Number}

Obtiene la posición del elemento dentro de su padre

Parameters:

Name	Type	Description
`parent`	Element \| Null	El padre de los Elementos
`nodeName`	String	tipo de nombre de nodo entre los cuales buscar

Source: core.js, line 319

Returns:

Type:: Number

innerHeight() → {Number}

Obtiene el Alto interno del elemento

Source: core.js, line 1521

Returns:

Type:: Number

innerWidth() → {Number}

Obtiene el Ancho interno del elemento

Source: core.js, line 1512

Returns:

Type:: Number

insertAfter(elements) → {Fascino}

Inserta un elemento después del elemento seleccionado

Parameters:

Name	Type	Description
`elements`	Element

Source: core.js, line 1042

Returns:

Type:: Fascino

insertBefore(elements) → {Fascino}

Inserta un elemento antes del elemento seleccionado

Parameters:

Name	Type	Description
`elements`	Element

Source: core.js, line 1018

Returns:

Type:: Fascino

is(s) → {Boolean}

Verifica de que tipo es el selector

Parameters:

Name	Type	Description
`s`	*

Source: core.js, line 473

Returns:

Type:: Boolean

last() → {Element}

Obtiene el ultimo elemento de la matriz

Source: core.js, line 366

Returns:

Type:: Element

left(v, m) → {String|Number|NaN}

Obtiene o Establece la posición horizontal del elemento

Parameters:

Name	Type	Default	Description
`v`	String \| Number		Nueva posición
`m`	Boolean	false	Si se debe incluir el margen

Source: core.js, line 1470

Returns:

Type:: String | Number | NaN

map(callback) → {Array}

Crea una nueva matriz de elementos a través de la función dada

Parameters:

Name	Type	Description
`callback`	function	Función

Source: core.js, line 297

Returns:

Type:: Array

matches(selectorString) → {Element|Array}

Verifica si el elemento es seleccionable por el Selector

Parameters:

Name	Type	Description
`selectorString`	String	Selector CSS

Source: core.js, line 281

Returns:

Type:: Element | Array

merge(els) → {Fascino}

Combina Elementos

Parameters:

Name	Type	Description
`els`	Array	Matriz de elementos nueva

Source: core.js, line 307

Returns:

Type:: Fascino

next(sel) → {Fascino|Array}

Obtiene o busca el hermano siguiente

Parameters:

Name	Type	Description
`sel`	String \| Element

Source: core.js, line 803

Returns:

Type:: Fascino | Array

odd() → {Element|Fascino}

Obtiene los elementos impares de la matriz

Source: core.js, line 403

Returns:

Type:: Element | Fascino

off(eventsList, sel, handler, options, ix) → {Fascino}

Desvincula el Evento para un elemento

Parameters:

Name	Type	Description
`eventsList`	String	El nombre del Evento
`sel`	String	Namespace o selector
`handler`	function	Función a ejecutar
`options`	Object	Opciones de AddEventListiner
`ix`	Number	Index del evento

Source: core.js, line 1945

Returns:

Type:: Fascino

offset(val) → {Object|Fascino}

Obtiene o Establece la posición del Elemento

Parameters:

Name	Type	Description
`val`	Object	Objeto {top,left}

Source: core.js, line 1393

Returns:

Type:: Object | Fascino

on(eventsList, sel, handler, options) → {Fascino}

Establece el Evento para un elemento
Si va usar eventos estándar es mejor que use los de la lista _$().click(), $().blur() ...

Parameters:

Name	Type	Description
`eventsList`	String \| Array	El nombre del Evento
`sel`	String	Namespace o selector
`handler`	function	Función a ejecutar
`options`	Object	Opciones de AddEventListiner

Source: core.js, line 1929

Returns:

Type:: Fascino

one(events, sel, handler, options) → {Fascino}

Ejecuta el evento solo para el primer evento dado

Parameters:

Name	Type	Description
`events`	String	El evento
`sel`	String	Namespace o selector
`handler`	function	Función a ejecutar
`options`	Object	Opciones de AddEventListiner

Source: core.js, line 1959

Returns:

Type:: Fascino

outerHeight(val) → {String|Number|Fascino}

Obtiene o Establece la Altura total del elemento

Parameters:

Name	Type	Description
`val`	String \| Number

Source: core.js, line 1383

Returns:

Type:: String | Number | Fascino

outerHTML() → {String}

Obtiene el HTML o envoltura del elemento dado

Source: core.js, line 1173

Returns:

Type:: String

outerWidth(val) → {String|Number|Fascino}

Obtiene o Establece el Ancho total del elemento

Parameters:

Name	Type	Description
`val`	String \| Number

Source: core.js, line 1373

Returns:

Type:: String | Number | Fascino

parent() → {Fascino}

Obtiene el padre del elemento

Source: core.js, line 764

Returns:

Type:: Fascino

parents(sel) → {Fascino}

Obtiene el o los padres de un elemento

Parameters:

Name	Type	Description
`sel`	String \| Element	Selector del padre a buscar

Source: core.js, line 743

Returns:

Lista de Padres

Type:: Fascino

position(margin) → {Object|Undefined}

Obtiene la Posición del elemento

Parameters:

Name	Type	Default	Description
`margin`	Boolean	false	Verdader si se incluye el margen

Source: core.js, line 1436

Returns:

Type:: Object | Undefined

prepend(node, options) → {Fascino}

Agrega un nuevo elemento al principio del padre seleccionado

Parameters:

Name	Type	Description
`node`	Element \| Fascino \| String
`options`	Object

Source: core.js, line 621

Returns:

Type:: Fascino

prependTo(node, options) → {Fascino}

Agrega el elemento seleccionado al nuevo padre

Parameters:

Name	Type	Description
`node`	Element \| Fascino
`options`	Object

Source: core.js, line 648

Returns:

Type:: Fascino

prev(sel) → {Fascino|Array}

Obtiene o busca el hermano anterior

Parameters:

Name	Type	Description
`sel`	String \| Element

Source: core.js, line 778

Returns:

Type:: Fascino | Array

prop(n, v) → {Fascino}

Método público de Fascino._prop

Parameters:

Name	Type	Description
`n`	String
`v`	String

Source: core.js, line 552

Returns:

Type:: Fascino

remove(sel) → {Array}

Elimina uno o todos los elementos del DOM

Parameters:

Name	Type	Description
`sel`	String \| Element \| Array	Selector a eliminar

Source: core.js, line 998

Returns:

Type:: Array

removeAttr(…args) → {Fascino}

Remueve los atributos dados

Parameters:

Name	Type	Attributes	Description
`args`	String	<repeatable>	Lista de Atributos

Source: core.js, line 1769

Returns:

Type:: Fascino

Example

miElement.removeAttr('style', 'name')

removeClass(…args) → {Fascino}

Elimina Clases del elemento seleccionado

Parameters:

Name	Type	Attributes	Description
`args`	String	<repeatable>

Source: core.js, line 1198

Returns:

Type:: Fascino

removeData(…keys) → {Fascino}

Remueve los Atributos data

Parameters:

Name	Type	Attributes	Description
`keys`	String	<repeatable>	Lista de nombres de data sin el data

Source: core.js, line 1872

Returns:

Type:: Fascino

Example

// <input id="miElement" data-role='pick' data-color="#fff">
_$('#miElement').removeData('role', 'color');
// Obtendremos
// <input id="miElement">

removeStyle(…name) → {Fascino}

Remueve todos o los estilos establecidos

Parameters:

Name	Type	Attributes	Description
`name`	String	<repeatable>	Lista de Stilo}

Source: core.js, line 1315

Returns:

Type:: Fascino

Example

miElement.removeStyle('border', 'color') // Removerá los estilos del border y el color

replaceClass(…args) → {Fascino}

Reemplaza una clase por otra

Parameters:

Name	Type	Attributes	Description
`args`	String	<repeatable>	Clase vieja clase nueva

Source: core.js, line 1224

Returns:

Type:: Fascino

Example

miElement.replaceClass('oldClass', 'NewClass')

scrollLeft(val) → {String|Number|Fascino}

Obtiene o estable el valor de la barra de desplazamiento Horizontal

Parameters:

Name	Type	Description
`val`	String \| Number

Source: core.js, line 1353

Returns:

Type:: String | Number | Fascino

scrollTop(val) → {String|Number|Fascino}

Obtiene o estable el valor de la barra de desplazamiento vertical

Parameters:

Name	Type	Description
`val`	String \| Number

Source: core.js, line 1333

Returns:

Type:: String | Number | Fascino

show(callback) → {Fascino}

Muestra un elemento y ejecuta la función dada

Parameters:

Name	Type	Description
`callback`	function

Source: core.js, line 1577

Returns:

Type:: Fascino

style(…arg) → {Fascino|Array|Object|String}

Agrega u Obtiene estilos CSS a los Elementos

Parameters:

Name	Type	Attributes	Description
`arg`	String \| Array \| Object	<repeatable>

Source: core.js, line 1257

Returns:

Type:: Fascino | Array | Object | String

Example

Uso

miElement.style('display', 'none') // establece la propiedad CSS a display none
miElement.style({
  border: '1px solid #ff0' // Establece un border Amarillo
  color: '#000' // y un color de texto Negro
})
miElement.style('display') // retorna none
miElement.style() // Retorna todos los Estilos establecidos(CSSStyleDeclaration)
miElement.style([
  'border', 'color' // Retorna un Objecto {IDfromMiElem: {border: '1px solid #ff0', color: '#000'}}
]) // Importante: si el elemento no tiene ID se le creara uno aleatorio