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:key> — Defines an index against the current document. The element is defined with three attributes: a name, which names this index; a match, an XPath expression that describes the nodes to be indexed; and a use attribute, an XPath expression that defines the property used to create the index.

Required Attributes

name: Defines a name for this key.
match: Represents an XPath expression that defines the nodes to be indexed by this key.
use: Represents an XPath expression that defines the property of the indexed nodes that will be used to retrieve nodes from the index.

Optional Attributes

None.

Content

None. <xsl:key> is an empty element.

Appears in

<xsl:key> is a top-level element and can only appear as a child of <xsl:stylesheet>.

Defined in

XSLT section 12.2, Keys.

Example

Here is a stylesheet that defines two <xsl:key> relations against an XML document:

<?xml version="1.0"?> <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"> <xsl:output method="html" indent="yes"/> <xsl:strip-space elements="*"/> <xsl:key name="language-index" match="defn" use="@language"/> <xsl:key name="term-ids" match="term" use="@id"/> <xsl:param name="targetLanguage"/> <xsl:template match="/"> <xsl:apply-templates select="glossary"/> </xsl:template> <xsl:template match="glossary"> <html> <head> <title> <xsl:text>Glossary Listing: </xsl:text> <xsl:value-of select="key('language-index', $targetLanguage)[1]/preceding-sibling::term"/> <xsl:text> - </xsl:text> <xsl:value-of ...