지정 윈도우에 문서(document)에 내용을 출력한다.

인수/파라메터

document : (문서 개체)

필수적인 요소이며, 현재의 문서를 나타내는 document 개체이다.

write : (출력 메서드)

필수적인 요소이며, 현재 문서에 인수로 지정한 내용을 출력한다.

writeln 메서드는 line 출력을 위하여 만든것이나 차잇점이 거의 없어 상호 호환하여 사용할 수 있다.

여기서 write로 표시된 것은 writeln에도 동일하게 적용된다.

파라메터 sVal, sVal1, sVal2 : (출력할 내용)

필수적인 요소이며, 출력할 문자열과 HTML 태그를 나탸내는 문자열이나 개체이다. 여러개의 파라메터를 포함 할 수 있다.

반환값

반환값은 없다.

설명

write 메서드는 '문서에 문자나, 숫자, 문자열, 문자열 개체, 개체의 속성, HTML 태그, Javascript 코드, 등 문자열화되는 모든 내용을 지정한 문서나 새로운 윈도우 등에 출력하는데 사용된다.

제공된 여러 인수을 연속적으로 제공된 순서에따라 지정된 개체에 출력한다.

Javascript 코드는 출력되기 전에 해당 기능들에 의하여 먼저 처리되고 그 결과를 출력한다. 따라서 문자열이 아닌 것은 인수로 제공하기 전에 문자열화 시켜야 오류가 발생되지 않는다.

특기

일반적으로 document.write() 메서드는 문서 개체가 없으면 자동적으로 화일을 만들어 문서를 출력하고 사용을 완료하면 내용을 지워버리므로 , document.open(), document.close() 메서드로 별도로 문서을 열고 닫을 필요은 없다. 이것이 document.open() 메서드가 비교적 생소한 이유이다. 그러나 일부 브라우저에서는 버퍼링 문제로 완전히 지워지지 않아 출력에 오류가 있을 수 있으므로 사용을 완료하고 document.close() 해 주는 것이 안전하다.

일단 문서가 로딩된 후에는, open 메서드가 처음으로 호출되지 않은 한, 이 경우 현재 문서의 윈도우와 모든 변수들을 지우게 되므로, 현재의 문서에 write나 writeln 메서드를 사용하지 말아야 한다.

주의 : document.write나 document.writeln이 이벤트처리자 속에서 사용되면, document.close도 사용되어야 한다.

writeln() 메서드는 write() 메서드와 거의 동일하지만 모든 문자열에 줄 바꿈 문자를 추가한다는 점이 write() 메서드와 다르다. HTML에서는 일반적으로 항목 뒤에 공백이 생길 뿐이지만 <PRE>, <XMP> 태그, <TEXTAREA>의 입력 문자열등을 사용하는 경우에는 줄 바꿈 문자를 그대로 해석하여 브라우저에 표시한다.

이점을 간안한다면 write() 메서드는 writeln() 메서드와 거의 같아 상호 호완적으로 사용될 수 있다.

주의

document.write() 메서드가 처리할 수 있는 문자열에는 일부 제한이 있다.

• 코드 작성시 문자열 중간에 줄바꿈을 하면 오류가 난다.
  문자열이 길어 보기 어려우면 문자열을 분할하여 줄바꿈하며 결합하거나 여러 인수로 분할하면 된다. 'stirng1'+'string2' 식이나 'stirng1','string2' 식으로 문자열을 분할하고, + 혹은 , 앞이나 뒤에서 줄바꿈 하라.
• 특수문자는 특수문자 표기법을 사용하여야 한다. 'string1\n\[string2\]\t \"string3\"'
• 이주따옴표("), 단일따옴표(')는 올바르게 네스팅되고 짝이 맞아야 된다. 'string1 "string2" string3'

적용

개체	script	IE

참조

writeln open

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

<SCRIPT>
br='<BR>';
string='문자열 2 출력';
document.write('문자열 1 출력',br,string,br);
document.write('Date()='+Date()+br);
document.writeln('document.location=\"'+document.location+'\"'+br);
document.write('====================='+
  '-------------- 아주 긴 문자열',
  ' 출력의 경우 ---------'+br);

str='=====================';
str=str+'-------------- 아주 긴 문자열';
str+=' 출력의 경우 ---------';
document.writeln(str);
</SCRIPT>