User Guide

480 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
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 Default Description
tagname Required Ancestor tag name for which to return data
instancenumber Optional 1 (closest
ancestor)
Number of ancestor levels to jump before returning data