Skip to content

Latest commit

 

History

History
1485 lines (1089 loc) · 34.2 KB

README.ko-KR.md

File metadata and controls

1485 lines (1089 loc) · 34.2 KB
Raw

You (Might) Don't Need jQuery Build Status

오늘날 프론트엔드 개발 환경은 급격히 진화하고 있고, 모던 브라우저들은 이미 충분히 많은 DOM/BOM API들을 구현했습니다. 우리는 jQuery를 DOM 처리나 이벤트를 위해 처음부터 배울 필요가 없습니다. React, Angular, Vue같은 프론트엔드 라이브러리들이 주도권을 차지하는 동안 DOM을 바로 처리하는 것은 안티패턴이 되었고, jQuery의 중요성은 줄어들었습니다. 이 프로젝트는 대부분의 jQuery 메소드의 대안을 IE 10 이상을 지원하는 네이티브 구현으로 소개합니다.

노트: jQuery는 여전히 훌륭한 라이브러리이며 많은 유즈 케이스를 갖고 있습니다. 원하지 않으신다면 마이그레이트하지 않으셔도됩니다.

목차

  1. 번역
  2. Query Selector
  3. CSS & Style
  4. DOM 조작
  5. Ajax
  6. 이벤트
  7. 유틸리티
  8. Promises
  9. Animation
  10. 대안방법
  11. 브라우저 지원

번역

Query Selector

평범한 class, id, attribute같은 selector는 document.querySelector나 document.querySelectorAll으로 대체할 수 있습니다.

  • document.querySelector는 처음 매칭된 엘리먼트를 반환합니다.
  • document.querySelectorAll는 모든 매칭된 엘리먼트를 NodeList로 반환합니다. Array.prototype.slice.call(document.querySelectorAll(selector));을 사용해서 Array로 변환할 수 있습니다.
  • 만약 매칭된 엘리멘트가 없으면 jQuery와 document.querySelectorAll는 []를 반환하지만 document.querySelector는 null을 반환합니다.

안내: document.querySelector와 document.querySelectorAll는 꽤 느립니다, getElementById나 document.getElementsByClassName, document.getElementsByTagName를 사용하면 퍼포먼스가 향상을 기대할 수 있습니다.

  • 1.0 selector로 찾기

    // jQuery
$('selector');

// Native
document.querySelectorAll('selector');

  • 1.1 class로 찾기

    // jQuery
$('.class');

// Native
document.querySelectorAll('.class');

// 또는
document.getElementsByClassName('class');

  • 1.2 id로 찾기

    // jQuery
$('#id');

// Native
document.querySelector('#id');

// 또는
document.getElementById('id');

// 또는
window['id']

  • 1.3 속성(attribute)으로 찾기

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

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

  • 1.4 자식에서 찾기

    // jQuery
$el.find('li');

// Native
el.querySelectorAll('li');

  • 1.5 형제/이전/다음 엘리먼트 찾기

    • 형제 엘리먼트

      // jQuery
$el.siblings();

// Native - latest, Edge13+
[...el.parentNode.children].filter((child) =>
  child !== el
);
// Native (alternative) - latest, Edge13+
Array.from(el.parentNode.children).filter((child) =>
  child !== el
);
// Native - IE10+
Array.prototype.filter.call(el.parentNode.children, (child) =>
  child !== el
);

    • 이전 엘리먼트

      // jQuery
$el.prev();

// Native
el.previousElementSibling;

    • 다음 엘리먼트

      // jQuery
$el.next();

// Native
el.nextElementSibling;

    • 모든 이전 형제 엘리먼트

      // jQuery (선택적 필터 셀렉터)
$el.prevAll($filter);

// Native (선택적 필터 함수)
function getPreviousSiblings(elem, filter) {
  var sibs = [];
  while (elem = elem.previousSibling) {
    if (elem.nodeType === 3) continue; // 텍스트 노트 무시
    if (!filter || filter(elem)) sibs.push(elem);
  }
  return sibs;
}

    • 모든 다음 형제 엘리먼트

      // jQuery (선택적 셀렉터 필터)
$el.nextAll($filter);

// Native (선택적 필터 함수)
function getNextSiblings(elem, filter) {
  var sibs = [];
  var nextElem = elem.parentNode.firstChild;
  do {
    if (nextElem.nodeType === 3) continue; // 텍스트 노드 무시
    if (nextElem === elem) continue; // 대상 elem 무시
    if (nextElem === elem.nextElementSibling) {
      if (!filter || filter(elem)) {
        sibs.push(nextElem);
        elem = nextElem;
      }
    }
  } while(nextElem = nextElem.nextSibling)
  return sibs;
}

필터 함수 예제:

function exampleFilter(elem) {
  switch (elem.nodeName.toUpperCase()) {
    case 'DIV':
      return true;
    case 'SPAN':
      return true;
    default:
      return false;
  }
}

  • 1.6 Closest

    현재 엘리먼트부터 document로 이동하면서 주어진 셀렉터와 일치하는 가장 가까운 엘리먼트를 반환합니다.

    // jQuery
$el.closest(selector);

// Native - 최신 브라우저만, IE는 미지원
 el.closest(selector);

// Native - 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 Parents Until

    주어진 셀렉터에 매칭되는 엘리먼트를 찾기까지 부모 태그들을 위로 올라가며 탐색하여 저장해두었다가 DOM 노드 또는 jQuery object로 반환합니다.

    // jQuery
$el.parentsUntil(selector, filter);

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

  // match start from parent
  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 Form

    • Input/Textarea

      // jQuery
$('#my-input').val();

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

    • e.currentTarget이 몇 번째 .radio 인지 구하기

      // jQuery
$(e.currentTarget).index('.radio');

// Native
Array.from(document.querySelectorAll('.radio')).indexOf(e.currentTarget);
또는
Array.prototype.indexOf.call(document.querySelectorAll('.radio'), e.currentTarget);

  • 1.9 Iframe Contents

    $('iframe').contents()는 iframe에 한정해서 contentDocument를 반환합니다.

    • Iframe contents

      // jQuery
$iframe.contents();

// Native
iframe.contentDocument;

    • Iframe에서 찾기

      // jQuery
$iframe.contents().find('.css');

// Native
iframe.contentDocument.querySelectorAll('.css');

  • 1.10 body 얻기

    // jQuery
$('body');

// Native
document.body;

  • 1.11 속성 얻기 및 설정

    • 속성 얻기

      // jQuery
$el.attr('foo');

// Native
el.getAttribute('foo');

    • 속성 설정하기

      // jQuery, DOM 변형 없이 메모리에서 작동됩니다.
$el.attr('foo', 'bar');

// Native
el.setAttribute('foo', 'bar');

    • data- 속성 얻기

      // jQuery
$el.data('foo');

// Native (`getAttribute` 사용)
el.getAttribute('data-foo');

// Native (IE 11 이상의 지원만 필요하다면 `dataset`을 사용)
el.dataset['foo'];

  • 1.12 문자열을 포함하는 셀렉터(대소문자 구분)

    // jQuery
$("selector:contains('text')");

// Native
function contains(selector, text) {
  var elements = document.querySelectorAll(selector);
  return Array.from(elements).filter(function(element) {
    return RegExp(text).test(element.textContent);
  });
}

⬆ 목차로 돌아가기

CSS & Style

  • 2.1 CSS

    • style값 얻기

      // jQuery
$el.css("color");

// Native
// NOTE: 알려진 버그로, style값이 'auto'이면 'auto'를 반환합니다.
const win = el.ownerDocument.defaultView;

// null은 가상 스타일은 반환하지 않음을 의미합니다.
win.getComputedStyle(el, null).color;

    • style값 설정하기

      // jQuery
$el.css({ color: '#f01' });

// Native
el.style.color = '#f01';

    • Style값들을 동시에 얻거나 설정하기

      만약 한번에 여러 style값을 바꾸고 싶다면 oui-dom-utils 패키지의 setStyles를 사용해보세요.

    • class 추가하기

      // jQuery
$el.addClass(className);

// Native
el.classList.add(className);

    • class 제거하기

      // jQuery
$el.removeClass(className);

// Native
el.classList.remove(className);

    • class를 포함하고 있는지 검사하기

      // jQuery
$el.hasClass(className);

// Native
el.classList.contains(className);

    • class 토글하기

      // jQuery
$el.toggleClass(className);

// Native
el.classList.toggle(className);

  • 2.2 폭과 높이

    폭과 높이는 이론상 동일합니다. 높이로 예를 들겠습니다.

    • Window의 높이

      // window 높이
$(window).height();

// jQuery처럼 스크롤바를 제외하기
window.document.documentElement.clientHeight;

// 스크롤바 포함
window.innerHeight;

    • 문서 높이

      // 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
);

    • Element 높이

      // jQuery
$el.height();

// Native
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;
}

// 정수로 정확하게（`border-box`일 때 이 값은 `height - border`이고, `content-box`일 때, 이 값은 `height + padding`）
el.clientHeight;

// 실수로 정확하게（`border-box`일 때 이 값은 `height`이고, `content-box`일 때, 이 값은 `height + padding + border`）
el.getBoundingClientRect().height;

  • 2.3 Position & Offset

    • Position

      오프셋 부모를 기준으로 엘리먼트의 현재 위치를 얻습니다.

      // jQuery
$el.position();

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

    • Offset

      다큐먼트를 기준으로 엘리먼트의 현재 위치를 얻습니다.

      // jQuery
$el.offset();

// Native
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 Scroll Top

    엘리먼트에대한 스크롤바의 현재 수직 위치를 얻습니다.

    // jQuery
$(window).scrollTop();

// Native
(document.documentElement && document.documentElement.scrollTop) || document.body.scrollTop;

⬆ 목차로 돌아가기

DOM 조작

  • 3.1 제거

    DOM으로부터 엘리먼트를 제거합니다.

    // jQuery
$el.remove();

// Native
el.parentNode.removeChild(el);

  • 3.2 Text

    • text 가져오기

      자손을 포함하는 엘리먼트의 결합된 텍스트 컨텐츠를 얻습니다.

      // jQuery
$el.text();

// Native
el.textContent;

    • text 설정하기

      엘리먼트의 컨텐츠를 지정한 텍스트로 설정합니다.

      // jQuery
$el.text(string);

// Native
el.textContent = string;

  • 3.3 HTML

    • HTML 가져오기

      // jQuery
$el.html();

// Native
el.innerHTML;

    • HTML 설정하기

      // jQuery
$el.html(htmlString);

// Native
el.innerHTML = htmlString;

  • 3.4 해당 엘리먼트의 자식들 뒤에 넣기(Append)

    부모 엘리먼트의 마지막 자식 다음으로 엘리먼트를 추가합니다.

    // jQuery: DOMString과 Node 객체를 위한 통합된 구문
$parent.append(newEl | '<div id="container">Hello World</div>');

// Native: 다른 구문
parent.insertAdjacentHTML('beforeend', '<div id="container">Hello World</div>');
parent.appendChild(newEl);

// Native (ES6 방식): 통합된 구문
parent.append(newEl | '<div id="container">Hello World</div>');

  • 3.5 해당 엘리먼트의 자식들 앞에 넣기(Prepend)

    // jQuery: DOMString과 Node 객체를 위한 통합된 구문
$parent.prepend(newEl | '<div id="container">Hello World</div>');

// Native: 다른 구문
parent.insertAdjacentHTML('afterbegin', '<div id="container">Hello World</div>');
parent.insertBefore(newEl, parent.firstChild);

// Native (ES6 방식): 통합된 구문
parent.prepend(newEl | '<div id="container">Hello World</div>');

  • 3.6 해당 엘리먼트 앞에 넣기(insertBefore)

    새 노드를 선택한 엘리먼트 앞에 넣습니다.

    // jQuery
$newEl.insertBefore(selector);

// Native (HTML 문자열)
el.insertAdjacentHTML('beforebegin', '<div id="container">Hello World</div>');

// Native (엘리먼트)
const el = document.querySelector(selector);
if (el.parentNode) {
  el.parentNode.insertBefore(newEl, el);
}

  • 3.7 해당 엘리먼트 뒤에 넣기(insertAfter)

    새 노드를 선택한 엘리먼트 뒤에 넣습니다.

    // jQuery
$newEl.insertAfter(selector);

// Native (HTML 문자열)
el.insertAdjacentHTML('afterend', '<div id="container">Hello World</div>');

// Native (엘리먼트)
onst el = document.querySelector(selector);
if (el.parentNode) {
  el.parentNode.insertBefore(newEl, el.nextSibling);
}

  • 3.8 is

    query selector와 일치하면 true 를 반환합니다.

    // jQuery - `is`는 함수, 존재하는 jQuery 객체 또는 여기에서 언급하지 않은 DOM 엘리먼트와도 동작함을 알립니다.
$el.is(selector);

// Native
el.matches(selector);

  • 3.9 clone

    엘리먼트의 깊은 복사본을 생성합니다. 일치한 엘리먼트를 포함해 그 자손 노드와 텍스트 노드를 모두 복사합니다.

    // jQuery. 이벤트 핸들러가 엘리먼트와 함께 복사되어야함을 알리려면 파라미터를 `true`로 설정하세요.
$el.clone();

// Native
el.cloneNode();

  • 3.10 empty

    모든 자식 노드를 제거합니다.

    // jQuery
$el.empty();

// Native
el.innerHTML = null;

  • 3.11 wrap

    각각의 엘리먼트를 주어진 HTML 구조로 감쌉니다.

    // jQuery
$('.inner').wrap('<div class="wrapper"></div>');

// Native
Array.from(document.querySelectorAll('.inner')).forEach((el) => {
  const wrapper = document.createElement('div');
  wrapper.className = 'wrapper';
  el.parentNode.insertBefore(wrapper, el);
  wrapper.appendChild(el);
});

  • 3.12 unwrap

    DOM에서 해당 엘리먼트를 감싸고 있는 부모 요소를 없앱니다.

    // jQuery
$('.inner').unwrap();

// Native
Array.from(document.querySelectorAll('.inner')).forEach((el) => {
  let elParentNode = el.parentNode;

  if (elParentNode !== document.body) {
    elParentNode.parentNode.insertBefore(el, elParentNode);
    elParentNode.parentNode.removeChild(elParentNode);
  }
});

  • 3.13 replaceWith

    각각의 엘리먼트를 주어진 새 엘리먼트로 교체합니다.

    // jQuery
$('.inner').replaceWith('<div class="outer"></div>');

// Native (대안) - 최신, Edge17+
Array.from(document.querySelectorAll('.inner')).forEach((el) => {
  const outer = document.createElement('div');
  outer.className = 'outer';
  el.replaceWith(outer);
});

// Native
Array.from(document.querySelectorAll('.inner')).forEach((el) => {
  const outer = document.createElement('div');
  outer.className = 'outer';
  el.parentNode.replaceChild(outer, el);
});

    • 3.14 간단한 파싱

      문자열을 HTML/SVG/XML 로 파싱합니다.

      // jQuery
$(`<ol>
  <li>a</li>
  <li>b</li>
</ol>
<ol>
  <li>c</li>
  <li>d</li>
</ol>`);

// Native
range = document.createRange();
parse = range.createContextualFragment.bind(range);

parse(`<ol>
  <li>a</li>
  <li>b</li>
</ol>
<ol>
  <li>c</li>
  <li>d</li>
</ol>`);

⬆ 목차로 돌아가기

Ajax

Fetch API 는 XMLHttpRequest를 ajax로 대체하는 새로운 표준 입니다. Chrome과 Firefox에서 작동하며, polyfill을 이용해서 구형 브라우저에서 작동되도록 만들 수도 있습니다.

IE9 이상에서 지원하는 github/fetch 혹은 IE8 이상에서 지원하는 fetch-ie8, JSONP 요청을 만드는 fetch-jsonp를 이용해보세요.

  • 4.1 서버로부터 HTML data를 불러와서 매칭된 엘리먼트에 배치.

    // jQuery
$(selector).load(url, completeCallback)

// Native
fetch(url).then(data => data.text()).then(data => {
  document.querySelector(selector).innerHTML = data
}).then(completeCallback)

⬆ 목차로 돌아가기

이벤트

namespace와 delegation을 포함해서 완전히 갈아 엎길 원하시면 https://github.com/oneuijs/oui-dom-events 를 고려해보세요.

  • 5.0 DOMContentLoaded가 되어 문서가 사용 가능한지

    // jQuery
$(document).ready(eventHandler);

// Native
// DOMContentLoaded가 이미 완료되었는지를 확인
if (document.readyState !== 'loading') {
  eventHandler();
} else {
  document.addEventListener('DOMContentLoaded', eventHandler);
}

  • 5.1 이벤트 Bind 걸기

    // jQuery
$el.on(eventName, eventHandler);

// Native
el.addEventListener(eventName, eventHandler);

  • 5.2 이벤트 Bind 풀기

    // jQuery
$el.off(eventName, eventHandler);

// Native
el.removeEventListener(eventName, eventHandler);

  • 5.3 이벤트 발생시키기(Trigger)

    // jQuery
$(el).trigger('custom-event', {key1: 'data'});

// Native
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);

⬆ 목차로 돌아가기

유틸리티

대부분의 jQuery 유틸은 네이티브 API에서도 찾을 수 있습니다. 다른 향상된 기능들은 지속성과 성능에 중점을 둔 더 나은 유틸 라이브러리로부터 선택할 수 있습니다. 권장하는 대안은 Lodash입니다.

  • 6.1 기본 유틸리티

    • isArray

    주어진 인자가 배열인지 검사합니다.

    // jQuery
$.isArray(array);

// Native
Array.isArray(array);
    • isWindow

    주어진 인자가 window 객체인지 검사합니다.

    // jQuery
$.isWindow(obj);

// Native
function isWindow(obj) {
  return obj !== null && obj !== undefined && obj === obj.window;
}
    • inArray

    배열에서 해당 값이 있는지 검색하고 해당 값의 순번을 반환합니다. (검색 결과가 없을 경우 -1을 반환)

    // jQuery
$.inArray(item, array);

// Native
array.indexOf(item) > -1;

// ES6 방식
array.includes(item);
    • isNumeric

    주어진 인자가 숫자인지 검사합니다. 검사에 typeof 를 사용합니다. 필요하면 라이브러리를 사용하세요. 가끔 typeof는 정확하지 않습니다.

    // jQuery
$.isNumeric(item);

// Native
function isNumeric(n) {
  return !isNaN(parseFloat(n)) && isFinite(n);
}
    • isFunction

    주어진 인자가 JavaScript 함수 객체인지 검사합니다.

    // jQuery
$.isFunction(item);

// Native
function isFunction(item) {
  if (typeof item === 'function') {
    return true;
  }
  var type = Object.prototype.toString(item);
  return type === '[object Function]' || type === '[object GeneratorFunction]';
}
    • isEmptyObject

    객체가 비어있는지 검사합니다. Check to see if an object is empty (열거할 수 있는 프로퍼티가 없는지 검사).

    // jQuery
$.isEmptyObject(obj);

// Native
function isEmptyObject(obj) {
  return Object.keys(obj).length === 0;
}
    • isPlainObject

    주어진 객체가 평범한 객체인지 검사합니다. (“{}”이나 “new Object”으로 생성되었는지 검사)

    // jQuery
$.isPlainObject(obj);

// Native
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

    두 개 이상의 객체를 첫 번째 객체로 합칩니다. object.assign 은 ES6 API입니다. polyfill 을 사용할 수 있습니다.

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

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

    문자열 앞뒤에 붙은 공백문자를 제거합니다.

    // jQuery
$.trim(string);

// Native
string.trim();
    • map

    배열이나 객체 내의 모든 요소를 새 배열에 변환하여 저장합니다.

    // jQuery
$.map(array, (value, index) => {
});

// Native
array.map((value, index) => {
});
    • each

    객체나 함수 모두에 매끄럽게 사용할 수 있는 포괄적인 용도의 반복 함수입니다.

    // jQuery
$.each(array, (index, value) => {
});

// Native
array.forEach((value, index) => {
});
    • grep

    배열에서 필터 함수를 만족하는 엘리먼트를 찾습니다.

    // jQuery
$.grep(array, (value, index) => {
});

// Native
array.filter((value, index) => {
});
    • type

    객체의 JavaScript 내부 [[Class]]를 검사합니다.

    // jQuery
$.type(obj);

// Native
function type(item) {
  const reTypeOf = /(?:^\[object\s(.*?)\]$)/;
  return Object.prototype.toString.call(item)
      .replace(reTypeOf, '$1')
      .toLowerCase();
}
    • merge

    두 배열을 첫 번째 배열로 합칩니다.

    // jQuery, 중복된 항목을 제거하지 않습니다
$.merge(array1, array2);

// Native, 중복된 항목을 제거하지 않습니다
function merge(...args) {
  return [].concat(...args)
}

// ES6 방식, 중복된 항목을 제거하지 않습니다
array1 = [...array1, ...array2]

// Set 버전, 중복된 항목을 제거합니다
function merge(...args) {
  return Array.from(new Set([].concat(...args)))
}
    • now

    현재 시간을 숫자로 반환합니다.

    // jQuery
$.now();

// Native
Date.now();
    • proxy

    함수를 받아서 언제나 특정 context를 갖는 새 함수를 반환합니다.

    // jQuery
$.proxy(fn, context);

// Native
fn.bind(context);

    + makeArray

    array-like 한 객체를 진짜 JavaScript 배열로 변환합니다.

    // jQuery
$.makeArray(arrayLike);

// Native
Array.prototype.slice.call(arrayLike);

// ES6 방식: Array.from() 메소드
Array.from(arrayLike);

// ES6 방식: spread 연산자
[...arrayLike];

  • 6.2 Contains

    주어진 엘리먼트가 주어진 또 다른 엘리먼트를 자손으로 포함하는지 검사합니다.

    // jQuery
$.contains(el, child);

// Native
el !== child && el.contains(child);

  • 6.3 Globaleval

    JavaScript 코드를 전역적으로 실행합니다.

    // jQuery
$.globaleval(code);

// Native
function Globaleval(code) {
  const script = document.createElement('script');
  script.text = code;

  document.head.appendChild(script).parentNode.removeChild(script);
}

// eval 함수를 쓸 수도 있습니다. 하지만 $.Globaleval 의 context가 전역인 데 반해 eval 함수의 context 는 실행 영역입니다.
eval(code);

  • 6.4 parse

    • parseHTML

    문자열을 DOM 노드의 배열로 변환합니다.

    // jQuery
$.parseHTML(htmlString);

// Native
function parseHTML(string) {
  const context = document.implementation.createHTMLDocument();

  // 생성된 도큐먼트를 위해 base href를 지정해서 URL이 있는 엘리먼트들은 도큐먼트 기준으로 처리됩니다.
  const base = context.createElement('base');
  base.href = document.location.href;
  context.head.appendChild(base);

  context.body.innerHTML = string;
  return context.body.children;
}

  • 6.5 exists

  • exists

    엘리먼트가 DOM에 존재하는지를 확인합니다

    // jQuery
if ($('selector').length) {
  // 존재함
}

// Native
var element =  document.getElementById('elementId');
if (typeof(element) != 'undefined' && element != null) 
{
  // 존재함
}

⬆ 목차로 돌아가기

Promises

Promise는 비동기적인 작업의 결과를 표현합니다. jQuery는 자체적인 promise 처리를 가지고 있습니다. 네이티브 JavaScript엔 Promises/A+ 명세에 맞는 얇고 작은 API를 구현되어 있습니다.

  • 7.1 done, fail, always

    done은 promise가 처리되었을 때, fail은 promise가 거절되었을 때, always는 promise가 어떻게 되었건 실행됩니다.

    // jQuery
$promise.done(doneCallback).fail(failCallback).always(alwaysCallback)

// Native
promise.then(doneCallback, failCallback).then(alwaysCallback, alwaysCallback)

  • 7.2 when

    when은 여러 개의 promise들을 처리할 때 사용됩니다. 이것은 모든 promise가 처리되었을 때 resolve하고 하나라도 거절되면 reject합니다.

    // jQuery
$.when($promise1, $promise2).done((promise1Result, promise2Result) => {
});

// Native
Promise.all([$promise1, $promise2]).then([promise1Result, promise2Result] => {});

  • 7.3 Deferred

    Deferred는 promise를 생성하는 방법입니다.

    // jQuery
function asyncFunc() {
  const defer = new $.Deferred();
  setTimeout(() => {
    if(true) {
      defer.resolve('some_value_computed_asynchronously');
    } else {
      defer.reject('failed');
    }
  }, 1000);

  return defer.promise();
}

// Native
function asyncFunc() {
  return new Promise((resolve, reject) => {
    setTimeout(() => {
      if (true) {
        resolve('some_value_computed_asynchronously');
      } else {
        reject('failed');
      }
    }, 1000);
  });
}

// Deferred way
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();
}

⬆ 목차로 돌아가기

Animation

  • 8.1 Show & Hide

    // jQuery
$el.show();
$el.hide();

// Native
// show 메소드에 대한 더 자세한 정보를 보고 싶으면  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

    엘리먼트를 출력하거나 숨깁니다.

    // jQuery
$el.toggle();

// Native
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);

// Native fadeOut
function fadeOut(el, ms) {
  if (ms) {
    el.style.transition = `opacity ${ms} ms`;
    el.addEventListener(
      'transitionend',
      function(event) {
        el.style.display = 'none';
      },
      false
    );
  }
  el.style.opacity = '0';
}

// Native fadeIn
function fadeIn(elem, ms) {
  elem.style.opacity = 0;

  if (ms) {
    let opacity = 0;
    const timer = setInterval(function() {
      opacity += 50 / ms;
      if (opacity >= 1) {
        clearInterval(timer);
        opacity = 1;
      }
      elem.style.opacity = opacity;
    }, 50);
  } else {
    elem.style.opacity = 1;
  }
}

  • 8.4 FadeTo

    엘리먼트의 투명도(opacity)를 조정합니다.

    // jQuery
$el.fadeTo('slow',0.15);
// Native
el.style.transition = 'opacity 3s'; // 'slow'가 3초라고 가정합니다.
el.style.opacity = '0.15';

  • 8.5 FadeToggle

    엘리먼트를 투명도를 조절해서 보여주거나 숨깁니다.

    // jQuery
$el.fadeToggle();

// Native
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();

// Native
const originHeight = '100px';
el.style.transition = 'height 3s';
// slideUp
el.style.height = '0px';
// slideDown
el.style.height = originHeight;

  • 8.7 SlideToggle

    슬라이딩 모션과 함께 엘리먼트를 보이거나 숨깁니다.

    // jQuery
$el.slideToggle();

// Native
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

    자체적으로 CSS 프로퍼티들을 에니메이션합니다.

    // jQuery
$el.animate({ params }, speed);

// Native
el.style.transition = 'all ' + speed;
Object.keys(params).forEach((key) => {
  el.style[key] = params[key];
});

대안방법

Browser Support

Chrome Firefox IE Opera Safari
Latest ✔ Latest ✔ 10+ ✔ Latest ✔ 6.1+ ✔

License

MIT