MACROMEDIA DREAMWEAVER MX 2004-DREAMWEAVER API, Reference

Page: 425 / 486

Tag editor and tag library functions 425
Tag editor and tag library functions
You can use tag editors to insert new tags, edit existing tags, and access reference information
about tags. The Tag Chooser lets users organize their tags so that they can easily select frequently
used tags. The tag libraries that come with Dreamweaver store information about tags that are
used in standards-based markup languages and most widely used tag-based scripting languages.
You can use the JavaScript tag editor, Tag Chooser, and tag library functions when you need to
access and work with tag editors and tag libraries in your extensions.
dom.getTagSelectorTag()
Availability
Dreamweaver MX.
Description
This function gets the DOM node for the tag that is currently selected in the Tag Selector bar at
the bottom of the document window.
Arguments
None.
Returns
The DOM node for the currently selected tag;
null
if no tag is selected.
dreamweaver.popupInsertTagDialog()
Availability
Dreamweaver MX.
Description
This function checks the VTM files to see if a tag editor has been defined for the tag. If so, the
editor for that tag pops up and accepts the start tag. If not, the start tag is inserted unmodified
into the user’s document.
Arguments
A start tag string that includes one of the following types of initial values:
•
A tag, such as
<input>
•
A tag with attributes, such as
<input type='text'>
•
A directive, such as
<%= %>
Returns
A Boolean value:
true
if anything is inserted into the document;
false
otherwise.
000_DW_API_Print.book Page 425 Wednesday, August 20, 2003 9:14 AM