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+.
- Traducción
- Query Selector
- CSS & Estilo
- Manipulación DOM
- Ajax
- Eventos
- Utilidades
- Promesas
- Animaciones
- Alternativas
- Navegadores soportados
- 한국어
- 正體中文
- 简体中文
- Bahasa Melayu
- Bahasa Indonesia
- Português(PT-BR)
- Tiếng Việt Nam
- Español
- Русский
- Кыргызча
- Türkçe
- Italiano
- Français
- 日本語
- Polski
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) || []);
- Si ningún elemento cumple con la condición, jQuery retornaría
[]
mientras la API DOM retornaríanull
. Nótese el NullPointerException. Se puede usar||
para establecer el valor por defecto al no encontrar elementos, como endocument.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()
devuelvecontentDocument
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
- isArray
Determina si el lemento es un vector(array).
// jQuery $.isArray(array); // Nativo Array.isArray(array);
- isWindow
Determina si el argumento en una ventana(window).
// jQuery $.isWindow(obj); // Nativo function isWindow(obj) { return obj !== null && obj !== undefined && obj === obj.window; }
- inArray
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);
- isNumeric
Determina si el argumento es un número. Utiliza
typeof
para decidir el tipo deltype
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)); }
- isFunction
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]'; }
- isEmptyObject
Verifica que un objeto esté vacío(contiene propiedades no enumerables).
// jQuery $.isEmptyObject(obj); // Nativo function isEmptyObject(obj) { return Object.keys(obj).length === 0; }
- isPlainObject
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; }
- extend
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);
- trim
Elimina los espacios en blanco del inicio y final de un string.
// jQuery $.trim(string); // Nativo string.trim();
- map
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) => { });
- each
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) => { });
- grep
Encuentra los elementos de un arreglo que satisfacen una función filtro.
// jQuery $.grep(array, (value, index) => { }); // Nativo array.filter((value, index) => { });
- type
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(); }
- merge
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) }
- now
Retorna un número que representa la hora actual.
// jQuery $.now(); // Native Date.now();
- proxy
Toma una función y regresa una nueva que siempre tendrá un contexto particular.
// jQuery $.proxy(fn, context); // Nativo fn.bind(context);
- makeArray
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
- parseHTML
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; }
- parseJSON
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]; )
- Quizá no necesites jQuery - Ejemplos de como hacer un evento común, un elemento, ajax, etc, con Javascript puro.
- npm-dom y webmodules - Organizaciones en las puedes encontrar módulos individuales del DOM en NPM.
Última ✔ | Última ✔ | 10+ ✔ | Última ✔ | 6.1+ ✔ |
MIT