MACROMEDIA COLFUSION MX 7-CFML, Reference

Page: 596 / 1108

596 Chapter 3: ColdFusion Functions
GetBaseTagData
Description
Used within a custom tag. Finds calling (ancestor) tag by name and accesses its data.
Returns
An object that contains data (variables, scopes, and so on) from an ancestor tag. If there is no
ancestor by the specified name, or if the ancestor does not expose data (for example,
cfif
), an
exception is thrown.
Category
Other functions
Function syntax
GetBaseTagData ( tagname [, instancenumber ] )
See also
GetBaseTagList
; “High-level data exchange” in Chapter 11, “Creating and Using Custom
CFML Tags,” in ColdFusion MX Developer’s Guide
Parameters
Example
<!--- This example shows the use of GetBaseTagData
function. Typically used in custom tags.--->
...
<cfif trim(inCustomTag) neq "">
<cfoutput>
Running in the context of a custom
tag named #inCustomTag#.<p>
</cfoutput>
<!--- Get the tag instance data --->
<cfset tagData = GetBaseTagData(inCustomTag)>
<!--- Find the tag's execution mode --->
Located inside the
<cfif tagData.thisTag.executionMode neq ’inactive’>
template
<cfelse>
BODY
</cfif>
Parameter Req/Opt Description
tagname Required Ancestor tag name for which to return data
instancenumber Optional Number of ancestor levels to jump before returning data. The default
value is 1 (closest ancestor).