WINDOW

settings_applicationsEventTarget  >   settings_applicationsNode  >   settings_applicationsDocument  >   settings_applications[[Prototype]]

WINDOW

Editing
  • account_tree
  • bug_report

HTMLCollectionhtmlCollectiongetElementsByClassName(stringclassNames)

현재 문서 내의 하위 요소들에 대하여 지정된 class 애트리뷰트를 갖는 요소들을 모두 찾아 HTMLCollection으로 반환한다.

설명

탐색 위치가 문서 전체를 대상으로 하는 것 이외에 Element 인터페이스의  getElementsByClassName() 메소드와 동일하다.

반환되는 HTMLCollection 객체는 현재 문서 내의 HTML 요소를 라이브(live) 상태로 참조한다. 따라서 어떠한 조건에 의하여 HTMLCollection의 집합으로 존재하는 요소들은 수정 사항이 발생하면 자동으로 반영된다. 즉 조건의 부합 여부가 라이브로 처리된다.

구문

형식
document.getElementsByClassName(classNames)

매개 변수

stringclassNames필수

찾을 대상의 class 애트리뷰트의 값을 지정한다. 두 개 이상의 class는 공백으로 구분하여 지정한다.

반환

HTMLCollectionhtmlCollection

지정된 class로 찾은 Element 객체를 집합으로 갖는 HTMLCollection 객체를 반환한다. 대상이 없다면 null을 반환한다.

About HTMLCollection Type
요소를 리스트 자료 구조로 가지고 있는 유사 배열 객체

지원 웹브라우저