oneuijs/You-Dont-Need-jQuery

时间：2022-02-11 20:02:30

oneuijs/You-Dont-Need-jQuery

 https://github.com/oneuijs/You-Dont-Need-jQuery/blob/master/README.zh-CN.md

You Don't Need jQuery

前端发展很快，现代浏览器原生 API 已经足够好用。我们并不需要为了操作 DOM、Event 等再学习一下 jQuery 的 API。同时由于 React、Angular、Vue 等框架的流行，直接操作 DOM 不再是好的模式，jQuery 使用场景大大减少。本项目总结了大部分 jQuery API 替代的方法，暂时只支持 IE10+ 以上浏览器。

Translations

Query Selector

常用的 class、id、属性 选择器都可以使用 document.querySelector 或 document.querySelectorAll 替代。区别是

  • document.querySelector 返回第一个匹配的 Element
  • document.querySelectorAll 返回所有匹配的 Element 组成的 NodeList。它可以通过 [].slice.call() 把它转成 Array
  • 如果匹配不到任何 Element，jQuery 返回空数组 []，但 document.querySelector 返回 null，注意空指针异常。当找不到时，也可以使用 || 设置默认的值，如 document.querySelectorAll(selector) || []

注意：document.querySelector 和 document.querySelectorAll 性能很差。如果想提高性能，尽量使用 document.getElementById、document.getElementsByClassName 或 document.getElementsByTagName。

  • 1.0 Query by selector

    // jQuery
    
(selector);

// Native
    
document.querySelectorAll(selector);

  • 1.1 Query by class

    // jQuery
    
();

// Native
    
document.querySelectorAll();

document.getElementsByClassName();

  • 1.2 Query by id

    // jQuery
    
();

// Native
    
document.querySelector();

document.getElementById();

  • 1.3 Query by attribute

    // jQuery
    
(a[target=_blank]);

// Native
    
document.querySelectorAll(a[target=_blank]);

  • 1.4 Find sth.

    • Find nodes

      // jQuery
      
.();

// Native
      
.querySelectorAll();

    • Find body

      // jQuery
      
();

// Native
      
document.;

    • Find Attribute

      // jQuery
      
.();

// Native
      
.getAttribute();

    • Find data attribute

      // jQuery
      
.();

// Native
      
// using getAttribute
      
.getAttribute(data-foo);
      
// you can also use `dataset` if only need to support IE 11+
      
.dataset[];

  • 1.5 Sibling/Previous/Next Elements

    • Sibling elements

      // jQuery
      
.siblings();

// Native
      
[].filter.(.parentNode.children, function(child) {
      
  return child  el;
      
});

    • Previous elements

      // jQuery
      
.();

// Native
      
.previousElementSibling;

    • Next elements

      // next
      
.();
      
.nextElementSibling;

  • 1.6 Closest

    Closest 获得匹配选择器的第一个祖先元素，从当前元素开始沿 DOM 树向上。

    // jQuery
    
.closest(queryString);

// Native
    
function closest(, selector) {
    
  const matchesSelector  .matches  .webkitMatchesSelector  .mozMatchesSelector  .msMatchesSelector;

  while (el) {
    
     (matchesSelector.(el, selector)) {
    
      return el;
    
    }  {
    
      el  .parentElement;
    
    }
    
  }
    
  return ;
    
}

  • 1.7 Parents Until

    获取当前每一个匹配元素集的祖先，不包括匹配元素的本身。

    // jQuery
    
.parentsUntil(selector, filter);

// Native
    
function parentsUntil(, selector, filter) {
    
  const result  [];
    
  const matchesSelector  .matches  .webkitMatchesSelector  .mozMatchesSelector  .msMatchesSelector;

  // match start from parent
    
  el  .parentElement;
    
  while (el  matchesSelector.(el, selector)) {
    
     (filter) {
    
      result.(el);
    
    }  {
    
       (matchesSelector.(el, filter)) {
    
        result.(el);
    
      }
    
    }
    
    el  .parentElement;
    
  }
    
  return result;
    
}

  • 1.8 Form

    • Input/Textarea

      // jQuery
      
(#my-input).();

// Native
      
document.querySelector(#my-input).value;

    • Get index of e.currentTarget between .radio

      // jQuery
      
(.currentTarget).index(.radio);

// Native
      
[].indexOf.(document.querySelectorAll(.radio), .currentTarget);

  • 1.9 Iframe Contents

    jQuery 对象的 iframe contents() 返回的是 iframe 内的 document

    • Iframe contents

      // jQuery
      
$iframe.contents();

// Native
      
iframe.contentDocument;

    • Iframe Query

      // jQuery
      
$iframe.contents().();

// Native
      
iframe.contentDocument.querySelectorAll();

⬆ 回到顶部

CSS & Style

  • 2.1 CSS

    • Get style

      // jQuery
      
.(color);

// Native
      
// 注意：此处为了解决当 style 值为 auto 时，返回 auto 的问题
      
const   .ownerDocument.defaultView;
      
// null 的意思是不返回伪类元素
      
.getComputedStyle(el, ).color;

    • Set style

      // jQuery
      
.({ color #ff0011 });

// Native
      
.style.color  #ff0011;

    • Get/Set Styles

      注意，如果想一次设置多个 style，可以参考 oui-dom-utils 中 setStyles 方法

    • Add class

      // jQuery
      
.addClass(className);

// Native
      
.classList.(className);

    • Remove class

      // jQuery
      
.removeClass(className);

// Native
      
.classList.remove(className);

    • has class

      // jQuery
      
.hasClass(className);

// Native
      
.classList.contains(className);

    • Toggle class

      // jQuery
      
.toggleClass(className);

// Native
      
.classList.toggle(className);

  • 2.2 Width & Height

    Width 与 Height 获取方法相同，下面以 Height 为例：

    • Window height

      // jQuery
      
(window).height();

// Native
      
// 不含 scrollbar，与 jQuery 行为一致
      
window.document.documentElement.clientHeight;
      
// 含 scrollbar
      
window.innerHeight;

    • Document height

      // jQuery
      
(document).height();

// Native
      
document.documentElement.scrollHeight;

    • Element height

      // jQuery
      
.height();

// Native
      
// 与 jQuery 一致（一直为 content 区域的高度）
      
function getHeight() {
      
  const styles  .getComputedStyle(el);
      
  const height  .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;
      
}
      
// 精确到整数（border-box 时为 height 值，content-box 时为 height + padding + border 值）
      
.clientHeight;
      
// 精确到小数（border-box 时为 height 值，content-box 时为 height + padding + border 值）
      
.getBoundingClientRect().height;

    • Iframe height

      $iframe .contents() 方法返回 iframe 的 contentDocument

      // jQuery
      
(iframe).contents().height();

// Native
      
iframe.contentDocument.documentElement.scrollHeight;

  • 2.3 Position & Offset

    • Position

      // jQuery
      
.position();

// Native
      
{ left .offsetLeft, top .offsetTop }

    • Offset

      // jQuery
      
.offset();

// Native
      
function getOffset () {
      
  const   .getBoundingClientRect();

  return {
      
    top .  window.pageYOffset  document.documentElement.clientTop,
      
    left .  window.pageXOffset  document.documentElement.clientLeft
      
  }
      
}

  • 2.4 Scroll Top

    // jQuery
    
(window).scrollTop();

// Native
    
(document.documentElement  document.documentElement.scrollTop)  document..scrollTop;

⬆ 回到顶部

DOM Manipulation

  • 3.1 Remove

    // jQuery
    
.remove();

// Native
    
.parentNode.removeChild(el);

  • 3.2 Text

    • Get text

      // jQuery
      
.();

// Native
      
.textContent;

    • Set text

      // jQuery
      
.(string);

// Native
      
.textContent  string;

  • 3.3 HTML

    • Get HTML

      // jQuery
      
.();

// Native
      
.innerHTML;

    • Set HTML

      // jQuery
      
.(htmlString);

// Native
      
.innerHTML  htmlString;

  • 3.4 Append

    Append 插入到子节点的末尾

    // jQuery
    
.append(<div id='container'>hello</div>);

// Native
    
 newEl  document.createElement();
    
newEl.setAttribute(, container);
    
newEl.innerHTML  hello;
    
.appendChild(newEl);

  • 3.5 Prepend

    // jQuery
    
.prepend(<div id='container'>hello</div>);

// Native
    
 newEl  document.createElement();
    
newEl.setAttribute(, container);
    
newEl.innerHTML  hello;
    
.insertBefore(newEl, .firstChild);

  • 3.6 insertBefore

    在选中元素前插入新节点

    // jQuery
    
$newEl.insertBefore(queryString);

// Native
    
const target  document.querySelector(queryString);
    
target.parentNode.insertBefore(newEl, target);

  • 3.7 insertAfter

    在选中元素后插入新节点

    // jQuery
    
$newEl.insertAfter(queryString);

// Native
    
const target  document.querySelector(queryString);
    
target.parentNode.insertBefore(newEl, target.nextSibling);

⬆ 回到顶部

用 fetch 和 fetch-jsonp 替代

⬆ 回到顶部

Events

完整地替代命名空间和事件代理，链接到 https://github.com/oneuijs/oui-dom-events

  • 5.1 Bind an event with on

    // jQuery
    
.(eventName, eventHandler);

// Native
    
.addEventListener(eventName, eventHandler);

  • 5.2 Unbind an event with off

    // jQuery
    
.(eventName, eventHandler);

// Native
    
.removeEventListener(eventName, eventHandler);

  • 5.3 Trigger

    // jQuery
    
(el).trigger(custom-event, {key1 });

// Native
    
 (window.CustomEvent) {
    
  const event   CustomEvent(custom-event, {detail {key1 }});
    
}  {
    
  const event  document.createEvent(CustomEvent);
    
  event.initCustomEvent(custom-event, , , {key1 });
    
}

.dispatchEvent(event);

⬆ 回到顶部

Utilities

  • 6.1 isArray

    // jQuery
    
.isArray(range);

// Native
    
Array.isArray(range);

  • 6.2 Trim

    // jQuery
    
.(string);

// Native
    
string.();

  • 6.3 Object Assign

    继承，使用 object.assign polyfill https://github.com/ljharb/object.assign

    // jQuery
    
.extend({}, defaultOpts, opts);

// Native
    
Object.assign({}, defaultOpts, opts);

  • 6.4 Contains

    // jQuery
    
.contains(el, child);

// Native
    
el  child  .contains(child);

⬆ 回到顶部

Alternatives

Browser Support

Latest ✔ Latest ✔ 10+ ✔ Latest ✔ 6.1+ ✔

License

相关文章