User Guide

ManualsBrandsMacromedia ManualsOtherDREAMWEAVER 8-DREAMWEAVER API REFERENCE

301

302

303

304

305

306

307

308

309

310

308 Document

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:

<?xml version="1.0">

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"

"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<head>

<title>Untitled Document</title>

</head>

</body>

</html>

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.

000_DW_API_Print.book Page 308 Wednesday, July 20, 2005 11:58 AM