CF_XSLT ColdFusion Custom Tag For Xml Transformations : Kinky Solutions : A Student's Perspective by Ben Nadel

CF_XSLT ColdFusion Custom Tag For Xml Transformations

Posted December 4, 2007 at 7:52 AM

I was doing a bunch of stuff with XML and XSL Transformations in ColdFusion the other day and I got really tired of the fact that I had to create an intermediary XSLT variable before I could call the XmlTransform() method. To deal with this, I whipped up a quick little ColdFusion custom tag, xslt.cfm. This tag simply takes, as an attribute, an XML document (or string), and applies the XSL transformation defined within the tag contents to the given XML document. Here's how it works inside:

Launch code in new window » Download code as text file »

<cfsilent>
<!---
Check to see which mode of the tag we are executing.
In the Start mode, we want to get the attributes. In
the End mode, once we have the XSL transformation,
we want to perform the transformation.
--->
<cfif (THISTAG.ExecutionMode EQ "Start")>
<!---
This is the XML document that we are going to
transform. It can be either an XML document object
or an XML string.
--->
<cfparam
name="ATTRIBUTES.XML"
type="any"
/>
<cfexit method="exittemplate" />
<cfelse>
<!---
Reset the generated output to be the result of
the XML transformation.
--->
<cfset THISTAG.GeneratedContent = XmlTransform(
Trim( ATTRIBUTES.XML ),
Trim( THISTAG.GeneratedContent )
) />
</cfif>
</cfsilent>

Notice that in the Start execution mode of the tag, all we do is define the XML attribute. Then, in the End execution mode of the tag we simply replace the generated content with the result of the XmlTranform() method using the passed in the XML document and the existing generated content value.

To use the tag, you could do something like this:

Launch code in new window » Download code as text file »

<cfxml variable="xmlData">
<page>
<navigation>
<item on="yes">
<text>Home</text>
<href>home.cfm</href>
</item>
<item>
<text>About</text>
<href>about.cfm</href>
</item>
<item>
<text>Contact Us</text>
<href>contact.cfm</href>
</item>
</navigation>
</page>
</cfxml>
<cf_xslt xml="#xmlData#">
<?xml version="1.0" encoding="ISO-8859-1"?>
<xsl:transform
version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:template match="page/navigation">
<ul class="primarynav">
<xsl:apply-templates select="item" />
</ul>
</xsl:template>
<xsl:template match="item">
<li>
<xsl:if test="@on = 'yes'">
<xsl:attribute name="class">
<xsl:text>on</xsl:text>
</xsl:attribute>
</xsl:if>
<a>
<xsl:attribute name="href">
<xsl:value-of select="href" />
</xsl:attribute>
<xsl:value-of select="text" />
</a>
</li>
</xsl:template>
</xsl:transform>
</cf_xslt>

Here I am modelling the navigation of an HTML page and then using the CF_XSLT ColdFusion custom tag to render it in place. This might seem like a really small piece of functionality, but it ended up making my life easier.

CF_XSLT ColdFusion Custom Tag For Xml Transformations : Kinky Solutions : A Student's Perspective by Ben Nadel

CF_XSLT ColdFusion Custom Tag For Xml Transformations

Posted December 4, 2007 at 7:52 AM

Reader Comments