Window

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

Window

Editing
  • settings_backup_restore
  • bug_report

HTMLCollectionhtmlCollectiongetElementsByClassName(stringclassNames)

표준은 아니지만 웹개발자를 위하여 거의 표준처럼 사용된다.

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

설명

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

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

구문

형식
document.getElementsByClassName(classNames)

매개 변수

stringclassNames필수

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

반환

HTMLCollectionhtmlCollection

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

지원 웹브라우저