MACROMEDIA COLDFUSION 4.5-CFML LANGUAGE, Reference

Page: 164 / 608

140 CFML Language Reference
CFMODULE
Use CFMODULE to invoke a custom tag for use in your ColdFusion application pages.
CFMODULE can help deal with any custom tag name conflicts that might arise.
Use the TEMPLATE attribute to name a ColdFusion page containing the custom tag
definition, including its path. Use the NAME attribute to refer to the custom tag using a
dot notation scheme indicating the location of the custom tag in the ColdFusion
installation directory.
Syntax
<CFMODULE TEMPLATE="template"
NAME="tag_name"
ATTRIBUTECOLLECTION="collection_structure"
ATTRIBUTE_NAME1 ="value"
ATTRIBUTE_NAME2 ="value"
...>
TEMPLATE
Used in place of NAME, defines a path to the application page (.cfm file)
implementing the tag. Relative paths are expanded from the current page.
Physical paths are not allowed. Absolute paths are expanded using the ColdFusion
mappings.
NAME
Used in place of TEMPLATE, defines the name of the custom tag in the form
"Name.Name.Name... " that uniquely identifies a subdirectory containing the
custom tag page under the root directory for CF custom tags. For example:
<CFMODULE NAME="Allaire.Forums40.GetUserOptions">
Identifies the page
GetUserOptions.cfm
in the directory
CustomTags\Allaire\Forums40
under the root directory of the ColdFusion
installation.
ATTRIBUTECOLLECTION
Optional. A structure that contains a collection of key-value pairs that represent
attribute names and their values. You can specify as many key-value pairs as
needed. However, you can specify the ATTRIBUTECOLLECTION attribute only
once. See Usage for more information.
ATTRIBUTE_NAME
Optional. Attributes you want your custom tag to use. You can use as many
attributes as needed to specify the parameters of a custom tag. Each
Usage
You can use ATTRIBUTECOLLECTION and ATTRIBUTE in the same call.
Within the custom tag code, the attributes passed with ATTRIBUTECOLLECTION are
saved as independent attribute values with no indication that the attributes were
grouped into a structure by the custom tag’s caller.