새로운 window를 열고 주소(URL)에서 지정한 문서을 로딩하고 디스플레이하다.

인수/파라메터

window : (윈도우 개체)

선택적인 요소이며, 윈도우 창를 나타내는 window 개체이다.

open : (열기 메서드)

필수적인 요소이며, 새로운 윈도우 창을 여는 메서드이다.

sURL : (문서의 주소)

선택적인 요소이며, 디스플레이될 문서의 주소를 지정하는 문자열이다. 이 주소가 지정되니 않으면(null ('')) about:blank로 새로운 윈도우가 디스플레이된다.

sTarget : (목표창 이름)

선택적인 요소이며, 윈도우의 이름을 지정하는 문자열이다. form 혹은 a 엘레멘트의 target 애트리뷰트의 값이 이름으로 사용된다.

가능한 값은..

name	연결된 문서를 읽어 지정한 이름의 윈도우나 프레임(frame)
_blank	연결된 문서를 읽어 새로운 빈 윈도우에 표시한다. 윈도우 이름은 없다.
_media	연결된 문서를 읽어 메디아바의 HTML 내용부분에 표시한다. IE6부터 적용된다.
_parent	연결된 문서를 읽어 바로 상위 모체창에 표시한다.
_search	연결된 문서를 읽어 브라우저의 검색창에 표시한다. IE5부터 적용된다.
_self	디폴트이며, 연결된 문서를 읽어 현재창에 표시한다.
_top	연결된 문서를 읽어 최상위 윈도우에 표시한다.

sStatus : (윈도우의 상태)

선택적인 요소이며, 윈도우의 상태를 지정하기 위해 선택적으로 사용하는 윈도우의 특성과 값들의 문자열이다. 많은 경우 yes, no로 설정하는데 대신 1, 0으로 하거나 필요한 항목만 열거하여도 된다.

분리는 컴마(',')로 하고 빈칸을 넣어서는 안되며, 전체를 따옴표의 짝안에 넣어야 한다.

sStatus=
'toolbar=yes,location=no,status=yes,menubar=yes,scrollbars=yes,resizable=yes,width=600,height=400,top=100,left=100';

sStatus='toolbar=1,location=0,status=1,menubar=1,scrollbars=1,resizable=1,width=600,height=400,top=100,left=100';

디폴트는 yes인 경우 단순한 목록 열거도 가능하다.

sStatus='toolbar,location,status,menubar,scrollbars,resizable,width=600,height=400,top=100,left=100';

위 세가지는 모두 동일하다.

디폴트로 open 메서드는 디폴트 너비와 높이, 그리고 표준 메뉴(menu), 둘바(toolbar), 그리고 익스플로러 윈도우 창의 다른 특성들을 갖는 윈도우를 생성한다. 윈도우의 특성을 수정하기 위하여 다음 표와 같은 문자열로 sStatus 파라메터를 사용한다.

윈도우 상태 sStatus 파라메터가 지정되면, 지정되지 않은 파라메터들은 불활성화 된다. 따라서 sStatus 파라메터를 사용할 때, 윈도우 상태에 포함될 모든 특성을 지정할 필요가 있다. sStatus 파라메터가 지정되지 않으면, 윈도우는 디폴트값들의 상태를 갖는다. 상태를 활성화 시키는 값을 할당하는 대신 단순히 상태 이름을 열거하여도 활성화된다.

가능한 값은 ...

status	선택	디폴트	설명	비고
channelmode	[=yes|no|1|0]	no	윈도우를 channelmode로 열 것인가?	윈도우 크기, 위치등 설정 무시
	윈도우 디스플레이를 극장모드로 챈널밴드를 천천히한다.
directories	[=yes|no|1|0]	yes	directory buttons를 열 것인가?	'연결'
fullscreen	[=yes|no|1|0]	no	윈도우를 전체화면(F11)으로 열 것인가?	윈도우 크기, 위치등 설정 무시
	단추, 메뉴들이 감춰지므로 항상 되돌아 올수 있는 방식을 제공하도록 전체화면으로는 조심해서 사용하라. ALT+F4은 새로운 윈도우를 닫는다. 전체화면 모드는 또한 극장모드(channelmode)이어야 한다.
height	=nn (pixels)		높이 픽셀 수치 정수(최소값:100)	윈도우의 높이
left	=nn (pixels)		왼쪽에서 오프세트 픽셀 수치 정수로 0과 같거나 보다 커야함	윈도우의 위치 x 좌표
NSscreenX
location	[=yes|no|1|0]	yes	location:box를 열 것인가?	'주소(D)' 입력창
menubar	[=yes|no|1|0]	yes	menu bar를 열 것인가?	화일, 편집, 보기,...
resizable	[=yes|no|1|0]	yes	윈도우 크기 조정을 가능하게 하는가?	드래그로 창 크기 조정 가능
scrollbars	[=yes|no|1|0]	yes	scrollbars를 열 것인가?	상하, 좌우 굴림바가 필요할때 나타남
status	[=yes|no|1|0]	yes	status bar를 열 것인가?	제일 아래 링크, 상태 표시 나오는 줄
titlebar	[=yes|no|1|0]	yes	제목줄이 보일 것인가?	제목줄이 보인다.
	HTA 적용이거나 안전한 대화창에서 호출한 것이 아니면 이 파라메터는 무시된다.
top	=nn (pixels)		맨위에서 오프세트 픽셀 수치 정수로 0과 같거나 보다 커야함	윈도우의 위치 y 좌표
NSscreenY
toolbar	[=yes|no|1|0]	yes	toolbar를 열 것인가 ?	'뒤로', '앞으로', '중지', '홈'
width	=nn (pixels)		너비 픽셀 수치 정수(최소값:100)	윈도우의 너비

statusNS	설명
alwaysLoweredNS	yes	항상 다른 윈도우 아래 깔리는 윈도우를 만든다.
alwaysRaisedNS	yes	항상 다른 윈도우 위에 뜨는 윈도우를 만든다.
dependentNS	yes	새로운 윈도우가 자식창으로 만들어 진다. 모체창이 닫히면 닫히고, 현재 창 프래트폼의 task bar에 나타나지 않는다.
hotkeysNS	no	security와 종료를 위한 것 이외에는 메뉴바(menubar) 없이 hotkey들의 사용이 중지된다.
innerHeightNS	창 내부 높이를 픽셀단위로 설정한다.
innerWidthNS	창 내부 너비를 픽셀단위로 설정한다.
outerHeightNS	창 외부 높이를 픽셀단위로 설정한다.
outerWidthNS	창 외부 너비를 픽셀단위로 설정한다.
titlebarNS	yes	새창은 표준 제목창(title bar)을 갖는다.
z-lockNS	yes	새창이 초점을 받았을때 다른창 위에 뜨는 것을 방지한다.

bReplace

선택적인 요소이며, 동일한 윈도우에 sURL이 로딩되면, 윈도우 방문기록(history) 목록에서 sURL이 새로운 것인가 기존의 문서을 대체할 것인가를 나타내는 부울값이다.

true	sURL을 history목록 상에서 기존 문서로 대체한다.
false	sURL을 history목록 상에서 새로운 문서로 등록한다.

반환값

반환값 oNewWin은 새로운 윈도우(window) 개체를 참조하는 명칭이다. 이 문자열로 새로운 윈도우의 속성들과 메서드등에 접속할 수 있다.

특기

이 open로 연 윈도우를 close 메서드로 닫을 수있다.

IE5에서는 open 메서드의 sStatus 파라메터에서 title 바의 적용을 통한 윈도우의 추가적인 제어가 가능하다. Microsoft Visual Basic이나 HTA(HTML Application) 같은 안전한 양식의 윈도우에서 제목줄 없이 윈도우를 열 수 있다. 각각 브라우저가 아닌 익스플로러의 인터페이스를 사용므로, 이들 적용은 안전한 것으로 간주된다.

IE6에서 sTarget 파라메터의 값이 _media이면 이 메서드가 메디어바(Media Bar)에 있는 주소를 로딩한다는 것을 지정한다.

window.open(), window.close()와 document.open(), document.close()는 구별하여야 한다.

이벤트처리자와 open 메서드를 사용하는 경우, 앞에 document. 없이 단순히 open()으로 메서드를 호출하는 것은 Javascript 상의 정적 개체로 인해 새로운 document.open()에 해당하는 document 개체를 생성한다. 이는 window 개체가 아니다.

적용

개체	script	IE

참조

open(document) open(window) close(document) close(window)
closed onbeforeunload

이 메서드는 (영어)DOM Level 1(Document Object Model Level 1)에서 정의되었다.

open 메서드 예제

<SCRIPT>
function openNew(){
  open('about:blank');
}
</SCRIPT>
<BUTTON onclick=openNew()>빈문서의 윈도우 열기.</BUTTON>

document.open 메서드 예제

<BUTTON onclick="open('exp/wnewdoc.html');">단추를 클릭하여 문서를 연다.</BUTTON>

윈도우 open, close 메서드 예제

<SCRIPT>
function newWinTest(){
  newWin=window.open('','','toolbar=no,scrollbars=no,top=200,left=300,width=170,height=50');
  var str='새창 열기/닫기 예제<BR><BR>';
  str+='<CENTER><INPUT type=button value="닫기" onClick="window.close()"></CENTER>';
  newWin.document.write(str);
}
</SCRIPT>

<FORM><INPUT type="button" value="새창 열기" onClick="newWinTest()"></FORM>

document.open, close 메서드 예제 3

<SCRIPT>
function doReplace(){
  var oNewDoc=document.open('text/html','replace');
  var newHTML='<HTML><HEAD><TITLE>새로운 문서</TITLE><BODY><DIV style=margin:10em;text-align:center>';
  newHTML+='문서 본체가 바뀐 새 문서<BR><BR>원래의 문서가 없어짐<BR><BR>';
  newHTML+='<A href=javascript:history.back()>이전 페이지로</A>';
  newHTML+='</DIV></BODY></HTML>';
  oNewDoc.write(newHTML);
  oNewDoc.close();
}
</SCRIPT>
<BUTTON onclick="doReplace();">클릭하여 문서의 내용을 바뀐다.</BUTTON>