HTML DOM 문서 getElementsByName() 메서드

정의와 사용법

getElementsByName() 메서드는 지정된 이름을 가진 요소 집합을 반환합니다。

getElementsByName() 메서드는 실시간 NodeList。

NodeList

NodeList 배열과 유사한 노드 집합(목록)입니다。

목록의 노드에 인덱스를 통해 접근할 수 있습니다. 인덱스는 0에서 시작합니다。

length 속성이 반환하는 목록의 노드 수를 반환합니다。

다른 참조를 참조하십시오：

getElementById() 메서드

getElementsByTagName() 메서드

getElementsByClassName() 메서드

querySelector() 메서드

querySelectorAll() 메서드

NodeList 참조 매뉴얼

예제

예제 1

"fname" 이름을 가진 모든 요소를 가져옵니다:

let elements = document.getElementsByName("fname");

직접 시도해보세요

예제 2

name="animal"인 요소의 수를 반환합니다:

let num = document.getElementsByName("animal").length;

직접 시도해보세요

예제 3

type="checkbox"이고 이름이 "animal"인 모든 <input> 요소를 확인하세요:

const collection = document.getElementsByName("animal");
for (let i = 0; i < collection.length; i++) {
  if (collection[i].type == "checkbox") {
    collection[i].checked = true;
  }
}

직접 시도해보세요

문법

document.getElementsByName(이름)

파라미터

파라미터 설명
이름 필수. 요소 name 속성의 값.

반환 값

타입 설명
객체

NodeList 객체.

지정된 이름을 가진 요소의 집합입니다.

요소가 문서에서 나타나는 순서에 따라 정렬됩니다.

브라우저 지원

document.getElementsByName() DOM Level 1 (1998) 기능입니다.

모든 브라우저가 지원합니다:

크롬 IE 에지 파이어폭스 사파리 오페라
크롬 IE 에지 파이어폭스 사파리 오페라
지원 9-11 지원 지원 지원 지원