Adobe 38040334 - Dreamweaver CS3 User Manual page 254

• 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()
Arguments
NSorIE, sourceDoc, {tag1}, {tag2},...{tagN}
• The
argument must be either
NSorIE
Netscape Navigator 4.0 and Internet Explorer 4.0. This argument specifies for which browser to return a valid
reference.
• The
argument must be
sourceDoc
"parent.frames['frameName']"
contains the current selection. The
document is in a frame), and
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,
Returns
An array of strings where each array is a valid JavaScript reference to a named instance of the requested tag type in
the specified document (for example,
• Dreamweaver returns correct references for Internet Explorer for
, ,
SELECT OPTION TEXTAREA
• Dreamweaver returns correct references for Netscape Navigator for
, ,
SELECT OPTION TEXTAREA
tags that are not absolutely positioned, Dreamweaver returns
SPAN
• Dreamweaver does not return references for unnamed objects. If an object does not contain either a
attribute, Dreamweaver returns
ID
Dreamweaver references the object by index (for example,
• Dreamweaver does return references for named objects that are contained in unnamed forms and layers (for
example,
document.forms[2].myCheckbox
When the same list of arguments passes to
and with parallel content.
).
and then calling
dreamweaver.getElementRef()
or
"NS 4.0" "IE 4.0"
,
"document" "parent"
, or a URL. The
document
value specifies the parent frameset (if the currently selected
parent
parent.frames[number]
"document.myLayer.document.myImage"
, , and tags.
OBJECT IMG
, , and tags, and for absolutely positioned
OBJECT IMG
"unnamed <tag>"
).
getObjectTags()
for each tag in the
. The DOM and rules for nested references differ in
,
"parent.frames[number]"
value specifies the document that has the focus and
and
parent.frames['frameName']
) for the specified browser:
, ,
A AREA APPLET
, ,
A AREA APPLET
DIV
"cannot reference <tag>"
. If the browser does not support a reference by name,
document.myform.applets[3]
, the two functions return arrays of the same length
DREAMWEAVER CS3
API Reference
.
nodelist
,
specify a
, , or
"IMG" "FORM" "HR"
, , , ,
EMBED DIV SPAN, INPUT
, , , ,
EMBED LAYER ILAYER
and tags. For
SPAN DIV
.
or an
NAME
).
249
).
and