Examples of how to do query, style, dom, ajax, event etc like jQuery with plain javascript.
MIT License
El desarrollo Frontend evoluciona día a día, y los navegadores modernos ya han implementado nativamente APIs para trabajar con DOM/BOM, las cuales son muy buenas, por lo que definitivamente no es necesario aprender jQuery desde cero para manipular el DOM. En la actualidad, gracias al surgimiento de librerías frontend como React, Angular y Vue, manipular el DOM es contrario a los patrones establecidos, y jQuery se ha vuelto menos importante. Este proyecto resume la mayoría de métodos alternativos a jQuery, pero de forma nativa con soporte IE 10+.
En lugar de los selectores comunes como clase, id o atributos podemos usar document.querySelector
o document.querySelectorAll
como alternativas. Las diferencias radican en:
document.querySelector
devuelve el primer elemento que cumpla con la condicióndocument.querySelectorAll
devuelve todos los elementos que cumplen con la condición en forma de NodeList. Puede ser convertido a Array usando [].slice.call(document.querySelectorAll(selector) || []);
[]
mientras la API DOM retornaría null
. Nótese el NullPointerException. Se puede usar ||
para establecer el valor por defecto al no encontrar elementos, como en document.querySelectorAll(selector) || []
Nota: document.querySelector y document.querySelectorAll son bastante LENTOS, procuree utilizar getElementById, document.getElementsByClassName o document.getElementsByTagName si desea obtener un mejor rendimiento.
1.0 Buscar por selector
// jQuery
$('selector');
// Nativo
document.querySelectorAll('selector');
1.1 Buscar por Clase
// jQuery
$('.class');
// Nativo
document.querySelectorAll('.class');
// Forma alternativa
document.getElementsByClassName('class');
1.2 Buscar por id
// jQuery
$('#id');
// Nativo
document.querySelector('#id');
// Forma alternativa
document.getElementById('id');
1.3 Buscar por atributo
// jQuery
$('a[target=_blank]');
// Nativo
document.querySelectorAll('a[target=_blank]');
1.4 Buscar en descendientes
// jQuery
$el.find('li');
// Nativo
el.querySelectorAll('li');
1.5 Elementos Hermanos/Previos/Siguientes
Elementos hermanos
// jQuery
$el.siblings();
// Nativo
Array.prototype.filter.call(el.parentNode.children, (child) =>
child !== el
);
Elementos previos
// jQuery
$el.prev();
// Nativo
el.previousElementSibling;
Elementos siguientes
// jQuery
$el.next();
// Nativo
el.nextElementSibling;
1.6 Más cercano
Retorna el elemento más cercano que coincida con la condición, partiendo desde el nodo actual hasta document.
// jQuery
$el.closest(selector);
// Nativo - Sólo el último, NO IE
el.closest(selector);
// Nativo - IE10+
function closest(el, selector) {
const matchesSelector = el.matches || el.webkitMatchesSelector || el.mozMatchesSelector || el.msMatchesSelector;
while (el) {
if (matchesSelector.call(el, selector)) {
return el;
} else {
el = el.parentElement;
}
}
return null;
}
1.7 Padres hasta
Obtiene los ancestros de cada elemento en el set actual de elementos que cumplan con la condición, sin incluir el actual
// jQuery
$el.parentsUntil(selector, filter);
// Nativo
function parentsUntil(el, selector, filter) {
const result = [];
const matchesSelector = el.matches || el.webkitMatchesSelector || el.mozMatchesSelector || el.msMatchesSelector;
// Partir desde el elemento padre
el = el.parentElement;
while (el && !matchesSelector.call(el, selector)) {
if (!filter) {
result.push(el);
} else {
if (matchesSelector.call(el, filter)) {
result.push(el);
}
}
el = el.parentElement;
}
return result;
}
1.8 Formularios
Input/Textarea
// jQuery
$('#my-input').val();
// Nativo
document.querySelector('#my-input').value;
Obtener el índice de e.currentTarget en .radio
// jQuery
$('.radio').index(e.currentTarget);
// Nativo
Array.prototype.indexOf.call(document.querySelectorAll('.radio'), e.currentTarget);
1.9 Contenidos de Iframe
$('iframe').contents()
devuelve contentDocument
para este iframe específico
Contenidos de Iframe
// jQuery
$iframe.contents();
// Nativo
iframe.contentDocument;
Buscar dentro de un Iframe
// jQuery
$iframe.contents().find('.css');
// Nativo
iframe.contentDocument.querySelectorAll('.css');
1.10 Obtener body
// jQuery
$('body');
// Nativo
document.body;
1.11 Obtener y establecer atributos
Obtener un atributo
// jQuery
$el.attr('foo');
// Nativo
el.getAttribute('foo');
Establecer un atributo
// jQuery, note que esto funciona en memoria sin cambiar el DOM
$el.attr('foo', 'bar');
// Nativo
el.setAttribute('foo', 'bar');
Obtener un atributo data-
// jQuery
$el.data('foo');
// Nativo
el.getAttribute('data-foo');
// Nativo (Utilice `dataset` solamente si necesita dar soporte a IE 11+)
el.dataset['foo'];
2.1 CSS
Obtener Estilo
// jQuery
$el.css("color");
// Nativo
// NOTA: Bug conocido, retornará 'auto' si el valor de estilo es 'auto'
const win = el.ownerDocument.defaultView;
// null significa que no retorne pseudo estilos
win.getComputedStyle(el, null).color;
Establecer estilo
// jQuery
$el.css({ color: "#ff0011" });
// Nativo
el.style.color = '#ff0011';
Obtener/Establecer Estilos
Nótese que si se desea establecer múltiples estilos a la vez, se puede utilizar el método setStyles en el paquete oui-dom-utils.
Agregar clase
// jQuery
$el.addClass(className);
// Nativo
el.classList.add(className);
Quitar Clase
// jQuery
$el.removeClass(className);
// Nativo
el.classList.remove(className);
Consultar si tiene clase
// jQuery
$el.hasClass(className);
// Nativo
el.classList.contains(className);
Toggle class
// jQuery
$el.toggleClass(className);
// Nativo
el.classList.toggle(className);
2.2 Width & Height
Ancho y Alto son teóricamente idénticos. Usaremos el Alto como ejemplo:
Alto de Ventana
// alto de ventana
$(window).height();
// Con scrollbar, se comporta como jQuery
window.document.documentElement.clientHeight;
// Sin scrollbar
window.innerHeight;
Alto de Documento
// jQuery
$(document).height();
// Native
const body = document.body;
const html = document.documentElement;
const height = Math.max(
body.offsetHeight,
body.scrollHeight,
html.clientHeight,
html.offsetHeight,
html.scrollHeight
);
Alto de Elemento
// jQuery
$el.height();
// Nativo
function getHeight(el) {
const styles = window.getComputedStyle(el);
const height = el.offsetHeight;
const borderTopWidth = parseFloat(styles.borderTopWidth);
const borderBottomWidth = parseFloat(styles.borderBottomWidth);
const paddingTop = parseFloat(styles.paddingTop);
const paddingBottom = parseFloat(styles.paddingBottom);
return height - borderBottomWidth - borderTopWidth - paddingTop - paddingBottom;
}
// Precisión de entero(para `border-box`, es `height - border`; con content-box`, es `height + padding`)
el.clientHeight;
// Precisión de decimal(para `border-box`, es `height`; con `content-box`, es `height + padding + border`)
el.getBoundingClientRect().height;
2.3 Posición y Offset
Posición
Obtiene las coordenadas actuales del elemento, en relación con el padre.
// jQuery
$el.position();
// Nativo
{ left: el.offsetLeft, top: el.offsetTop }
Offset
Obtiene las coordenadas actuales del elemento, en relación con el documento.
// jQuery
$el.offset();
// Nativo
function getOffset (el) {
const box = el.getBoundingClientRect();
return {
top: box.top + window.pageYOffset - document.documentElement.clientTop,
left: box.left + window.pageXOffset - document.documentElement.clientLeft
}
}
2.4 Posición vertical del scroll
Obtiene la posición vertical actual de la barra de scroll para el elemento.
// jQuery
$(window).scrollTop();
// Nativo
(document.documentElement && document.documentElement.scrollTop) || document.body.scrollTop;
3.1 Eliminar
Elimina el elemento del DOM
// jQuery
$el.remove();
// Nativo
el.parentNode.removeChild(el);
3.2 Texto
Obtener Texto
Obtiene los contenidos de texto combinado del elemento, incluyendo sus decendientes.
// jQuery
$el.text();
// Nativo
el.textContent;
Establecer Texto
Establece el contenido del elemento al texto especificado
// jQuery
$el.text(string);
// Nativo
el.textContent = string;
3.3 HTML
Obtener HTML
// jQuery
$el.html();
// Nativo
el.innerHTML;
Establecer HTML
// jQuery
$el.html(htmlString);
// Nativo
el.innerHTML = htmlString;
3.4 Añadir al final
Añadir elemento hijo después del último hijo del elemento padre
// jQuery
$el.append('<div id="container">Hello World</div>');
// Nativo (string de HTML)
el.insertAdjacentHTML('beforeend', '<div id="container">Hello World</div>');
// Nativo (Elemento)
el.appendChild(newEl);
3.5 Añadir al inicio
// jQuery
$el.prepend('<div id="container">Hello World</div>');
// Nativo (String HTML)
el.insertAdjacentHTML('afterbegin', '<div id="container">Hello World</div>');
// Nativo (Elemento)
el.insertBefore(newEl, el.firstChild);
3.6 Insertar Antes
Insertar un nuevo nodo antes de los elementos seleccionados
// jQuery
$newEl.insertBefore(selector);
// Nativo (String HTML)
el.insertAdjacentHTML('beforebegin ', '<div id="container">Hello World</div>');
// Native (Elemento)
const el = document.querySelector(selector);
if (el.parentNode) {
el.parentNode.insertBefore(newEl, el);
}
3.7 Insertar después
Insertar un nuevo nodo después de los elementos seleccionados
// jQuery
$newEl.insertAfter(selector);
// Nativo (String HTML)
el.insertAdjacentHTML('afterend', '<div id="container">Hello World</div>');
// Nativo (Elemento)
const el = document.querySelector(selector);
if (el.parentNode) {
el.parentNode.insertBefore(newEl, el.nextSibling);
}
3.8 es
Retorna true
si coincide con el selector de la búsqueda
// jQuery - Nota `is` también funciona con `funciones` o `elementos` que no veremos aquí
$el.is(selector);
// Nativo
el.matches(selector);
3.9 Clonar
Crea una copia profunda del elemento
// jQuery
$el.clone();
// Nativo
el.cloneNode();
// Para hacer copia profunda , establece como parametro `true`
3.10 Vaciar
Elimina todos los nodos hijo
// jQuery
$el.empty();
// Nativo
el.innerHTML = '';
3.11 Envolver
Crea una estructura HTML alrededor de cada elemento
// jQuery
$('.inner').wrap('<div class="wrapper"></div>');
// Nativo
Array.prototype.forEach.call(document.querySelectorAll('.inner'), (el) => {
const wrapper = document.createElement('div');
wrapper.className = 'wrapper';
el.parentNode.insertBefore(wrapper, el);
el.parentNode.removeChild(el);
wrapper.appendChild(el);
});
3.12 Desenvolver
Elimina los padres de una serie de elementos seleccionados del DOM
// jQuery
$('.inner').unwrap();
// Nativo
Array.prototype.forEach.call(document.querySelectorAll('.inner'), (el) => {
Array.prototype.forEach.call(el.childNodes, (child) => {
el.parentNode.insertBefore(child, el);
});
el.parentNode.removeChild(el);
});
3.13 Remplazar con
Remplaza cada elemento en una serie de elementos seleccionados con nuevo contenido.
// jQuery
$('.inner').replaceWith('<div class="outer"></div>');
// Nativo
Array.prototype.forEach.call(document.querySelectorAll('.inner'), (el) => {
const outer = document.createElement('div');
outer.className = 'outer';
el.parentNode.insertBefore(outer, el);
el.parentNode.removeChild(el);
});
+Fetch API es el nuevo estándar que reemplaza a XMLHttpRequest para efectuar peticiones AJAX. Funciona en Chrome y Firefox, como también es posible usar un polyfill en otros navegadores.
Es una buena alternativa utilizar github/fetch en IE9+ o fetch-ie8 en IE8+, fetch-jsonp para efectuar peticiones JSONP.
4.1 Carga datos desde un servidor y coloca el HTML regresado en el elemento seleccionado.
// jQuery
$(selector).load(url, completeCallback)
// Nativo
fetch(url).then(data => data.text()).then(data => {
document.querySelector(selector).innerHTML = data
}).then(completeCallback)
Para un reemplazo completo con namespace y delegación, utilizar https://github.com/oneuijs/oui-dom-events
5.0 Document ready by DOMContentLoaded
// jQuery
$(document).ready(eventHandler);
// Nativo
// Verifica que DOMContentLoaded ya se ha completado
if (document.readyState !== 'loading') {
eventHandler();
} else {
document.addEventListener('DOMContentLoaded', eventHandler);
}
5.1 Asignar un evento con "on"
// jQuery
$el.on(eventName, eventHandler);
// Nativo
el.addEventListener(eventName, eventHandler);
5.2 Desasignar un evento con "off"
// jQuery
$el.off(eventName, eventHandler);
// Nativo
el.removeEventListener(eventName, eventHandler);
5.3 Trigger
// jQuery
$(el).trigger('custom-event', {key1: 'data'});
// Nativo
if (window.CustomEvent) {
const event = new CustomEvent('custom-event', {detail: {key1: 'data'}});
} else {
const event = document.createEvent('CustomEvent');
event.initCustomEvent('custom-event', true, true, {key1: 'data'});
}
el.dispatchEvent(event);
La mayoría de las utilidades se encuentran en la API nativa. Otras funciones avanzadas podrían por utilidades de librerías que se centran en la consistencia y rendimiento. Se recomienda lodash como replazo.
6.1 Utilidades Básicas
Determina si el lemento es un vector(array).
// jQuery
$.isArray(array);
// Nativo
Array.isArray(array);
Determina si el argumento en una ventana(window).
// jQuery
$.isWindow(obj);
// Nativo
function isWindow(obj) {
return obj !== null && obj !== undefined && obj === obj.window;
}
Busca un valor específico en el array y retorna su índice (o -1 si no lo encuentra).
// jQuery
$.inArray(item, array);
// Nativo
array.indexOf(item) > -1;
// ES6
array.includes(item);
Determina si el argumento es un número.
Utiliza typeof
para decidir el tipo del type
ejemplo para mayor precisión.
// jQuery
$.isNumeric(item);
// Nativo
function isNumeric(value) {
var type = typeof value;
return (type === 'number' || type === 'string') && !Number.isNaN(value - Number.parseFloat(value));
}
Determina si el argumento es objecto función de Javascript.
// jQuery
$.isFunction(item);
// Nativo
function isFunction(item) {
if (typeof item === 'function') {
return true;
}
var type = Object.prototype.toString(item);
return type === '[object Function]' || type === '[object GeneratorFunction]';
}
Verifica que un objeto esté vacío(contiene propiedades no enumerables).
// jQuery
$.isEmptyObject(obj);
// Nativo
function isEmptyObject(obj) {
return Object.keys(obj).length === 0;
}
Verifica si un objeto es un objeto plano (creado utilizando “{}” o “new Object”).
// jQuery
$.isPlainObject(obj);
// Nativo
function isPlainObject(obj) {
if (typeof (obj) !== 'object' || obj.nodeType || obj !== null && obj !== undefined && obj === obj.window) {
return false;
}
if (obj.constructor &&
!Object.prototype.hasOwnProperty.call(obj.constructor.prototype, 'isPrototypeOf')) {
return false;
}
return true;
}
Combina los contenidos de dos o mas objetos en el primer objeto. object.assign es una API de ES6, puedes utilizar polyfill también.
// jQuery
$.extend({}, defaultOpts, opts);
// Nativo
Object.assign({}, defaultOpts, opts);
Elimina los espacios en blanco del inicio y final de un string.
// jQuery
$.trim(string);
// Nativo
string.trim();
Traslada todos los elementos en un arreglo u objeto a un nuevo arreglo de elementos.
// jQuery
$.map(array, (value, index) => {
});
// Nativo
array.map((value, index) => {
});
Una función genérica de iteración, que puede ser utilizada de manera similar para iterar en objetos o arreglos.
// jQuery
$.each(array, (index, value) => {
});
// Nativo
array.forEach((value, index) => {
});
Encuentra los elementos de un arreglo que satisfacen una función filtro.
// jQuery
$.grep(array, (value, index) => {
});
// Nativo
array.filter((value, index) => {
});
Determina la clase [Class] interna de Javascript de un objeto.
// jQuery
$.type(obj);
// Nativo
function type(item) {
const reTypeOf = /(?:^\[object\s(.*?)\]$)/;
return Object.prototype.toString.call(item)
.replace(reTypeOf, '$1')
.toLowerCase();
}
Combina los contenidos de dos o mas arreglos en el primero.
// jQuery
$.merge(array1, array2);
// Nativo
// Pero la función concat no elimina elementos duplicados.
function merge(...args) {
return [].concat(...args)
}
Retorna un número que representa la hora actual.
// jQuery
$.now();
// Native
Date.now();
Toma una función y regresa una nueva que siempre tendrá un contexto particular.
// jQuery
$.proxy(fn, context);
// Nativo
fn.bind(context);
Convierte un objeto similar a un arreglo en un verdarero arreglo de Javascript.
// jQuery
$.makeArray(arrayLike);
// Nativo
Array.prototype.slice.call(arrayLike);
// ES6
Array.from(arrayLike);
6.2 Contenedores
Verifica si un elemento del DOM es descendiente de otro elemento del DOM.
// jQuery
$.contains(el, child);
// Nativo
el !== child && el.contains(child);
6.3 Globaleval
Ejecuta el mismo código Javascript de manera global.
// jQuery
$.globaleval(code);
// Nativo
function Globaleval(code) {
const script = document.createElement('script');
script.text = code;
document.head.appendChild(script).parentNode.removeChild(script);
}
// Utilzando eval, pero el contexto de eval es el actual, el contexto de $.Globaleval es global.
eval(code);
6.4 parse
Parsea un string ien un arreglo de nodos DOM.
// jQuery
$.parseHTML(htmlString);
// Nativo
function parseHTML(string) {
const context = document.implementation.createHTMLDocument();
// Se establece la base href para el documento creado, así todos los elementos parseados con URLs
// estarán basados en ña URL del documento
const base = context.createElement('base');
base.href = document.location.href;
context.head.appendChild(base);
context.body.innerHTML = string;
return context.body.children;
}
Toma un string de JSON bien formado y retorna el valor resultante de Javascript.
// jQuery
$.parseJSON(str);
// Native
JSON.parse(str);
Una promesa, representa el resultado eventual de una operación asíncrona. jQuery tiene su propio sistema para utilizar promesas. JavaScript nativo implementa una ligera y mínima API para utilizar promesas de acuerdo con la especificación Promises/A+.
7.1 done, fail, always
done
se llama cuando una promesa se resuelve, fail
se llama cuando una promesa es rechazada, always
se llama cuando una promesa no ha sido resuelta o rechazada.
// jQuery
$promise.done(doneCallback).fail(failCallback).always(alwaysCallback)
// Nativo
promise.then(doneCallback, failCallback).then(alwaysCallback, alwaysCallback)
7.2 when
when
se utiliza para manipular múltiples promesas. Se resolverá cuando todas las promesas sean resueltas y se rechazará si alguna es rechazada.
// jQuery
$.when($promise1, $promise2).done((promise1Result, promise2Result) => {
});
// Nativo
Promise.all([$promise1, $promise2]).then([promise1Result, promise2Result] => {});
7.3 Deferred
Deferred es una manera de crear promesas.
// jQuery
function asyncFunc() {
const defer = new $.Deferred();
setTimeout(() => {
if(true) {
defer.resolve('some_value_computed_asynchronously');
} else {
defer.reject('failed');
}
}, 1000);
return defer.promise();
}
// Nativo
function asyncFunc() {
return new Promise((resolve, reject) => {
setTimeout(() => {
if (true) {
resolve('some_value_computed_asynchronously');
} else {
reject('failed');
}
}, 1000);
});
}
// Deferred
function defer() {
const deferred = {};
const promise = new Promise((resolve, reject) => {
deferred.resolve = resolve;
deferred.reject = reject;
});
deferred.promise = () => {
return promise;
};
return deferred;
}
function asyncFunc() {
const defer = defer();
setTimeout(() => {
if(true) {
defer.resolve('some_value_computed_asynchronously');
} else {
defer.reject('failed');
}
}, 1000);
return defer.promise();
}
8.1 Mostrar y ocultar
// jQuery
$el.show();
$el.hide();
// Native
// Para mas detalles acerca del método show, refierase a https://github.com/oneuijs/oui-dom-utils/blob/master/src/index.js#L363
el.style.display = ''|'inline'|'inline-block'|'inline-table'|'block';
el.style.display = 'none';
8.2 Toggle
Muestra u oculta el elemento
// jQuery
$el.toggle();
// Nativo
if (el.ownerDocument.defaultView.getComputedStyle(el, null).display === 'none') {
el.style.display = ''|'inline'|'inline-block'|'inline-table'|'block';
} else {
el.style.display = 'none';
}
8.3 FadeIn & FadeOut
// jQuery
$el.fadeIn(3000);
$el.fadeOut(3000);
// Nativo
el.style.transition = 'opacity 3s';
// fadeIn
el.style.opacity = '1';
// fadeOut
el.style.opacity = '0';
8.4 FadeTo
Ajusta la opacidad del elemento
// jQuery
$el.fadeTo('slow',0.15);
// Nativo
el.style.transition = 'opacity 3s'; // assume 'slow' equals 3 seconds
el.style.opacity = '0.15';
8.5 FadeToggle
Muestra u oculta el emento animando su opacidad.
// jQuery
$el.fadeToggle();
// Nativo
el.style.transition = 'opacity 3s';
const { opacity } = el.ownerDocument.defaultView.getComputedStyle(el, null);
if (opacity === '1') {
el.style.opacity = '0';
} else {
el.style.opacity = '1';
}
8.6 SlideUp & SlideDown
// jQuery
$el.slideUp();
$el.slideDown();
// Nativo
const originHeight = '100px';
el.style.transition = 'height 3s';
// slideUp
el.style.height = '0px';
// slideDown
el.style.height = originHeight;
8.7 SlideToggle
Muestra u oculta el elemento con una animación de deslizamiento.
// jQuery
$el.slideToggle();
// Nativo
const originHeight = '100px';
el.style.transition = 'height 3s';
const { height } = el.ownerDocument.defaultView.getComputedStyle(el, null);
if (parseInt(height, 10) === 0) {
el.style.height = originHeight;
}
else {
el.style.height = '0px';
}
8.8 Animate
Realiza una animación personalizada de un conjunto de propiedades CSS.
// jQuery
$el.animate({ params }, speed);
// Nativo
el.style.transition = 'all ' + speed;
Object.keys(params).forEach((key) => {
el.style[key] = params[key];
});
Última ✔ | Última ✔ | 10+ ✔ | Última ✔ | 6.1+ ✔ |
MIT