querySelector로 HTML 요소 선택하는 방법
JavaScript로 버튼이나 문구를 찾아 바꾸고 싶은데 선택자 작성이 헷갈리는 상황
- 문제 상황 확인
- 짧은 코드로 재현
- 브라우저에서 결과 점검
querySelector로 HTML 요소 선택하는 방법에서 먼저 볼 부분
querySelector는 CSS 선택자 문법으로 HTML 요소 하나를 선택합니다. 선택자 기본기를 알면 DOM 조작이 쉬워집니다.
querySelector는 조건에 맞는 첫 번째 요소를 돌려줍니다. 여러 개를 모두 선택하려면 querySelectorAll을 사용합니다.
선택자는 CSS와 같은 방식입니다. class는 .name, id는 #name, 태그는 button처럼 작성합니다.
선택 결과가 null일 수 있으므로 스크립트 실행 시점과 HTML 구조를 함께 확인해야 합니다.
버튼과 문구 선택
const button = document.querySelector(".change-button");
const message = document.querySelector("#message");
button.addEventListener("click", () => {
message.textContent = "문구가 바뀌었습니다.";
});
이 예제는 그대로 복사해서 확인하는 것보다 한 줄씩 바꿔보는 쪽이 더 도움이 됩니다. 태그 이름, 선택자, 변수 이름, 함수 실행 위치를 조금씩 바꾸면 어떤 부분이 결과에 영향을 주는지 직접 확인할 수 있습니다.
잘못 작성했을 때 나타나는 흐름
JavaScript 글은 값이 언제 만들어지고 함수가 언제 실행되는지를 순서대로 따라가면 이해가 쉬워집니다.
console.log는 단순 확인용이 아니라 현재 값의 모양과 실행 흐름을 확인하는 가장 기본적인 디버깅 도구입니다.
DOM을 다루는 코드는 HTML 요소가 먼저 준비되었는지 확인해야 하며, 선택 결과가 null인지 보는 습관이 중요합니다.
브라우저에서 직접 확인하는 순서
먼저 화면에 나타나는 결과를 보고, 그다음 코드에서 방금 수정한 부분을 확인하세요. 결과가 예상과 다르다면 콘솔 오류, 파일 경로, 선택자 이름, 태그 닫힘, 실행 순서 중 하나가 흔한 원인입니다.
초보 단계에서는 정답 코드를 한 번에 외우기보다 실패한 코드와 수정한 코드를 나란히 비교하는 방식이 좋습니다. 이 글의 예제를 기준으로 작은 값을 바꿔보면 다음 글을 읽을 때도 기준이 더 선명해집니다.
실습 후 점검할 항목
- class 선택자 앞에 점을 붙였는지 확인하기
- id 선택자 앞에 #을 붙였는지 확인하기
- 요소가 실제로 HTML에 있는지 확인하기
- script가 DOM 생성 후 실행되는지 확인하기
공식 문서로 더 확인하기: JavaScript 공식 문서