MACROMEDIA ColdFusion Server 5, Руководство пользователя

Страница: 124 / 328

106 Chapter 7 Using Web Development Languages
Working with Tag Definitions
Tag definitions are the source of information for Tag Editors, Tag Insight, and Tag
Inspector in ColdFusion Studio. These are the namespaces for which tag definitions
are installed: XHTML, HTML, CFML, VTML, JSP, Java, JRUN, WML, HDML, SMIL,
IMFL, RTML, and Custom.
About namespace precedence
A version of a markup language (or namespace ) can have a tag with the same name
as a tag in another namespace. For example, both the JRun and Java namespaces
contain a
servlet tag. To avoid conflicts, the tag definitions for different
namespaces are installed in different directories, in the \Extensions\TagDefs
directory under the application root directory.
When you use a Tag Editor or Tag Inspector, or Tag Insight is enabled, ColdFusion
Studio needs to know which tag definition to use. The list in the
Options > Settings >
Tag Definitions Library pane represents the order in which ColdFusion Studio
searches the directories when looking for a tag definition.
For example, if you type
<region>
in a document, right-click it and choose Edit Tag,
the SMIL Tag Editor appears, because no other directory contains a <region> tag. On
the other hand, if you edit a
<servlet>
tag, either the Java or JRun version of the Tag
Editor could appear. If JRun is higher on the namespace list than Java, then the
program uses the JRun version of the servlet tag definition, without continuing its
search to discover the Java version.
There are two ways to manually override these defaults while working in the editor:
•
Type the namespace and a colon (:) in the tag before the tag name; for example,
type
<java:servlet> .
•
Use the Tag Chooser to insert the tag from whatever directory you want.
For more information, see
“Selecting tags from the Tag Chooser” on page 55 .
Setting namespace precedence
This section explains how to set the order in which the program searches namespace
directories for a tag definition. For more information, see
“About namespace
precedence” on page 106 .
To set the priority of namespaces:
1 In the Options > Settings > Tag Definitions Library pane, click the Up and Down
buttons as necessary to set the list in the appropriate order.
The namespace on top receives the highest priority.
2 If you do not want to search a namespace at all, clear the Enabled option for it.