문서의 모든 깔린 embed 개체들의 배열변수인 컬렉션을 반환한다.

인수
: (개체)
필수적인 요소이고 컬렉션을 포함하는 모체 개체이다.

cVal : (컬렉션)
선택적인 요소이고 값은 컬렉션을 나타내는 개체이다.

oVal : (개체)
선택적인 요소이고 값은 컬렉션의 한개의 엘레멘트 개체이다.

index : (정수/문자열)
필수적인 요소이고 값은 컬렉션의 인수나 문자열로 한개의 엘레멘트 개체나 다른 컬렉션을 참조할수 있고 배열변수의 규칙에따라 0부터 시작하고 제일 마지막 인수는 길이보다 1 작다. 같은 name이나 id 속성을 가진 개체들이 있는 경우에는 컬렉션을 반환한다.

subIndex : (문자열)
선택적인 요소이고 값은 컬렉션의 반환받고저 하는 개체의 위치를 지정하며 name이나 id 속성값을 지정하는 문자열이다. 일치하는 개체나 컬렉션을 반환한다.

설명

인수(index)의 참조는 배열변수(Array 개체)의 인수를 사용한 참조방식에 준한다.
문자열 embeds가 배열변수가 되어 인수는 0부터 시작하여 document 개체의 첫 엠베드 개체의 인수는 0이고, embeds[0]으로 참조되며, 마지막 엠베드의 인수는 length-1이다.

적용
개체scriptHTML규격IE


설명을 위한 예제


length 속성 IE4 NS3
⇒ 문서의 엠베드 개체들을 위한 배열변수(embeds) 개체의 길이를 반환하거나 지정한다.
문법: [iVal=].length[=iVal]
코드: document.write(document.embeds.length) 결과:

item 메서드 IE
⇒ 인덱스로 컬렉션의 한개의 개체를 반환한다.
문법: [oVal=].item('iVal')
코드: document.write(oObj.item(1).nodeName 결과:
namedItem 메서드 IE6
⇒ 이름(name)이나 인식자(id) 문자열에 해당하는 컬렉션에서 한개의 개체나 하부 컬렉션을 반환한다.
문법: [oVal=].namedItem('sVal')
코드: document.write(oObj.namedItem('embed1Obj').src) 결과:
tags 메서드 IE
⇒ 컬렉션에서 HTML 엘레멘트 이름 문자열과 일치하는 엘레멘트들의 컬렉션이나 한개의 엘레맨트 개체를 반환한다.
문법: [oVal=].tags('sVal')
코드: document.write(oObj.tags('embed').length) 결과:
urns 메서드 IE
⇒ behavior가 첨부된 모든 개체의 컬렉션을 반환한다.
문법: [oVal=].urns('sVal')
코드: document.write(oObj.urns('../public/hilite.htc')) 결과:

간단한 embeds 컬렉션 예제

 
<SCRIPT>
br='<BR>';
document.write('document.embeds.length='+
  document.embeds.length+'개'+br);
document.write('document.embeds.embedObj.src='+
  document.embeds.embedObj.src+br);
document.write('document.embeds[0].src='+
  document.embeds[0].src+br)
</SCRIPT>

<EMBED id=embedObj src=http://trio.co.kr/sound/flute1.mid autostart=false>

페이지의 embeds 컬렉션 내역보기 예제

<SCRIPT>
str='#] id, hidden, autostart, src<BR>';
for (i=0;i< document.embeds.length;i++){
  str+=i+'] '+document.embeds[i].id+', '+document.embeds[i].hidden+', '+
    document.embeds[i].autostart+', '+document.embeds[i].src+'<BR>';
}
document.write(str)
</SCRIPT>