Opens a document for writing.
  |
Syntax
var retval = document.open(url, name, features, replace);Parameters
- url [in, optional]
-
Type: String
Specifies a MIME type for the document. - name [in, optional]
-
Type: String
Note The following applies only if this method is used instead of window.open.
String that specifies the name of the window. This name is used as the value for the TARGET attribute on a form or an anchor element.
_blank
-
The url is loaded into a new, unnamed window.
_parent
-
The url is loaded into the current frame's parent. If the frame has no parent, this value acts as the value _self.
_self
-
The current document is replaced with the specified url.
_top
-
The loaded url replaces any framesets that might be loaded. If there are no framesets defined, this value acts as the value _self.
- features [in, optional]
-
Type: String
Note The following applies only if this method is used instead of window.open.
String that contains a list of items separated by commas. Each item consists of an option and a value, separated by an equals sign (for example, "
fullscreen=yes,toolbar=yes"). The following values are supported.channelmode = { yes | no | 1 | 0 }
-
Specifies whether to display the window in theater mode. The default is no.
channelmode = { yes | 1 }overrides height, width, top, and left values. When active, the Navigation Bar is hidden and the Title Bar is visible. The Channel Band is no longer supported in a Windows Store app using JavaScript. fullscreen = { yes | no | 1 | 0 }
-
Specifies whether to display the browser in full-screen mode. The default is no. Use full-screen mode carefully. Because this mode hides the browser's title bar and menus, always provide a button or other visual clue to help the user close the window. ALT+F4 closes the new window.
height = number
-
Sets the height of the window in pixels. The minimum value is
150, and specifies the minimum height of the browser content area. left = number
-
Specifies the left position, in pixels. This value is relative to the upper-left corner of the screen. The value must be greater than or equal to 0.
location = { yes | no | 1 | 0 }
-
Specifies whether to display the Navigation Bar. The default is yes.
The Back, Forward, and Stop commands are now located in the Navigation Bar.
menubar = { yes | no | 1 | 0 }
-
Specifies whether to display the Menu Bar. The default is yes.
The combination of
menubar = { no | 0 }andtoolbar = { no | 0 }hides the toolbar and disables any additional third-party user interfaces. resizable = { yes | no | 1 | 0 }
-
Specifies whether to display resize handles at the corners of the window. The default is yes.
scrollbars = { yes | no | 1 | 0 }
-
Specifies whether to display horizontal and vertical scroll bars. The default is yes.
status = { yes | no | 1 | 0 }
-
Specifies whether to add a Status Bar at the bottom of the window. The default is yes.
toolbar = { yes | no | 1 | 0 }
-
The combination of
menubar = { no | 0 }andtoolbar = { no | 0 }turns off the toolbar and any additional third-party user interfaces. top = number
-
Specifies the top position, in pixels. This value is relative to the upper-left corner of the screen. The value must be greater than or equal to 0.
width = number
-
Sets the width of the window in pixels. The minimum value is
250, and specifies the minimum width of the browsers content area.
- replace [in, optional]
-
Type: Variant
Specifies whether the existing entry for the document is replaced in the history list.
Return value
Type: Object
Returns a reference to the new document object. Use this reference to access properties and methods of the document.Standards information
- Document Object Model (DOM) Level 2 HTML Specification, Section 1.5
- HTML5 A vocabulary and associated APIs for HTML and XHTML, Section 3.4.1
Examples
The following example shows how to use the open method to replace the current document with a new document and display the HTML markup contained in the variable sMarkup.
<html>
<head>
<title>First Document</title>
<script type="text/javascript">
function replace(){
var oNewDoc = document.open("text/html", "replace");
var sMarkup = "<html><head><title>New Document</title></head><body>Hello, world</body></html>";
oNewDoc.write(sMarkup);
oNewDoc.close();
}
</script>
</head>
<body>
<h1>I just want to say</h1><br>
<!--Button will call the replace function and replace the current page with a new one-->
<input type ="button" value = "Finish Sentence" onclick="replace();">
</body>
</html>
See also
Build date: 11/28/2012
