User Guide
256 Chapter 14: Document
• The type argument specifies the type of document to create, as declared in the Dreamweaver
Configuration/DocumentTypes/MMDocumentTypes.xml file as the
id attribute of the
documenttype tag. For example, the type argument could be "HTML", "ASP-JS", "ASP-
VB", "ColdFusion", "CFC", "JSP", "ASP.NET_VB"
, and so on. For a complete list of
possible types, see the MMDocumentTypes.xml file. If you do not specify
type, the value
defaults to
"HTML".
Note: You can extend the MMDocumentTypes file by adding your own document types. For
information on extending document types, see Extending Dreamweaver.
Returns
The document object for the newly created document. This is the same value that the
dreamweaver.getDocumentDOM()function returns.
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">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Untitled Document</title>
<meta http-equiv="Content-Type" content="text/html; charset=" />
</head>
<body bgcolor="#FFFFFF" text="#000000">
</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.
000_DW_API_Print.book Page 256 Wednesday, August 20, 2003 9:14 AM