oneuijs/You-Dont-Need-jQuery

Posted 2020-08-22 白马非马

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了oneuijs/You-Dont-Need-jQuery相关的知识，希望对你有一定的参考价值。

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

你可能不需要 jQuery (You Might Not Need jQuery) - 如何使用原生 javascript 实现通用事件，元素，ajax 等用法。
npm-dom 以及 webmodules - 在 NPM 上提供独立 DOM 模块的组织

Browser Support

Latest ?

10+ ?

Latest ?

6.1+ ?

License

以上是关于oneuijs/You-Dont-Need-jQuery的主要内容，如果未能解决你的问题，请参考以下文章