0Pricing
HTML Academy · 강의

cloneNode로 템플릿 복제하기

cloneNode(true)로 템플릿 콘텐츠 효율적으로 복제하기

cloneNode로 템플릿 복제하기은(는) CoddyKit의 무료 HTML Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 HTML Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. HTML Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

깊은 복제와 얕은 복제

cloneNode 메서드는 불리언 인수를 받습니다.

const template = document.getElementById('card-tmpl');

// Deep clone (true): copies all descendants
const deep = template.content.cloneNode(true);

// Shallow clone (false): only the root node, no children
const shallow = template.content.cloneNode(false);
// shallow has no children — use deep for templates

하나의 template에서 여러 복제본 만들기

template은 원하는 횟수만큼 복제할 수 있습니다.

const tmpl = document.getElementById('item-tmpl');
const container = document.getElementById('list');

['Alpha', 'Beta', 'Gamma'].forEach((name, i) => {
  const clone = tmpl.content.cloneNode(true);
  clone.querySelector('.item-name').textContent = name;
  clone.querySelector('.item-num').textContent = i + 1;
  container.appendChild(clone);
});
// 3 separate clones — modifying one doesn't affect others

DocumentFragment와 성능

성능을 위해 DocumentFragment를 사용하여 DOM 업데이트를 일괄 처리합니다.

const frag = document.createDocumentFragment();
const tmpl = document.getElementById('row-tmpl');

rows.forEach(row => {
  const clone = tmpl.content.cloneNode(true);
  // fill in clone...
  frag.appendChild(clone);
});

// ONE DOM append instead of many:
document.getElementById('table-body').appendChild(frag);
// Appending to a fragment doesn't trigger layout; append once for performance

복제와 이벤트 리스너

원본 template의 이벤트 리스너는 NOT 복사됩니다.

// Template definition:
const tmpl = document.getElementById('btn-tmpl');
const origBtn = tmpl.content.querySelector('.btn');
origBtn.addEventListener('click', () => console.log('click'));

// Clone:
const clone = tmpl.content.cloneNode(true);
const cloneBtn = clone.querySelector('.btn');
// cloneBtn does NOT have the click listener!
// You must re-add listeners after cloning

복제 후 리스너 추가

복제한 후 이벤트를 연결합니다.

function createCard(data) {
  const clone = document.getElementById('card-tmpl').content.cloneNode(true);

  const deleteBtn = clone.querySelector('.delete-btn');
  deleteBtn.addEventListener('click', () => deleteItem(data.id));

  clone.querySelector('.title').textContent = data.title;

  return clone;  // return the fragment
}

document.getElementById('list').appendChild(createCard(item));

importNode 사용

document.importNode는 cloneNode의 대안입니다.

const tmpl = document.getElementById('card-tmpl');

// Equivalent to tmpl.content.cloneNode(true):
const clone = document.importNode(tmpl.content, true);
// importNode adopts the node into the current document
// In the same document, this is functionally identical to cloneNode

template 슬롯 미리 보기

웹 구성 요소는 이름이 지정된 슬롯을 사용하여 template에 콘텐츠를 삽입합니다.

<template id="card-tmpl">
  <div class="card">
    <slot name="title">Default Title</slot>
    <slot name="body">Default body text.</slot>
  </div>
</template>
<!-- slot elements become placeholders for projected content -->
<!-- Covered in full in the Shadow DOM course -->

복제한 콘텐츠 업데이트

복제한 template 콘텐츠를 채우는 방법입니다.

const clone = tmpl.content.cloneNode(true);

// textContent — safe, no HTML parsing:
clone.querySelector('.name').textContent = user.name;

// innerHTML — only if content is trusted:
clone.querySelector('.bio').innerHTML = trustedHTML;

// setAttribute:
clone.querySelector('.avatar').src = user.avatar;
clone.querySelector('.profile-link').href = `/users/${user.id}`;

document.createElement와 비교

반복 항목에 template과 createElement를 사용하는 방법을 비교합니다.

// createElement: verbose for complex structures
const card = document.createElement('div');
card.className = 'card';
const title = document.createElement('h2');
card.appendChild(title);
// ... many lines for nested structure

// template: define once, clone efficiently
const clone = tmpl.content.cloneNode(true);
// Complex structure defined in HTML once
// Clone is fast and the template handles nesting

메모리와 template

template의 메모리 동작입니다.

  • template은 DocumentFragment로 메모리에 저장됩니다
  • 복제본은 서로 독립된 복사본이며 DOM에서 제거되면 가비지 컬렉터가 회수합니다
  • DOM 요소가 존재하는 동안 template 자체는 유지됩니다
  • 동적 template의 경우 함수 외부에 template 참조를 캐시합니다

브라우저 지원

template 요소 지원 현황입니다.

  • 2014년경부터 모든 최신 브라우저에서 지원됩니다
  • IE는 지원하지 않습니다(IE는 수명이 종료되었습니다)
  • 최신 프로젝트에는 폴리필이 필요하지 않습니다

빠른 확인

template을 복제한 후 이벤트 리스너를 다시 추가해야 하는 이유는 무엇입니까?

복습: cloneNode

cloneNode의 핵심 내용입니다.

  • cloneNode(true) — 모든 하위 항목을 포함하여 깊게 복사합니다
  • 이벤트 리스너는 NOT 복사되므로 복제한 후 다시 연결해야 합니다
  • 성능을 위해 DocumentFragment에 추가하는 작업을 일괄 처리합니다
  • 렌더링 반복문 외부에 template 참조를 캐시합니다
  • 안전한 텍스트 삽입에는 textContent를 사용합니다

자주 묻는 질문

“cloneNode로 템플릿 복제하기” 강의는 무료인가요?

네 — “cloneNode로 템플릿 복제하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 HTML Academy 강의 전체를 잠금 해제할 수 있습니다. HTML Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“cloneNode로 템플릿 복제하기”에서 뭘 배우나요?

cloneNode(true)로 템플릿 콘텐츠 효율적으로 복제하기 브라우저에서 직접 실행하는 실습 코드로 HTML Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

HTML Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 HTML Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.

“cloneNode로 템플릿 복제하기” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 HTML Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 HTML Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. template 요소 비활성 콘텐츠
  2. cloneNode로 템플릿 복제하기
  3. JavaScript 렌더링에 template 사용하기
  4. template과 innerHTML의 보안 비교
← HTML Academy(으)로 돌아가기