book

XSLT

by Doug Tidwell

August 2001

Intermediate to advanced

480 pages

11h 16m

English

O'Reilly Media, Inc.

Read now

Unlock full access

Organization of This Book
I Believe in Open, Platform-Neutral, Standards-Based ComputingI Assume You’re BusyI Don’t Care Which Standards-Compliant Tools You UseXSLT Is a Tool, Not a Religion
The Design of XSLT
XML’s HeritageXML Document RulesAn XML document must be contained in a single elementAll elements must be nestedAll attributes must be quotedXML tags are case-sensitiveAll end tags are requiredEmpty tags can contain the end markerXML declarationsDocument Type Definitions (DTDs) and XML SchemasWell-formed versus valid documentsTags versus elementsNamespacesDOM and SAXDOMA sample DOM treeSAXXML StandardsXML 1.0The Extensible Stylesheet Language (XSL)XML SchemasThe Simple API for XML (SAX)Document Object Model (DOM) Level 1Document Object Model (DOM) Level 2Namespaces in XMLAssociating stylesheets with XML documentsScalable Vector Graphics (SVG)Canonical XML Version 1.0XML digital signaturesXML Pointer Language (XPointer) Version 1.0XML Linking Language (XLink) Version 1.0

Goals of This Chapter
Our Sample DocumentA Sample StylesheetTransforming the XML DocumentStylesheet Results
Parsing the StylesheetParsing the TransformeeLather, Rinse, RepeatWalking Through Our Example
The <xsl:stylesheet> ElementThe <xsl:output> ElementOur First <xsl:template>The <xsl:template> for <greeting> ElementsBuilt-in Template RulesBuilt-in template rule for element and root nodesBuilt-in template rule for modesBuilt-in template rule for text and attribute nodesBuilt-in template rule for comment and processing instruction nodesBuilt-in template rule for namespace nodesTop-Level ElementsOther Approaches
The Hello World SVG FileThe Hello World PDF FileThe Hello World Java ProgramThe Hello World VRML File
The XPath Data ModelThe Root NodeElement NodesAttribute NodesText NodesComment NodesProcessing Instruction NodesNamespace Nodes
The ContextSimple Location PathsRelative and Absolute ExpressionsSelecting Things Besides Elements with Location PathsSelecting attributesSelecting the text of an elementSelecting comments, processing instructions, and namespace nodesUsing WildcardsAxesUnabbreviated syntaxAxis roll callPredicatesNumbers in predicatesFunctions in predicates
Output ViewThe Stylesheet
Goals of This Chapter
The <xsl:if> ElementConverting to boolean valuesBoolean examplesThe <xsl:choose> Element<xsl:choose> exampleThe <xsl:for-each> Element<xsl:for-each> example
How It WorksTemplates à la Mode
Defining a Parameter in a TemplatePassing ParametersGlobal ParametersXalanXTMicrosoft’s XSLT toolsSaxonOracleSetting global parameters in a Java program
Are These Things Really Variables?Variable Scope
Implementing a String Replace FunctionProcedural designRecursive design
Template DesignImplementationThe Complete Example
XML InputTemplate DesignComplications
Generating Links with the id() FunctionThe ID, IDREF, and IDREFs DatatypesAn XML Document in Need of LinksA Stylesheet That Uses the id() FunctionLimitations of IDs
Defining a key()A Slightly More Complicated XML Document in Need of LinksStylesheets That Use the key() FunctionThe key() function and the IDREFS datatypeSolution #1: Replace the IDREFS datatypeSolution #2: Use the XPath contains() functionSolution #3: Use recursion to process the IDREFS datatypeSolution #4: Use an extension functionAdvantages of the key() Function
An Unstructured XML Document in Need of LinksThe generate-id() Function
Sorting Data with <xsl:sort>Our First ExampleThe Details on the <xsl:sort> ElementWhat’s the deal with that syntax?AttributesWhere can you use <xsl:sort>?Another Example
Our First AttemptA Brute-Force ApproachGrouping with <xsl:variable>The <xsl:key> Approach
Overview
An Aside: Doing Math with RecursionRecursive designGenerating output to initialize a variableUsing format-number() to control output
The document() Function and SortingImplementing Lookup TablesGrouping Across Multiple Documents
Extension Elements, Extension Functions, and Fallback ProcessingExtension ElementsExample: Generating multiple output filesExample: Using extension functions from multiple processorsExtension FunctionsExample: A library of trigonometric functionsExample: Writing extensions in other languagesFallback Processing
Generating JPEG Files from XML ContentAccessing a Database with an Extension Element
About the Toot-O-Matic
Make It Easier to Create TutorialsShow Our Audience That We Use the Technologies We AdvocateSee Just How Much We Could Accomplish Through Stylesheets
Menu PanelIndividual PanelsSection MenuFeedback PanelEmail PanelZip FilePDF Files
Individual Panels
Stylesheets and ModesInitializing Global VariablesGenerating the Main Menu PanelGenerating the Section IndexesGenerating the Individual PanelsGenerating the PDF FilesGenerating the JPEG FilesGenerating the Zip File
XPath Node TypesThe Root NodeElement NodesAttribute NodesText NodesComment NodesProcessing-Instruction NodesNamespace Nodes
Mathematical OperatorsBoolean OperatorsComparing values of various datatypesExpression Operators
How Do I Put Quotes Inside an Attribute Value?

Content preview from XSLT

Name

<xsl:message> — Sends a message. How the message is sent can vary from one XSLT processor to the next, but it’s typically written to the standard output device. This element is useful for debugging stylesheets.

Required Attributes

None.

Optional Attributes

terminate="yes"|"no”: If this attribute has the value yes, the XSLT processor stops execution after issuing this message. The default value for this attribute is no; if the <xsl:message> doesn’t terminate the processor, the message is sent and processing continues.

Content

An XSLT template.

Appears in

<xsl:message> appears inside a template.

Defined in

XSLT section 13, Messages.

Example

Here’s a stylesheet that uses the <xsl:message> element to trace the transformation of an XML document. We’ll use our list of recently purchased albums again:

<?xml version="1.0"?>
<list xml:lang="en">
  <title>Albums I've bought recently:</title>
  <listitem>The Sacred Art of Dub</listitem>
  <listitem>Only the Poor Man Feel It</listitem>
  <listitem>Excitable Boy</listitem>
  <listitem xml:lang="sw">Aki Special</listitem>
  <listitem xml:lang="en-gb">Combat Rock</listitem>
  <listitem xml:lang="zu">Talking Timbuktu</listitem>
  <listitem xml:lang="jz">The Birth of the Cool</listitem>
</list>

We’ll list all of the purchased albums in an HTML table, with the background color of each row alternating through various colors. Our stylesheet uses an <xsl:choose> element inside an <xsl:attribute> element to determine the value of the bgcolor attribute. If ...