콘텐츠 변경: textContent, innerHTML, classList
요소의 텍스트 콘텐츠를 읽고 업데이트하며 HTML을 삽입하고 CSS class를 프로그래밍 방식으로 전환, 추가, 제거합니다.
콘텐츠 변경: textContent, innerHTML, classList은(는) CoddyKit의 무료 Frontend Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Frontend Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Frontend Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
textContent 읽기와 쓰기
element.textContent는 모든 하위 요소를 포함한 요소의 일반 텍스트 콘텐츠를 가져오거나 설정합니다. HTML을 해석하지 않으므로 안전합니다. 따라서 사용자 입력으로 설정해도 XSS 취약점이 발생하지 않습니다.
const heading = document.querySelector('h1');
console.log(heading.textContent); // read
heading.textContent = 'New Title'; // write — replaces all children
// Safe with user input:
element.textContent = userInput; // no XSS riskinnerHTML — 주의해서 사용하기
element.innerHTML은 요소 내부의 HTML 마크업을 가져오거나 설정합니다. 편리하지만 사용자 입력과 함께 사용하면 위험합니다. HTML을 해석하여 스크립트를 실행할 수 있으므로 XSS가 제거되지 않은 사용자 데이터로 innerHTML을 설정하지 마십시오.
card.innerHTML = '<strong>Loading...</strong>'; // safe: hardcoded string
// DANGER — never do this:
element.innerHTML = userInput; // XSS vulnerability
// Safe alternative:
const div = document.createElement('div');
div.textContent = userInput; // won't parse as HTMLinnerText와 textContent 비교
innerText는 화면에 표시되는 텍스트만 반환하며(CSS에서 표시하지 않도록 설정된 요소는 제외) 레이아웃을 다시 계산합니다. textContent는 숨겨진 텍스트를 포함한 모든 텍스트를 반환하며 더 빠릅니다. 특별히 화면에 표시되는 텍스트가 필요한 경우가 아니라면 textContent를 사용하십시오.
classList — 클래스 추가 및 제거
element.classList는 전체 className 문자열을 직접 다루지 않고 CSS 클래스를 수정하는 메서드를 제공합니다. add(), remove(), toggle(), contains(), replace()를 사용할 수 있습니다.
const btn = document.querySelector('.btn');
btn.classList.add('active'); // add a class
btn.classList.remove('disabled'); // remove a class
btn.classList.toggle('open'); // add if absent, remove if present
console.log(btn.classList.contains('active')); // true강제 매개변수를 사용한 toggle
classList.toggle('class', condition)은 condition이 참 같은 값이면 클래스를 추가하고, 거짓 같은 값이면 제거합니다. 클래스를 불리언 상태와 동기화하는 깔끔한 방법입니다.
const isDark = true;
document.body.classList.toggle('dark-mode', isDark);
// No more: if/else with add/remove속성 읽기와 설정
element.getAttribute('attr')는 모든 속성을 읽습니다. element.setAttribute('attr', value)는 속성을 설정합니다. element.removeAttribute('attr')는 속성을 제거합니다. element.hasAttribute('attr')는 속성의 존재 여부를 확인합니다.
const img = document.querySelector('img');
console.log(img.getAttribute('alt'));
img.setAttribute('alt', 'New description');
img.removeAttribute('loading');data-* 속성
사용자 지정 data-* 속성은 DOM에 영향을 주지 않고 요소에 추가 데이터를 저장합니다. element.dataset을 통해 camelCase 형식으로 접근할 수 있습니다.
<div id="card" data-user-id="42" data-role="admin"></div>
const card = document.querySelector('#card');
console.log(card.dataset.userId); // '42'
console.log(card.dataset.role); // 'admin'
card.dataset.status = 'active'; // sets data-status스타일 속성
element.style.propertyName은 인라인 스타일을 설정합니다. 하이픈이 포함된 속성에는 camelCase를 사용하십시오. 인라인 스타일을 직접 설정하기보다는 CSS 클래스를 toggle하는 것이 좋습니다. 클래스는 스타일을 CSS 파일에 두어야 할 위치에 유지해 줍니다.
element.style.backgroundColor = '#e2e8f0'; // camelCase
element.style.marginTop = '16px';
element.style.display = 'none';
// Reset inline style:
element.style.removeProperty('background-color');계산된 스타일 읽기
getComputedStyle(element)은 인라인 스타일만이 아니라 스타일 규칙의 적용 결과로 실제 적용된 스타일을 반환합니다. CSS 클래스나 브라우저 기본값으로 설정된 스타일을 읽을 때 사용하십시오.
const el = document.querySelector('.card');
const styles = getComputedStyle(el);
console.log(styles.fontSize); // '16px'
console.log(styles.display); // 'flex'title과 meta 태그 수정
문서 제목(브라우저 탭)은 document.title = 'New Title'을 사용하여 언제든지 변경할 수 있습니다. SPA에서는 뷰 사이를 이동할 때 더 나은 사용자 경험을 제공할 수 있습니다.
// Update tab title on route change:
document.title = `${pageName} | MyApp`;scrollIntoView()
element.scrollIntoView({ behavior: 'smooth' })는 요소가 화면에 나타나도록 부드럽게 스크롤합니다. 섹션으로 이동하는 스크롤 내비게이션이나 폼의 유효성 검사 오류를 강조 표시할 때 적합합니다.
document.querySelector('#pricing').scrollIntoView({ behavior: 'smooth', block: 'start' });빠른 확인
XSS 위험 없이 DOM에 사용자가 제공한 텍스트를 안전하게 표시하려면 어떤 속성을 사용해야 합니까?
복습: DOM 수정
textContent는 일반 텍스트를 안전하게 설정합니다. innerHTML은 HTML을 설정하므로 사용자 입력과 함께 사용하면 위험합니다. classList.add/remove/toggle은 CSS 클래스를 깔끔하게 처리합니다. setAttribute와 dataset은 HTML 속성을 관리합니다. 인라인 스타일보다 클래스 toggle을 우선 사용하십시오. getComputedStyle은 최종적으로 적용된 스타일을 읽습니다.
자주 묻는 질문
“콘텐츠 변경: textContent, innerHTML, classList” 강의는 무료인가요?
네 — “콘텐츠 변경: textContent, innerHTML, classList” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Frontend Academy 강의 전체를 잠금 해제할 수 있습니다. Frontend Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“콘텐츠 변경: textContent, innerHTML, classList”에서 뭘 배우나요?
요소의 텍스트 콘텐츠를 읽고 업데이트하며 HTML을 삽입하고 CSS class를 프로그래밍 방식으로 전환, 추가, 제거합니다. 브라우저에서 직접 실행하는 실습 코드로 Frontend Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Frontend Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Frontend Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.
“콘텐츠 변경: textContent, innerHTML, classList” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Frontend Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Frontend Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- querySelector 및 querySelectorAll
- addEventListener 및 이벤트 객체
- 콘텐츠 변경: textContent, innerHTML, classList
- 요소 생성 및 추가