User Guide

Global document functions 271
Example
The following example calls dw.doURLDecoding() to decode the special characters in its
argument and store the resulting string in
outstr:
outStr = dreamweaver.doURLDecoding(“http://maps.yahoo.com/py/
ddResults.py?Pyt=Tmap&tarname=&tardesc=&newname=&newdesc=&newHash=&newTHash
=&newSts=&newTSts=&tlt=&tln=&slt=&sln=&newFL=Use+Address+Below&newaddr=2000
+Shamrock+Rd&newcsz=Metroo+Park%2C+CA&newcountry=us&newTFL=Use+Address+Belo
w&newtaddr=500+El+Camino&newtcsz=Santa+Clara%2C+CA&newtcountry=us&Submit=Ge
t+Directions”)
dreamweaver.getElementRef()
Availability
Dreamweaver 2.
Description
Gets the Netscape Navigator or Internet Explorer object reference for a specific tag object in the
DOM tree.
Arguments
NSorIE
, tagObject
• 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 tagObject argument is a tag object in the DOM tree.
Returns
A string that represents a valid JavaScript reference to the object, such as
document.layers['myLayer']. The string is subject to the following conditions:
• Dreamweaver returns correct references for Internet Explorer for A, AREA, APPLET, EMBED, DIV,
SPAN, INPUT, SELECT, OPTION, TEXTAREA, OBJECT, and IMG tags.
• 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).
000_DW_API_Print.book Page 271 Wednesday, August 20, 2003 9:14 AM