KoXo 자바스크립트 - 컬렉션(collection) - ***

문서에 있는 모든 문서 자체나 frameSet로 지정된 프레임의 window 개체들의 컬렉션을 반환한다.

Script	[cVal]=object.frames
	[oVal]=object.frames(index)

인수

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

특기

HTML 문서가 body 태그를 포함하면 이 frames 컬렉션은 문서의 개체의 iFrame 개체들의 배열변수를 반환한다. 문서가 frameSet를 포함하면 각 frame 태그들의 배열변수를 반환한다. 규격에 의하여 두가지를 동시에 갖지는 않으나 갖는 경우는 HTML 소스에 나타나는 순서로 배열변수 인수가 결정된다.

컬렉션은 window 개체들만 포함하고 frame과 iFrame 개체들은 포함되지 않는다. frame과 iFrame 개체들을 호출하기 위해서는 document .all 컬렉션을 사용하면 된다.

컬렉션의 name 문자열로 item 메서드를 사용하여 컬렉션의 요소를 호출할 수 있으나 주어진 이름의 첫 윈도우 개체를 반환한다. 따라서 같은 이름의 윈도우를 한 문서에 사용하면 차질이 있을 수 있다.

적용

개체	script	HTML	규격	IE
document	[cVal]=document.frames	없음	없음	IE3.02(win16,win32,mac),IE4.0(ce,unix)
window	[cVal]=window.frames	없음	없음	IE3.02(win16,win32,mac),IE4.0(ce,unix)

collection ⇒

frames⇒

⇒

frames 설명을 위한 예제

collection ⇒

frames⇒

⇒

defaultStatus 속성 IE3.02 NS2
⇒ 윈도우의 디폴트로 출력되는 브라우저 왼측 맨아래 상태(status)바 메세지의 내용 문자열을 반환하거나 지정한다.

문법: objectObj.frames.defaultStatus[=sVal]

코드: <INPUT type=button value="마우스를 올리고 상태바를 보라" class=expx style=width:14em;float:right onMouseOver="oObj.defaultStatus='디폴트 상태바 메세지'" onMouseOut="oObj.defaultStatus=''">
결과: 마우스를 올리고 상태바를 보라.

item(개체) 속성 IE4 -
⇒ window의 frame 개체들를의 배열변수 항목을 반환하거나 지정한다.

문법: objectObj.frames.item[=oVal]

코드: document.write(frames.item) 결과: undefined
코드: document.write(frames.item.length) 결과:
코드: document.write(top.frames.item[0].name) 결과:
코드: document.write(top.frames.item('jsvmenu').location) 결과:

참고 : iFrame 호출

문법: [oVal=]document.all.tags('IFRAME')

코드: document.write(document.all.tags('iframe')[0].src) 결과:
코드: document.write(document.all['iframeObj'].src) 결과: http://trio.co.kr/club/public/clock.html

length 속성 IE3.02 NS2
⇒ 컬렉션에 frame 개체가 몇개 포함되어 있는가를 반환한다.

문법: [iVal=]objectObj.frames.length

코드: document.write(oObj.length); 결과: 1

collection ⇒

frames⇒

⇒

item 메서드 IE
⇒ 인덱스로 frames 컬렉션의 한개의 개체를 반환한다.

문법: [oVal=]objectObj.frames.item('iVal')

코드: document.write(oObj.item(1).name 결과:
코드: document.write(oObj.item('jsright').location) 결과:

namedItem 메서드 IE6
⇒ 이름(name)이나 인식자(id) 문자열에 해당하는 frames 컬렉션에서 한개의 개체나 하부 컬렉션을 반환한다.

문법: [oVal=]objectObj.frames.namedItem('sVal')

코드: document.write(oObj.namedItem('jsright')) 결과:
코드: document.write(oObj.namedItem('jsright').location) 결과:

collection ⇒

frames⇒

⇒

frames 컬렉션 예제 1

top.frames[0].location=about:blank

<SCRIPT>
frameCol=top.frames;
for (i=0; i< frameCol.length;i++){
  document.write('top.frames['+i+'].location='+frameCol[i].location+'<BR>');
}

frames 컬렉션 예제 2

window.parent.frames[0].location=about:blank

<SCRIPT>
frameCol=window.parent.frames;
for (i=0; i< frameCol.length;i++){
  document.write('window.parent.frames['+i+'].location='+frameCol[i].location+'<BR>');
}

collection ⇒

frames

⇒

최종 수정:
05/06/2025 10:55:59

비정상적인 방식으로 프레임없이 페이지에 접속하면 자주 오류가 발생됩니다.
오류가 나면 정상적 접속으로 시도해 보세요.

http://koxo.com/lang/js/object/frames.html

document.write(fileName)frames 컬렉션 예제 2

frames 컬렉션 예제 2