Cfassociate - MACROMEDIA COLDFUSION MX 61-CFML Reference

cfassociate

Description
Allows subtag data to be saved with a base tag. Applies only to custom tags.
Category
Application framework tags
Syntax
<cfassociate
baseTag = "base_tag_name"
dataCollection = "collection_name">
See also
cfapplication, cferror, cflock,
Attributes
Attribute
baseTag
dataCollection
Usage
Call this tag within a subtag, to save subtag data in the base tag.
When ColdFusion passes subtag attributes back to the base tag, it saves them in a structure whose
default name is
AssocAttribs
multiple subtags), specify a structure name, in the
appended to an array whose name is thistag.collectionName.
Within the custom tag code, the attributes passed to the tag by using the
attribute are saved as independent values, with no indication that they are grouped into a
structure by the custom tag's caller. Therefore, in the called tag, if you assign a value to a specific
attribute, it replaces the value passed in the
calling the subtag.
Example
<!--- Find the context --->
<cfif thisTag.executionMode is "start">
<!--- Associate attributes --->
<cfassociate baseTag = "CF_TAGBASE">
<!--- Define defaults for attributes --->
<cfparam name = "attributes.happy" default = "Yes">
<cfparam name = "attributes.sad" default = "No">
...
56 Chapter 2: ColdFusion Tags
cfmodule
Req/Opt Default
Required
Optional AssocAttribs
. To segregate subtag attributes (in a base tag that can have
Description
Base tag name
Structure in which base tag stores subtag data
dataCollection
attributeCollection
attribute. The structure is
attributeCollection
attribute that you used when