표준은 아니지만 웹개발자를 위하여 거의 표준처럼 사용된다.
현재 문서 내의 하위 요소들에 대하여 지정된 class
애트리뷰트를 갖는 요소들을 모두 찾아 HTMLCollection
으로 반환한다.
탐색 위치가 문서 전체를 대상으로 하는 것 이외에 Element
인터페이스의 getElementsByClassName() 메소드와 동일하다.
반환되는 HTMLCollection
객체는 현재 문서 내의 HTML 요소를 라이브(live) 상태로 참조한다. 따라서 어떠한 조건에 의하여 HTMLCollection
의 집합으로 존재하는 요소들은 수정 사항이 발생하면 자동으로 반영된다. 즉 조건의 부합 여부가 라이브로 처리된다.
document.getElementsByClassName(classNames)
찾을 대상의 class
애트리뷰트의 값을 지정한다. 두 개 이상의 class
는 공백으로 구분하여 지정한다.
지정된 class
로 찾은 Element
객체를 집합으로 갖는 HTMLCollection
객체를 반환한다. 대상이 없다면 null
을 반환한다.