Which Document Dom; The Dreamweaver Dom - MACROMEDIA DREAMWEAVER 8-EXTENDING DREAMWEAVER Manual

Which document DOM?

It is important to distinguish between the DOM of the user's document and the DOM of the
extension. The information in this chapter applies to both types of Dreamweaver documents,
but the way that you reference each DOM is different.
If you are familiar with JavaScript in browsers, you can reference objects in the active
document by writing . (for example, ), the same way that you
document document.forms[0]
reference objects in extension files. To reference objects in the user's document, however, you
must call , , or another function that returns a
dw.getDocumentDOM() dw.createDocument()
user document object.
For example, to refer to the first image in the active document, you can write
. You can also store the document object in a variable and
dw.getDocumentDOM().images[0]
use that variable in future references, as shown in the following example:
var dom = dw.getDocumentDOM(); //get the dom of the current document
var firstImg = dom.images[0];
firstImg.src = "myImages.gif";
This kind of notation is common in files throughout the Configuration folder, especially in
command files. For more information about the method, see the
dw.getDocumentDOM()
function in the Dreamweaver API Reference.
dreamweaver.getDocumentDOM()

The Dreamweaver DOM

The Dreamweaver DOM contains a subset of objects, properties, and methods from the
World Wide Web Consortium (W3C) (www.w3.org/TR/REC-DOM-Level-1/) DOM Level
1, which are combined with some properties of the Microsoft Internet Explorer 4.0 DOM.
128 The Dreamweaver Document Object Model