Ben Nadel
On User Experience (UX) Design, JavaScript, ColdFusion, Node.js, Life, and Love.
I am the chief technical officer at InVision App, Inc - a prototyping and collaboration platform for designers, built by designers. I also rock out in JavaScript and ColdFusion 24x7.
Meanwhile on Twitter
Loading latest tweet...
Ben Nadel at cf.Objective() 2009 (Minneapolis, MN) with:

CF_XSLT ColdFusion Custom Tag For Xml Transformations

By Ben Nadel on
Tags: ColdFusion

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:

  • <!--- Kill extra output. --->
  • <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")>
  •  
  • <!--- Param Attributes. --->
  •  
  • <!---
  • 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"
  • />
  •  
  • <!--- Exit the start mode of the tag. --->
  • <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:

  • <!--- Build the XML document. --->
  • <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>
  •  
  •  
  • <!--- Transform the xml data. --->
  • <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">
  •  
  •  
  • <!--- Match primary navigation. --->
  • <xsl:template match="page/navigation">
  •  
  • <ul class="primarynav">
  • <xsl:apply-templates select="item" />
  • </ul>
  •  
  • </xsl:template>
  •  
  •  
  • <!--- Match primary navigation items. --->
  • <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.



Reader Comments

Post A Comment

You — Get Out Of My Dreams, Get Into My Comments
Live in the Now
Oops!
Comment Etiquette: Please do not post spam. Please keep the comments on-topic. Please do not post unrelated questions or large chunks of code. And, above all, please be nice to each other - we're trying to have a good conversation here.