MACROMEDIA COLFUSION MX 7-CFML Reference page 306

Attribute
attributeCollection Optional
attribute_name
Usage
To name a ColdFusion page that contains the custom tag definition, including its path, use the
attribute. To refer to the custom tag in the ColdFusion installation directory, using dot
template
notation to indicate its location, use the
On UNIX systems, ColdFusion searches first for a file with a name that matches the
attribute, but is all lower case. If it does not find the file, it looks for a file name that matches the
attribute with identical character casing.
You can use
attributeCollection
Within the custom tag code, the attributes passed with
independent attribute values, with no indication that they are grouped into a structure by the
custom tag's caller.
Similarly, if the custom tag uses a
with
attributeCollection
they are grouped into a structure by the custom tag's caller.
If you specify an end tag to
and an end tag. For more information, see "Handling end tags" of Chapter 11, "Creating and
Using Custom CFML Tags" in ColdFusion MX Developer's Guide.
Example
<h3>cfmodule Example</h3>
<p>This view-only example shows use of cfmodule to call a custom tag inline.</
p>
<p>This example uses a sample custom tag that is saved in myTag.cfm in
the snippets directory. You can also save ColdFusion custom tags in the
CFusionMX7\CustomTags directory.
<cfset attrCollection1 = StructNew()>
<cfparam name="attrCollection1.value1" default="22">
<cfparam name="attrCollection1.value2" default="45">
<cfparam name="attrcollection1.value3" default="88">
<!--- Call the tag with CFMODULE with Name--->
<cfmodule
Template="myTag.cfm"
X="3"
attributeCollection=#attrCollection1#
Y="4">
<!--- Show the code. --->
<HR size="2" color="#0000A0">
<P>Here is one way in which to invoke the custom tag,
306 Chapter 2: ColdFusion Tags
Req/Opt Default Description
Optional
name
and
attribute_name
cfassociate
are saved as independent attribute values, with no indication that
, ColdFusion calls your custom tag as if it had both a start
cfmodule
Structure. A collection of key-value pairs that
represent attribute names and values. You can
specify multiple key-value pairs. You can specify this
attribute only once.
Attribute for a custom tag. You can include multiple
instances of this attribute to specify the parameters
of a custom tag.
attribute.
in the same call.
attributeCollection
tag to save its attributes, the attributes passed
name
are saved as