Document.querySelector()

selectors

하나 이상의 선택자를 포함한 DOMString. 유효한 CSS 선택자여야만 하며 아닐 경우 SYNTAX_ERR 예외가 발생합니다. 선택자로 DOM 요소 선택하기 문서를 참고해 선택자와 선택자 작성 방법을 더 알아보세요.

제공한 CSS 선택자를 만족하는 첫 번째 Element (en-US) 객체. 결과가 없다면 null.

선택자를 만족하는 모든 요소의 목록이 필요하다면 querySelectorAll()을 대신 사용하세요.

SYNTAX_ERR

selectors의 구문이 유효하지 않음.

만약 selector가 ID 선택자인데, 해당 ID를 잘못 사용하여 문서 내에 여러 번 사용했으면 첫 번째로 그 ID를 사용한 요소를 반환합니다.

CSS 의사 요소는 선택자 API가 명시한 대로 어떠한 요소도 반환하지 않습니다.

CSS 구문을 따르지 않는, 예컨대 콜론이나 공백을 포함한 선택자나 ID를 사용해야 하면 반드시 백슬래시("\")를 사용해 해당 문자를 이스케이프해야 합니다. 백슬래시는 JavaScript의 이스케이프 문자이기 때문에, 백슬래시를 문자로 입력하려면 반드시 두 번 이스케이프해야 합니다. 한 번은 JavaScript 문자열에 필요하고, 또 다른 한 번은 querySelector()에 필요합니다.

<div id="foo\bar"></div>
<div id="foo:bar"></div>

<script>
  console.log("#foo\bar"); // "#fooar" ('\b'는 백스페이스 컨트롤 문자)
  document.querySelector("#foo\bar"); // 일치하는 요소 없음

  console.log("#foo\\bar"); // "#foo\bar"
  console.log("#foo\\\\bar"); // "#foo\\bar"
  document.querySelector("#foo\\bar"); // 첫 번째 <div>

  document.querySelector("#foo:bar"); // 일치하는 요소 없음
  document.querySelector("#foo\\:bar"); // 두 번째 <div>
</script>

아래 예제는 문서에서 "myclass"라는 클래스를 사용하는 첫 번째 요소를 반환합니다.

var el = document.querySelector(".myclass");

아래 예제처럼 정말 강력한 선택자도 사용할 수 있습니다. 예제의 결과는 클래스가 "user-panel main"인 <div> (en-US)(<div class="user-panel main">) 안의, 이름이 "login"인 <input> (en-US) 중 첫 번째 요소입니다.

var el = document.querySelector("div.user-panel.main input[name=login]");

• 선택자로 DOM 요소 선택하기
• element.querySelector() (en-US)
• document.querySelectorAll()
• element.querySelectorAll() (en-US)