User Guide

Global document functions 327
■ Dreamweaver returns correct references for Netscape Navigator for A, AREA, APPLET,
EMBED, LAYER, ILAYER, SELECT, OPTION, TEXTAREA, OBJECT, and IMG tags, and for
absolutely positioned
DIV and SPAN tags. For DIV and SPAN tags that are not absolutely
positioned, Dreamweaver returns
"cannot reference <tag>".
■ Dreamweaver does not return references for unnamed objects. If an object does not
contain either a
NAME or an ID attribute, Dreamweaver returns "unnamed <tag>". If the
browser does not support a reference by name, Dreamweaver references the object by
index (for example,
document.myform.applets[3]).
■ Dreamweaver returns references for named objects that are contained in unnamed forms
and layers (for example,
document.forms[2].myCheckbox).
dreamweaver.getObjectRefs() (deprecated)
Availability
Dreamweaver 1; deprecated in 3.
Description
This function scans the specified document for instances of the specified tags or, if no tags are
specified, for all tags in the document and formulates browser-specific references to those tags.
This function is equivalent to calling
getElementsByTagName() and then calling
dreamweaver.getElementRef() for each tag in the nodelist.
Arguments
NSorIE, sourceDoc, {tag1}, {tag2},...{tagN}
■ The NSorIE argument must be either "NS 4.0" or "IE 4.0". The DOM and rules for
nested references differ in Netscape Navigator 4.0 and Internet Explorer 4.0. This
argument specifies for which browser to return a valid reference.
■ The sourceDoc argument must be "document", "parent", "parent.frames[number]",
"parent.frames['frameName']", or a URL. The document value specifies the
document that has the focus and contains the current selection. The
parent value
specifies the parent frameset (if the currently selected document is in a frame), and
parent.frames[number] and parent.frames['frameName'] specify a document that
is in a particular frame within the frameset that contains the current document. If the
argument is a relative URL, it is relative to the extension file.
■ The third and subsequent arguments, if supplied, are the names of tags (for example,
"IMG", "FORM", or "HR").
000_DW_API_Print.book Page 327 Wednesday, July 20, 2005 11:58 AM