HOWTO · JavaScript
JavaScript에서 CSS 클래스 변경
클릭으로 동작하는 예를 포함해 className과 classList로 요소의 CSS 클래스를 변경하는 방법을 알아보세요.
이 페이지의 내용
JavaScript로 요소의 모양을 변경하려면 요소를 선택하고 그 클래스를 업데이트하세요. 클래스 속성 전체를 교체할 때는 className을 할당하고, 다른 클래스는 유지하면서 개별 클래스 토큰을 추가, 제거 또는 교체할 때는 classList를 사용하세요. 클릭 리스너를 사용하면 독자의 동작에 반응해 변경을 적용할 수 있습니다.
JavaScript에서 CSS 클래스를 변경하는 다양한 방법
아래의 완성된 페이지는 div에 dimensions라는 ID를 부여하고 CSS 클래스로 크기와 배경을 제어합니다. 초기 클래스 bg_1은 진홍색 배경을 설정합니다. 요소를 클릭하면 해당 클래스가 제거되고 청록색 배경을 설정하는 bg_2가 추가됩니다. 페이지를 HTML 파일로 저장하고 브라우저에서 열면 전환되는 모습을 볼 수 있습니다.
className 속성 사용하기
className은 메서드가 아니라 속성입니다. 문자열을 할당하면 요소의 클래스 속성 전체가 교체됩니다. 예를 들어 "dimensions bg_2"로 설정하면 배경이 바뀌고 크기 클래스는 유지됩니다. "bg_2"로만 설정하면 dimensions도 제거되므로, 요소가 유지해야 할 모든 클래스를 포함하세요. 이 방식은 알려진 상태 클래스 그룹을 한 번에 적용하는 경우처럼 전체 클래스 집합을 의도적으로 정의하려는 경우에 유용합니다.
classList.remove와 classList.add 사용하기
classList는 개별 클래스 토큰을 편집하는 메서드를 제공하는 속성입니다. classList.remove("bg_1")와 classList.add("bg_2")를 호출하면 dimensions나 관련 없는 다른 클래스에 영향을 주지 않고 배경 클래스를 변경할 수 있습니다. add는 이미 있는 토큰을 중복해서 추가하지 않으며, remove는 지정한 토큰에만 영향을 줍니다. 페이지의 다른 동작이 추가한 클래스를 포함해, 그대로 유지되어야 할 클래스가 요소에 있을 때 이 연산들을 사용하세요.
classList.replace() 메서드 사용하기
classList.replace("bg_1", "bg_2")는 하나의 토큰을 다른 토큰으로 교체하고 다른 클래스는 그대로 둡니다. 교체는 bg_1이 있을 때만 일어나며, 기존 토큰이 없으면 어떤 토큰도 변경되지 않습니다. 하나의 클래스 상태가 다른 상태로 직접 대응할 때 이 메서드를 선택하세요. remove와 add를 따로 호출하는 방식은 두 연산을 명시적으로 드러내고 싶거나, 핸들러가 그 사이에 다른 작업을 해야 할 때 유용합니다.
다음은 스타일, 요소, 클릭 핸들러를 모두 포함한 완성된 HTML 페이지입니다. 끝에 있는 작은 JavaScript 어댑터는 같은 페이지 상호작용을 모델링하여 예제가 결정적인 콘솔 결과를 갖도록 합니다. 브라우저에서는 페이지의 인라인 스크립트가 실제 클릭을 처리합니다.
const html = `<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Change a CSS class</title>
<style>
.dimensions { width: 200px; height: 100px; }
.bg_1 { background-color: crimson; }
.bg_2 { background-color: teal; }
</style>
</head>
<body>
<div id="dimensions" class="dimensions bg_1">Click this box</div>
<script>
const element = document.getElementById("dimensions");
element.addEventListener("click", () => {
element.classList.remove("bg_1");
element.classList.add("bg_2");
});
</script>
</body>
</html>`;
const element = {
className: "dimensions bg_1",
addEventListener(type, handler) {
this.handler = handler;
},
classList: {
remove(token) {
element.className = element.className
.split(" ")
.filter((name) => name !== token)
.join(" ");
},
add(token) {
const names = element.className.split(" ");
if (!names.includes(token)) names.push(token);
element.className = names.join(" ");
}
}
};
const document = { getElementById: () => element };
const selected = document.getElementById("dimensions");
selected.addEventListener("click", () => {
selected.classList.remove("bg_1");
selected.classList.add("bg_2");
});
selected.handler();
console.log(selected.className);
dimensions bg_2
브라우저 부분은 실제 DOM 패턴을 보여줍니다. document.getElementById("dimensions")가 요소를 반환하고, addEventListener가 클릭 시 실행되는 콜백을 등록합니다. Node.js는 기본적으로 페이지의 DOM을 제공하지 않으므로, Node.js 어댑터는 콘솔 출력을 위해 클래스 토큰 변경을 재현합니다. 눈에 보이는 색상은 스타일시트가 결정합니다. 대응하는 CSS 규칙이 없으면 클래스 이름만 변경해서는 시각적 효과가 없습니다. 직접 전체를 교체하려면 className을 사용하고 유지할 모든 클래스를 나열하세요. 크기, 레이아웃, 관련 없는 상태 클래스를 건드리지 않는 목표 지향적 변경에는 classList 메서드를 사용하세요. 핸들러가 아무 동작도 하지 않는 것처럼 보이면 ID가 일치하는지, 두 배경 클래스가 모두 페이지의 스타일시트에 정의되어 있는지 확인하세요.