Adobe Dreamweaver API Reference CS5 - Manual (Page 259)

254 DREAMWEAVER API REFERENCE
Document
Last updated 8/27/2013
dreamweaver.createXHTMLDocument()
Availability
Dreamweaver MX.
Description
Depending on the argument that you pass to this function, it opens a new XHTML document either in the same
window or in a new window. The new document becomes the active document. It is similar to the
dreamweaver.createDocument() function.
When Dreamweaver creates a new XHTML document, it reads a file named default.xhtml, which is located in the
Configuration/Templates folder, and, using the content of that file, creates an output file that contains the following
skeleton declarations:
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
Untitled Document
The default document type definition (DTD) declaration is XHTML 1.0 Transitional , rather than Strict . If the user
adds a frameset to the document, Dreamweaver switches the DTD to XHTML 1.0 Frameset . Content-Type is
text/html , and charset is intentionally left out of the default.xhtml file but is filled in before the user views the new
document. The ?xml directive is not required if the document uses UTF-8 or UTF-16 character encoding; if it is
present, it might be rendered by some older browsers. However, because this directive should be in an XHTML
document, by default, Dreamweaver uses it (for both new and converted documents). Users can manually delete the
directive. The
?xml directive includes the encoding attribute, which matches the charset in the Content-Type
attribute.
Arguments
{bOpenInSameWindow}
• The bOpenInSameWindow argument is a Boolean value that indicates whether to open the new document in the
current window. If this value is
false or omitted, or if the function is called on the Macintosh, the new document
opens in a separate window.
Returns
The document object for the newly created document, which is the same value that the
dreamweaver.getDocumentDOM() function returns.