Specifications
655
• 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 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
getObjectTags(), the two functions return arrays of
the same length and with parallel content.
dreamweaver.getObjectTags()
Availability
Dreamweaver1, deprecated in 3
Description
Scans the specified document for instances of the specified tags or, if no tags are specified, for all
tags in the document. This function is equivalent to calling
getElementsByTagName() and then
getting
outerHTML for each element in the nodelist.
Arguments
sourceDoc, {tag1}, {tag2},...{tagN}
• sourceDoc must be "document", "parent", "parent.frames[number]",
"parent.frames[’frameName’]", or a URL. document specifies the document that has the
focus and contains the current selection. parent 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 second and subsequent arguments, if supplied, are the names of tags (for example, "IMG",
"FORM", "HR").
Returns
An array of strings where each array is the source code for an instance of the requested tag type in
the specified document.
• If one of the tag arguments is LAYER, the function returns all LAYER and ILAYER tags and all
absolutely positioned
DIV and SPAN tags.
• If one of the tag arguments is INPUT, the function returns all form elements. To get a particular
type of form element, specify
INPUT/TYPE, where TYPE is button, text, radio, checkbox,
password, textarea, select, hidden, reset, or submit.
When the same list of arguments passes to
getObjectRefs(), the two functions return arrays of
the same length.