자바스크립트와 DOM: 페이지를 움직이기

브라우저 안에서 돌아가는 프로그래밍 언어, 자바스크립트로 페이지를 움직여요. 파이썬과 나란히 놓고 문법의 차이를 빠르게 익힌 뒤, DOM에서 요소를 찾고 글자와 모양을 바꾸고, 클릭과 입력 같은 이벤트에 반응하는 법을 배워요. 마지막으로 상태를 화면으로 그리는 방식으로 할 일 목록 앱을 만들고 브라우저에 저장해요. 모든 예제는 실제 크롬에서 실행해 결과를 확인했고, 초보자가 가장 많이 만나는 오류를 읽는 법까지 다뤄요.

초급강의 3 / 6약 17분

HTML이 뼈대, CSS가 모양이라면 자바스크립트는 동작이에요. 버튼을 누르면 메뉴가 펼쳐지고, 글자를 치는 동안 남은 글자 수가 줄어들고, 새로 고치지 않아도 새 글이 나타나는 일은 모두 자바스크립트가 해요. 자바스크립트는 모든 브라우저 안에 들어 있어서, 따로 설치하지 않아도 지금 바로 써 볼 수 있어요.

이름이 비슷하지만 자바(Java)와는 전혀 다른 언어예요. 이 강의에서는 프로그래밍 트랙에서 배운 파이썬과 비교하면서 빠르게 익히고, HTML 강의에서 본 DOM 나무를 코드로 고쳐서 페이지를 움직여 볼게요.

파이썬과 나란히 보기

하고 싶은 일파이썬자바스크립트
변수count = 3let count = 3; (바꾸지 않을 값은 const)
출력print(x)console.log(x)
목록[1, 2, 3][1, 2, 3] (배열)
이름과 값의 묶음{"name": "민지"} (사전){ name: "민지" } (객체)
함수def double(x): return x * 2function double(x) { return x * 2; }
짧은 함수lambda x: x * 2x => x * 2 (화살표 함수)
같은지 비교=====
참, 거짓, 없음True, False, Nonetrue, false, null과 undefined
코드 덩어리들여쓰기중괄호
목록 바꾸기[n * 2 for n in nums]nums.map(n => n * 2)

직접 실행해 볼게요. 브라우저에서 F12를 누르고 Console(콘솔) 탭에 붙여 넣으면 돼요.

let todoCount = 3;
const userName = "민지";
todoCount += 1;
console.log(`${userName}님의 할 일 ${todoCount}개`);
console.log("5" + 3, "5" - 3, "5" * "2");
console.log(0 == "", 0 === "", null == undefined, null === undefined);
const nums = [1, 2, 3, 4, 5];
console.log(JSON.stringify(nums.map(n => n * 2)), JSON.stringify(nums.filter(n => n % 2 === 1)));
const user = { name: "민지", age: 27 };
console.log(user.name, user["age"], Object.keys(user).join(","));
function greet(who, greeting = "안녕하세요") {
  return `${greeting}, ${who}님`;
}
const shout = (text) => text + "!";
console.log(greet("민지"), "|", shout(greet("준호", "반가워요")));
민지님의 할 일 4개
53 2 10
true false true false
[2,4,6,8,10] [1,3,5]
민지 27 name,age
안녕하세요, 민지님 | 반가워요, 준호님!
  • let과 const: let은 나중에 바꿀 수 있는 변수, const는 한 번 정하면 다시 넣을 수 없는 변수예요. 기본은 const로 쓰고, 바꿔야 할 때만 let을 써요. 옛 코드에 보이는 var는 쓰지 않아요.
  • 템플릿 문자열: 백틱(키보드 숫자 1 왼쪽의 기호)으로 감싼 문자열 안에 ${...}로 값을 끼워 넣어요. 파이썬의 f-문자열과 같아요.
  • 형이 저절로 바뀌어요. "5" + 3은 글자를 이어 붙여 "53"이 되고, "5" - 3은 숫자로 바꿔 계산해 2가 돼요. 파이썬이라면 둘 다 오류였을 거예요. 입력칸에서 받은 값은 늘 글자라서, 계산하기 전에 Number(값)으로 바꿔야 해요.
  • ===를 써요. ==는 비교하기 전에 형을 바꿔서 0 == ""가 참이 되는 것처럼 엉뚱한 결과를 내요. ===는 형까지 같아야 참이에요.
  • 배열의 map과 filter: 파이썬의 리스트 컴프리헨션이 하던 일을 해요. 콘솔에 배열을 그대로 찍으면 브라우저마다 모양이 달라서, 여기서는 JSON.stringify로 글자로 바꿔 찍었어요.
  • 함수: function으로 만들거나 화살표(=>)로 짧게 써요. 매개변수의 기본값도 파이썬처럼 쓸 수 있어요.

페이지에 자바스크립트 붙이기

실제 페이지에서는 코드를 파일로 따로 써서 불러와요.

<script src="app.js" defer></script>

head 안에 두고 defer를 꼭 붙여요. defer가 있으면 브라우저가 HTML을 다 읽은 뒤에 스크립트를 실행해요. 이게 없으면 스크립트가 먼저 실행돼서 아직 만들어지지 않은 요소를 찾다가 실패해요. 이 강의 끝에서 그 오류를 직접 볼 거예요.

이제부터 예제는 아래 페이지에서 이어서 따라 해요. dom.html로 저장해 브라우저로 열고, 콘솔에 예제를 순서대로 붙여 넣어요. 앞 예제에서 만든 변수를 뒤 예제에서 쓰기 때문이에요. 같은 예제를 두 번 붙여 넣으면 "이미 선언됐다"는 오류가 나는데, 그럴 땐 새로 고침하고 처음부터 다시 하면 돼요.

<!DOCTYPE html>
<html lang="ko">
<head><meta charset="utf-8"><title>DOM 실습</title></head>
<body>
  <h1 id="title">오늘의 공부</h1>
  <ul class="tasks">
    <li class="task">HTML</li>
    <li class="task done">CSS</li>
    <li class="task">자바스크립트</li>
  </ul>

  <label for="memo">한 줄 메모</label>
  <input id="memo" maxlength="20">
  <p>남은 글자: <span id="left">20</span></p>

  <form id="todo-form">
    <label for="todo-input">할 일</label>
    <input id="todo-input" autocomplete="off">
    <button>더하기</button>
  </form>
  <ul id="todo-list"></ul>
  <p id="todo-count"></p>
</body>
</html>

요소 찾기

DOM에서 요소를 찾을 때는 CSS 선택자를 그대로 써요. 앞 강의에서 배운 선택자가 여기서 다시 쓰여요.

const title = document.querySelector("#title");
const tasks = document.querySelectorAll(".task");
console.log(title.textContent, "|", tasks.length, "개");
console.log([...tasks].map(li => li.textContent).join(", "));
console.log(document.querySelector(".task.done").textContent);
console.log(document.querySelector("#nothing"));
오늘의 공부 | 3 개
HTML, CSS, 자바스크립트
CSS
null
  • querySelector는 조건에 맞는 첫 요소 하나를, querySelectorAll은 모두를 돌려줘요.
  • querySelectorAll의 결과는 배열과 비슷하지만 배열은 아니라서, [...tasks]처럼 펼쳐서 배열로 바꾼 뒤 map을 썼어요.
  • textContent는 요소 안의 글자예요.
  • 찾는 요소가 없으면 오류 대신 **null**을 돌려줘요. 이 null이 초보자가 가장 많이 만나는 오류의 씨앗이에요.

요소 바꾸기

찾은 요소의 글자, 클래스, 속성을 바꾸거나 새 요소를 만들어 넣을 수 있어요.

title.textContent = "오늘의 공부 (2/3)";
tasks[0].classList.add("done");
tasks[2].classList.toggle("done");
tasks[2].classList.toggle("done");
const item = document.createElement("li");
item.className = "task";
item.textContent = "<b>네트워크</b>";
document.querySelector(".tasks").append(item);
console.log(title.textContent);
console.log([...document.querySelectorAll(".task")]
  .map(t => t.textContent + (t.classList.contains("done") ? "(완료)" : ""))
  .join(", "));
console.log(item.innerHTML);
오늘의 공부 (2/3)
HTML(완료), CSS(완료), 자바스크립트, <b>네트워크</b>
&lt;b&gt;네트워크&lt;/b&gt;
  • classList: 클래스를 더하고(add), 빼고(remove), 있으면 빼고 없으면 더해요(toggle). 모양은 CSS에 .done 규칙으로 정해 두고, 자바스크립트는 클래스만 바꾸는 게 깔끔해요. 그래서 toggle을 두 번 한 셋째 항목은 원래대로 돌아왔어요.
  • 새 요소: createElement로 만들고, 내용을 채운 뒤 append로 원하는 곳에 붙여요. 화면에 바로 나타나요.
  • textContent와 innerHTML의 차이: 새 항목의 글자에 <b>를 넣었지만 굵은 글씨가 되지 않고 글자 그대로 보여요. textContent는 넣은 값을 글자로만 다루기 때문이에요. 요소의 HTML을 보면 &lt;b&gt;로 바뀌어 있어요. HTML 강의의 특수 문자 이야기 그대로예요. 반대로 innerHTML에 값을 넣으면 태그로 해석돼서, 사용자가 쓴 글을 넣었다가는 남의 스크립트가 실행될 수 있어요. 사용자가 입력한 값은 textContent로 넣어요.

이벤트: 사용자의 행동에 반응하기

클릭, 입력, 제출처럼 페이지에서 일어나는 일을 이벤트라고 해요. addEventListener로 "이 일이 생기면 이 함수를 실행해 줘"라고 등록해요.

const memo = document.querySelector("#memo");
const left = document.querySelector("#left");
memo.addEventListener("input", () => {
  left.textContent = memo.maxLength - memo.value.length;
});
memo.value = "안녕하세요";
memo.dispatchEvent(new Event("input"));       // 사람이 입력한 것처럼 이벤트를 일으켜요
console.log("남은 글자:", left.textContent);
남은 글자: 15

input 이벤트는 입력칸의 값이 바뀔 때마다 일어나요. 예제에서는 사람이 친 것처럼 이벤트를 직접 일으켰지만, 페이지의 입력칸에 직접 글자를 쳐 보면 칠 때마다 숫자가 줄어드는 게 보여요. 자주 쓰는 이벤트는 이런 것들이에요.

이벤트일어나는 때
click누를 때(키보드의 Enter로 버튼을 눌러도 일어나요)
input입력칸의 값이 바뀔 때마다
change값을 바꾸고 입력칸을 떠날 때, 선택 상자를 고를 때
submit양식을 제출할 때
keydown키를 누를 때

등록한 함수는 이벤트 객체를 받아요. 어떤 요소에서 일어났는지(event.target), 어떤 키였는지(event.key) 같은 정보가 들어 있고, event.preventDefault()로 브라우저의 기본 동작을 막을 수도 있어요. 양식을 제출하면 브라우저는 원래 페이지를 새로 불러오는데, 이걸 막고 자바스크립트로 처리하는 게 다음 예제예요.

작은 앱: 할 일 목록

지금까지 배운 것을 모아 할 일 목록을 만들어 볼게요. 핵심 아이디어는 상태와 화면을 나누는 것이에요. 할 일 목록이라는 데이터(상태)를 한 곳에 두고, 화면은 언제나 그 데이터를 보고 처음부터 다시 그려요(render). 무언가 바뀌면 데이터만 고치고 render를 불러요.

const state = { todos: JSON.parse(localStorage.getItem("todos") || "[]") };
const form = document.querySelector("#todo-form");
const input = document.querySelector("#todo-input");
const list = document.querySelector("#todo-list");
const counter = document.querySelector("#todo-count");

function render() {
  list.replaceChildren(...state.todos.map((todo, i) => {
    const li = document.createElement("li");
    li.dataset.index = i;
    li.classList.toggle("done", todo.done);
    const label = document.createElement("span");
    label.textContent = todo.text;              // innerHTML이 아니라 textContent
    const del = document.createElement("button");
    del.textContent = "지우기";
    del.className = "delete";
    li.append(label, del);
    return li;
  }));
  const left = state.todos.filter(t => !t.done).length;
  counter.textContent = `남은 일 ${left}개 / 전체 ${state.todos.length}개`;
  localStorage.setItem("todos", JSON.stringify(state.todos));
}

form.addEventListener("submit", (event) => {
  event.preventDefault();                       // 페이지를 새로 고치지 않게 막아요
  const text = input.value.trim();
  if (!text) return;
  state.todos.push({ text, done: false });
  input.value = "";
  render();
});

list.addEventListener("click", (event) => {     // 항목마다가 아니라 목록 하나에만 달아요
  const li = event.target.closest("li");
  if (!li) return;
  const i = Number(li.dataset.index);
  if (event.target.matches(".delete")) {
    state.todos.splice(i, 1);
  } else {
    state.todos[i].done = !state.todos[i].done;
  }
  render();
});

render();

사람이 쓰는 것처럼 할 일을 넣고, 누르고, 지워 볼게요.

for (const text of ["우유 사기", "<b>굵게?</b>", "   ", "강의 읽기"]) {
  input.value = text;
  form.requestSubmit();                          // 더하기 버튼을 누른 것과 같아요
}
console.log(counter.textContent);
list.children[0].querySelector("span").click();  // 첫 항목을 눌러 완료 표시
console.log(counter.textContent);
list.children[1].querySelector(".delete").click(); // 둘째 항목 지우기
console.log([...list.querySelectorAll("li span")].map(s => s.textContent).join(" | "));
console.log("저장된 값:", localStorage.getItem("todos"));
남은 일 3개 / 전체 3개
남은 일 2개 / 전체 3개
우유 사기 | 강의 읽기
저장된 값: [{"text":"우유 사기","done":true},{"text":"강의 읽기","done":false}]

넷을 넣었는데 셋만 들어갔어요. 공백뿐인 입력은 trim()으로 걸러 냈거든요. 코드에서 눈여겨볼 곳이 세 군데 있어요.

  • 이벤트 위임: 지우기 버튼마다 이벤트를 달지 않고 목록(ul) 하나에만 달았어요. 클릭은 누른 요소에서 시작해 부모 쪽으로 올라가며 전해지기 때문에(버블링), 목록에서 event.target을 보면 무엇을 눌렀는지 알 수 있어요. closest("li")는 누른 곳에서 가장 가까운 li 조상을 찾아요. 항목이 나중에 더 생겨도 따로 이벤트를 달 필요가 없어요.
  • data- 속성: li.dataset.index는 HTML에 data-index="0"으로 붙는 나만의 속성이에요. 화면의 항목과 데이터의 위치를 잇는 데 썼어요.
  • 브라우저에 저장: localStorage는 이 사이트 전용의 작은 저장소예요. 글자만 넣을 수 있어서 JSON.stringify로 바꿔 넣고, 꺼낼 때 JSON.parse로 되돌려요. 페이지를 새로 고쳐도 할 일이 남아 있어요. 다만 그 브라우저에만 남아서 다른 기기에서는 보이지 않고, 사용자가 사이트 데이터를 지우면 함께 사라져요.

"데이터가 바뀌면 화면을 다시 그린다"는 이 방식이 React 같은 프레임워크의 출발점이에요. 프레임워크는 다시 그릴 때 정말 바뀐 부분만 골라 고쳐 주는 일을 대신해 줘요. 이 이야기는 프레임워크 강의에서 이어 가요.

오류 읽기

초보자가 가장 많이 만나는 오류를 일부러 내 볼게요.

document.querySelector("#titel").textContent = "오타";    // id를 잘못 적었어요
Uncaught TypeError: Cannot set properties of null (setting 'textContent')

"null의 textContent를 바꿀 수 없다"는 뜻이에요. 앞에서 본 대로 querySelector가 요소를 못 찾으면 null을 돌려주는데, 그 null에 글자를 넣으려 했으니까요. 이 오류가 보이면 두 가지를 확인해요.

  1. 선택자에 오타가 없는지: #titel과 #title처럼요.
  2. 스크립트가 너무 일찍 실행되지 않았는지: defer 없이 head에서 스크립트를 불렀다면, 아직 그 요소가 만들어지기 전이에요.

오류 메시지 옆의 파일 이름과 줄 번호를 누르면 개발자 도구의 Sources(소스) 탭에서 그 줄로 바로 가요. 줄 번호를 누르면 중단점이 생겨서, 다음에 그 줄에 오면 실행이 멈추고 그 순간의 변수 값을 하나하나 볼 수 있어요. 코드에 debugger;를 한 줄 넣어도 같은 곳에서 멈춰요. console.log를 여기저기 찍는 것보다 훨씬 빨리 원인을 찾을 수 있어요.

실습

  1. 할 일 앱에 "완료한 일 모두 지우기" 버튼을 더해 보세요. filter 한 줄과 render()면 돼요.
  2. 할 일을 몇 개 넣고 페이지를 새로 고쳐 보세요. 할 일이 남아 있나요? 개발자 도구의 Application 탭에서 Local Storage를 열어 저장된 값을 확인해 보세요.
  3. render 안의 textContent를 innerHTML로 바꾸고 <b>굵게?</b>를 넣어 보세요. 무엇이 달라지고, 왜 위험한가요? 확인했으면 꼭 되돌려 놓으세요.
  4. 메모 입력칸에서 Enter를 누르면 메모를 지우는 keydown 이벤트를 더해 보세요. event.key === "Enter"로 확인해요.
  5. "5" + 3처럼 형이 저절로 바뀌는 다른 예를 콘솔에서 찾아보세요. [] + [], true + 1은 무엇이 되나요?

자주 하는 실수

  • 스크립트를 defer 없이 head에 둔다. 요소가 만들어지기 전에 찾아서 null 오류가 나요.
  • 입력값을 숫자로 바꾸지 않는다. 입력칸의 값은 늘 글자라서 "5" + 3이 "53"이 돼요. Number()로 바꿔요.
  • ==를 쓴다. 형이 바뀌어서 엉뚱한 참이 나와요. ===를 써요.
  • 사용자 입력을 innerHTML로 넣는다. 남의 스크립트가 실행될 수 있어요. textContent를 써요.
  • 양식 제출에서 preventDefault()를 빼먹는다. 페이지가 새로 고쳐지면서 방금 한 일이 사라져요.
  • 항목마다 이벤트를 단다. 나중에 생긴 항목에는 이벤트가 없어요. 부모에 하나만 달고 event.target으로 가려요.
  • 화면의 글자를 데이터처럼 쓴다. 화면에서 숫자를 읽어 계산하지 말고, 상태를 고친 뒤 화면을 다시 그려요.

점검 문제

  1. let과 const의 차이는? 기본으로 무엇을 쓰나요?
  2. "5" + 3과 "5" - 3의 결과가 다른 이유는?
  3. 0 == ""는 참인데 0 === ""는 거짓인 이유는?
  4. querySelector와 querySelectorAll의 차이, 그리고 찾는 요소가 없을 때의 결과는?
  5. 사용자가 입력한 글을 넣을 때 innerHTML 대신 textContent를 쓰는 이유는?
  6. 양식의 submit 이벤트에서 event.preventDefault()를 부르는 이유는?
  7. 이벤트 위임이란 무엇이고, 어떤 점이 좋은가요?
  8. Cannot set properties of null 오류가 났을 때 확인할 두 가지는?

정답

  1. let은 나중에 다른 값을 넣을 수 있고 const는 넣을 수 없어요. 기본으로 const를 쓰고, 바꿔야 할 때만 let을 써요.
  2. +는 한쪽이 글자면 글자를 이어 붙이고, -는 숫자 계산만 있어서 글자를 숫자로 바꿔 계산하기 때문이에요.
  3. ==는 비교하기 전에 형을 바꿔서 빈 글자를 0으로 보고, ===는 형까지 같아야 참이기 때문이에요.
  4. querySelector는 첫 요소 하나, querySelectorAll은 맞는 요소 모두를 돌려줘요. 없으면 querySelector는 null을, querySelectorAll은 빈 목록을 돌려줘요.
  5. textContent는 값을 글자로만 다뤄서 태그가 실행되지 않지만, innerHTML은 태그로 해석해서 남의 스크립트가 실행될 수 있기 때문이에요.
  6. 브라우저의 기본 동작인 페이지 새로 고침을 막고, 자바스크립트로 직접 처리하기 위해서예요.
  7. 자식마다 이벤트를 달지 않고 부모 하나에 달아서, 올라온 이벤트의 event.target으로 무엇을 눌렀는지 가리는 방법이에요. 이벤트를 하나만 달면 되고, 나중에 생긴 자식에도 저절로 적용돼요.
  8. 선택자에 오타가 없는지, 그리고 요소가 만들어지기 전에 스크립트가 실행되지 않았는지(defer)예요.

다음 강의

지금까지의 코드는 모두 그 자리에서 바로 끝났어요. 하지만 서버에서 데이터를 받아 오는 일은 몇 초가 걸릴 수도 있고, 그동안 페이지가 멈추면 안 돼요. 다음 강의에서는 기다리는 일을 다루는 비동기 프로그래밍과, fetch로 API를 불러 받은 데이터를 화면에 그리는 법을 배워요.