name 애트리뷰트의 값에 기초하여 개체들의 컬렉션을 반환한다.
반환값 oCollection은 지정된 엘레멘트 이름(name)들을 갖는 개체들의 컬렉션이다.
getElementsByName 메서드, 문서에 있는 지정한 name 이나 id 애트리뷰트 값을 갖는 모든 엘레멘트를 반환한다.
name과 id 애트리뷰트를 지원하는 엘레멘트는 getElementsByName 메서드에 의하여 반환된 컬렉션에 포함되지만, expando name 엘레멘트는 포함되지 않는다.
| 개체 | script | IE |
|---|
이 메서드는 (영어)DOM Level 1(Document Object Model Level 1)에서 정의되었다.
getElementsByName 메서드를 사용하여 name이 'name' 인 개체들의 컬렉션을 반환한다. id가 'name' 인 개체가 포함된다.
<SCRIPT>
function getNames(nb){
var aInput=document.getElementsByName('name');
showA.innerHTML=aInput[nb].value+'<BR>';
showA.innerHTML+='document.getElementsByName("name").length='+document.getElementsByName("name").length;
}
</SCRIPT>
<DIV id="name" style="border:solid 1 blue;width:600">name DIV</DIV>
<INPUT type="text" name="name" value="이순신">
<INPUT type="text" name="name" value="홍길동">
<INPUT type="text" name="name" value="Lincon"><BR>
<INPUT type="button" value="이름 #0 얻기" onclick="getNames(0)">
<INPUT type="button" value="이름 #1 얻기" onclick="getNames(1)">
<INPUT type="button" value="이름 #2 얻기" onclick="getNames(2)">
<INPUT type="button" value="이름 #3 얻기" onclick="getNames(3)">
<DIV id=showA>결과 표시창</DIV>