지정한 HTML 문서를 표시하기위한 대화창을 생성하여 디스플레이한다.
필수적인 요소이며, window 개체이다.
선택적인 요소이며, 문서을 대화창에 디스플레이할 떄 사용되는 인수를 지정하는 값이다. 이 파라메터를 사용하면, 배열변수를 포함하여 어떤 형식의 값도 전달할 수 있다. 대화창은 호출자에 의하여 전달된 값들을 window 개체의 dialogArguments 속성으로부터 추출하여 사용한다.
| dialogHeight:sHeight | 대화창을 높이를 단위를 동반하여 지정한다.(단위 참조) |
| dialogLeft:sXPos | 데스크톱에 상대적인 대화창을 수평거리를 픽셀단위로 지정한다. |
| dialogTop:sYPos | 데스크톱에 상대적인 대화창을 수직거리를 픽셀단위로 지정한다. |
| dialogWidth:sWidth | 대화창을 너비를 단위를 동반하여 지정한다.(단위 참조) |
| center:{yes|no|1|0|on|off } | 데스크톱에서 대화창을 중앙에 위치시킬 것인가를 지정한다. 디폴트는 yes이다. |
| dialogHide:{yes|no|1|0|on|off} | 대화창을 인쇄나 인쇄미리보기에서 감출 것인가를 지정한다. 이는 대화창이 안전한 적용에만 해당된다. 디폴트는 no이다. |
| edge:{sunken|raised} | 대화창 모서리 스타일을 지정한다. 디폴트는 raised이다. |
| help:{yes|no|1|0|on|off } | 콘덱스트 메뉴에 도움말 아이톤을 디스플레이할 것인가를 지정한다. 디폴트는 yes이다. |
| resizable:{ yes|no|1|0|on|off } | 대화창의 크기가 조절되는가를 지정한다. 디폴트는 no이다. |
| scroll:{yes|no|1|0|on|off} | 대화창에서 스크롤되는가를 지정한다. 디폴트는 yes이다. |
| status:{yes|no|1|0|on|off} | 대화창에서 상태바가 디스플레이되는가를 지정한다. 안전하지 않은 대화창에서 디폴트는 yes이고, 안전한 대화창에서는 no이다. |
| unadorned:{yes|no|1|0|on|off} | 대화창에서 테두리 색상을 디스플레이할 것인가를 지정한다. 이는 대화창이 안전한 적용에만 해당된다. 디폴트는 no이다. |
반환값 vVal은 urlVal에 지정된 문서의 윈도우에 설정된 returnValue 속성값을 반환한다.
이 대화창은 열려있는 동안에 입력을 위한 초점을 받고, 사용자가 대화창을 닫을 때까지 윈도우로 돌아갈 수 없다.
대화창은 여러 도메인으로부터 주소의 자원을 포함할 수 있으므로, 보안을 요하는 정보를 vArguments 파라메터를 통하여 전달하지 말라. vArguments 파라메터는 window 개체의 dialogArguments 속성을 통하여 대화창 속에서 참조될수 있다. vArguments 파라메터가 문자열로 지정되었으면, 대화창에 전달되는 최대 문자열의 길이는 4096 글자이고, 그 이상은 잘려버린다.
IE4.0에서 대화창에서 스크롤바를 제거할 수 있다. 스크롤바가 나타나게하지 않으려면 대화창의 body 엘레멘트에서 scroll 애트리뷰트를 false로 설정하거나, 안전한 적용에서 대화창을 호출한다.
IE5에서는 showModalDialog 메서드의 sFeatures 파라메터에서 status, resizable의 값을 통하여 추가적인 제어가 가능하다.
Visual Basic, HTA(HTML Application), 혹은 안전한 대화창을 호출하여 상태바를 나타나지 않게하라. 이들은 브라우저 대신에 인터넷 익스플로러의 인터페이스를 사용하므로 안전한 것으로 인정된다. 안전한 적용에서 대화창은 디폴트로 상태바를 디스플레이하지 않는다.
디폴트로 대화창의 크기 조절이 안되게 되지만, showModalDialog 메서드의 sFeatures 문자열에 resizable=yes를 지정하여 조절이 가능하게 설정할 수 있다.
대화창에도 스타일쉬트(CSS:Cascading Style Sheets)에서와 마찬가지로 "font-size:4"와 같이 디폴트 글지 크기를 지정할 수 있다. 여러 글꼴을 위하여 여러 글꼴 애트리뷰트를 사용하면 된다.
dialogHeight와 dialogWidth의 디폴트 길이 단위는 IE4.0에서 픽셀(px)이고 IE5에서 em이다. 값은 정수값이나 부동소수점값이 될수 있고, 그 뒤에 길이 단위를 기술한다. 단위는 절대단위 cm, mm, in, pt, pc, or px등과 상대단위 em or ex등이 있다. 대화창의 안정적 디스플레이를 위하여 dialogHeight와 dialogWidth를 픽셀단위로 지정하라.
사용자가 대화창의 높이를 수동으로 조절할 수 있지만, 대화창이 가장 작게 표현되는 높이 dialogHeight는 100 픽셀이다.
center의 디폴트값이 yes이지만 center를 덮어씌우기 위하여, dialogLeft와/혹은 dialogTop를 지정할 수 있다.
| 개체 | script | IE |
|---|
showModalDialog 메서드로 지정한 대화창을 연다.
<SCRIPT>
function doGetRandom(iModifier){
return parseInt(Math.random()*iModifier);
}
function doSetVals(){
var iWidth=oForm.oWidth.options[oForm.oWidth.selectedIndex].text;
var iHeight=oForm.oHeight.options[oForm.oHeight.selectedIndex].text;
if (iWidth.indexOf('무작위')>-1){
iWidth=doGetRandom(document.body.clientWidth);
}
if (iHeight.indexOf('무작위')>-1){
iHeight=doGetRandom(document.body.clientHeight);
}
var sFeatures='dialogWidth=' + iWidth + 'px;'+'dialogHeight=' + iHeight + 'px;';
return sFeatures;
}
function doOpen(){
var sFeatures=doSetVals();
window.showModalDialog('../object/exp/wmodalDial.html','',sFeatures)
}
</SCRIPT>
<FORM NAME=oForm>
너비
<SELECT NAME="oWidth">
<OPTION>무작위
<OPTION>50
<OPTION>100
<OPTION>200
<OPTION>300
<OPTION>400
<OPTION>500
</SELECT>
높이
<SELECT NAME="oHeight">
<OPTION>무작위
<OPTION>50
<OPTION>100
<OPTION>200
<OPTION>300
<OPTION>400
<OPTION>500
</SELECT>
<INPUT type="button" value="대화창 열기" onclick="doOpen()">
</FORM>