XPATHM

XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

What is XPath?
XPath is a major element in the XSLT standard.

XPath can be used to navigate through elements and attributes in an XML

document.

 XPath stands for XML Path Language

 XPath uses "path like" syntax to identify and navigate nodes in an
 XPath contains over 200 built-in functions
 XPath is a major element in the XSLT standard
 XPath is a W3C recommendation

XPath Path Expressions

XPath uses path expressions to select nodes or node-sets in an XML document.

These path expressions look very much like the path expressions you use with
traditional computer file systems:
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

XPath Standard Functions

XPath includes over 200 built-in functions.

There are functions for string values, numeric values, booleans, date and time
comparison, node manipulation, sequence manipulation, and much more.

Today XPath expressions can also be used in JavaScript, Java, XML Schema,
PHP, Python, C and C++, and lots of other languages.

XPath is Used in XSLT

XPath is a major element in the XSLT standard.

With XPath knowledge you will be able to take great advantage of your XSLT
knowledge.

XPath is a W3C Recommendation

XPath 1.0 became a W3C Recommendation on November 16, 1999.

XPath 2.0 became a W3C Recommendation on January 23, 2007.

XPath 3.0 became a W3C Recommendation on April 8, 2014.

XPath Terminology
Nodes
In XPath, there are seven kinds of nodes: element, attribute, text, namespace,
processing-instruction, comment, and document nodes.
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

XML documents are treated as trees of nodes. The topmost element of the tree
is called the root element.

Look at the following XML document:

<?xml version="1.0" encoding="UTF-8"?>

<bookstore>
<book>
<title lang="en">Harry Potter</title>
<author>J K. Rowling</author>
<year>2005</year>
<price>29.99</price>
</book>
</bookstore>

Example of nodes in the XML document above:

<bookstore> (root element node)

<author>J K. Rowling</author> (element node)

lang="en" (attribute node)

Atomic values
Atomic values are nodes with no children or parent.

Example of atomic values:

J K. Rowling

"en"

Items
Items are atomic values or nodes.

Relationship of Nodes
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

Parent
Each element and attribute has one parent.

In the following example; the book element is the parent of the title, author,
year, and price:

<book>
<title>Harry Potter</title>
<author>J K. Rowling</author>
<year>2005</year>
<price>29.99</price>
</book>

Children
Element nodes may have zero, one or more children.

In the following example; the title, author, year, and price elements are all
children of the book element:

<book>
<title>Harry Potter</title>
<author>J K. Rowling</author>
<year>2005</year>
<price>29.99</price>
</book>

Siblings
Nodes that have the same parent.

In the following example; the title, author, year, and price elements are all
siblings:

<book>
<title>Harry Potter</title>
<author>J K. Rowling</author>
<year>2005</year>
<price>29.99</price>
</book>
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

Ancestors
A node's parent, parent's parent, etc.

In the following example; the ancestors of the title element are the book
element and the bookstore element:

<bookstore>

<book>
<title>Harry Potter</title>
<author>J K. Rowling</author>
<year>2005</year>
<price>29.99</price>
</book>

</bookstore>

Descendants
A node's children, children's children, etc.

In the following example; descendants of the bookstore element are the book,
title, author, year, and price elements:

<bookstore>

<book>
<title>Harry Potter</title>
<author>J K. Rowling</author>
<year>2005</year>
<price>29.99</price>
</book>

</bookstore>

XPath uses path expressions to select nodes or node-sets in an XML

document. The node is selected by following a path or steps.
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

The XML Example Document

We will use the following XML document in the examples below.

<?xml version="1.0" encoding="UTF-8"?>

<bookstore>

<book>
<title lang="en">Harry Potter</title>
<price>29.99</price>
</book>

<book>
<title lang="en">Learning XML</title>
<price>39.95</price>
</book>

</bookstore>

Selecting Nodes
XPath uses path expressions to select nodes in an XML document. The node is
selected by following a path or steps. The most useful path expressions are
listed below:

Expression Description

nodename Selects all nodes with the name "nodename"

/ Selects from the root node

 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

// Selects nodes in the document from the current node that

match the selection no matter where they are

. Selects the current node

.. Selects the parent of the current node

@ Selects attributes

In the table below we have listed some path expressions and the result of the
expressions:

Path Expression Result

bookstore Selects all nodes with the name "bookstore"

/bookstore Selects the root element bookstore

Note: If the path starts with a slash ( / ) it always represents

an absolute path to an element!

bookstore/book Selects all book elements that are children of bookstore

 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

//book Selects all book elements no matter where they are in the
document

bookstore//book Selects all book elements that are descendant of the bookstore
element, no matter where they are under the bookstore
element

//@lang Selects all attributes that are named lang

Predicates
Predicates are used to find a specific node or a node that contains a specific
value.

Predicates are always embedded in square brackets.

In the table below we have listed some path expressions with predicates and
the result of the expressions:

Path Expression Result

/bookstore/book[1] Selects the first book element that is the child

of the bookstore element.

Note: In IE 5,6,7,8,9 first node is[0], but

according to W3C, it is [1]. To solve this
problem in IE, set the SelectionLanguage to
XPath:

In JavaScript:
xml.setProperty("SelectionLanguage","XPath");
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

/bookstore/book[last()] Selects the last book element that is the child

of the bookstore element

/bookstore/book[last()-1] Selects the last but one book element that is

the child of the bookstore element

/bookstore/book[position()<3] Selects the first two book elements that are

children of the bookstore element

//title[@lang] Selects all the title elements that have an

attribute named lang

//title[@lang='en'] Selects all the title elements that have a "lang"

attribute with a value of "en"

/bookstore/book[price>35.00] Selects all the book elements of the bookstore

element that have a price element with a value
greater than 35.00

/bookstore/book[price>35.00]/title Selects all the title elements of the book

elements of the bookstore element that have a
price element with a value greater than 35.00

Selecting Unknown Nodes

XPath wildcards can be used to select unknown XML nodes.

Wildcard Description
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

* Matches any element node

@* Matches any attribute node

node() Matches any node of any kind

In the table below we have listed some path expressions and the result of the
expressions:

Path Expression Result

/bookstore/* Selects all the child element nodes of the bookstore element

//* Selects all elements in the document

//title[@*] Selects all title elements which have at least one attribute of
any kind

Selecting Several Paths

By using the | operator in an XPath expression you can select several paths.
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

In the table below we have listed some path expressions and the result of the
expressions:

Path Expression Result

//book/title | //book/price Selects all the title AND price elements of all book
elements

//title | //price Selects all the title AND price elements in the
document

/bookstore/book/title | //price Selects all the title elements of the book element of
the bookstore element AND all the price elements
in the document

The XML Example Document

We will use the following XML document in the examples below.

<?xml version="1.0" encoding="UTF-8"?>

<bookstore>

<book>
<title lang="en">Harry Potter</title>
<price>29.99</price>
</book>

<book>
<title lang="en">Learning XML</title>
<price>39.95</price>
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

</book>

</bookstore>

XPath Axes
An axis defines a node-set relative to the current node.

AxisName Result

ancestor Selects all ancestors (parent, grandparent, etc.) of the

current node

ancestor-or- Selects all ancestors (parent, grandparent, etc.) of the

self current node and the current node itself

attribute Selects all attributes of the current node

child Selects all children of the current node

descendant Selects all descendants (children, grandchildren, etc.) of

the current node
XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

descendant- Selects all descendants (children, grandchildren, etc.) of

or-self the current node and the current node itself

following Selects everything in the document after the closing tag

of the current node

following- Selects all siblings after the current node

sibling

namespace Selects all namespace nodes of the current node

parent Selects the parent of the current node

preceding Selects all nodes that appear before the current node in
the document, except ancestors, attribute nodes and
namespace nodes

preceding- Selects all siblings before the current node

sibling

self Selects the current node

 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

Location Path Expression

A location path can be absolute or relative.

An absolute location path starts with a slash ( / ) and a relative location path
does not. In both cases the location path consists of one or more steps, each
separated by a slash:

An absolute location path:

/step/step/...

A relative location path:

step/step/...

Each step is evaluated against the nodes in the current node-set.

A step consists of:

 an axis (defines the tree-relationship between the selected nodes and the
current node)
 a node-test (identifies a node within an axis)
 zero or more predicates (to further refine the selected node-set)

The syntax for a location step is:

axisname::nodetest[predicate]

Examples

Example Result

child::book Selects all book nodes that are children of the current node
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

attribute::lang Selects the lang attribute of the current node

child::* Selects all element children of the current node

attribute::* Selects all attributes of the current node

child::text() Selects all text node children of the current node

child::node() Selects all children of the current node

descendant::book Selects all book descendants of the current node

ancestor::book Selects all book ancestors of the current node

ancestor-or- Selects all book ancestors of the current node - and the
self::book current as well if it is a book node

child::*/child::price Selects all price grandchildren of the current node

An XPath expression returns either a node-set, a string, a Boolean, or a

number.
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

XPath Operators
Below is a list of the operators that can be used in XPath expressions:

Operator Description Example

| Computes two node-sets //book | //cd

+ Addition 6+4

- Subtraction 6-4

* Multiplication 6*4

div Division 8 div 4

= Equal price=9.80

!= Not equal price!=9.80

 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

< Less than price<9.80

<= Less than or equal to price<=9.80

> Greater than price>9.80

>= Greater than or equal to price>=9.80

or or price=9.80 or price=9.70

and and price>9.00 and price<9.90

mod Modulus (division remainder) 5 mod 2

Let's try to learn some basic XPath syntax by looking at some examples.

The XML Example Document

We will use the following XML document in the examples below.

<?xml version="1.0" encoding="UTF-8"?>

<bookstore>
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

<book category="cooking">
<title lang="en">Everyday Italian</title>
<author>Giada De Laurentiis</author>
<year>2005</year>
<price>30.00</price>
</book>

<book category="children">
<title lang="en">Harry Potter</title>
<author>J K. Rowling</author>
<year>2005</year>
<price>29.99</price>
</book>

<book category="web">
<title lang="en">XQuery Kick Start</title>
<author>James McGovern</author>
<author>Per Bothner</author>
<author>Kurt Cagle</author>
<author>James Linn</author>
<author>Vaidyanathan Nagarajan</author>
<year>2003</year>
<price>49.99</price>
</book>

<book category="web">
<title lang="en">Learning XML</title>
<author>Erik T. Ray</author>
<year>2003</year>
<price>39.95</price>
</book>

</bookstore>

Loading the XML Document

Using an XMLHttpRequest object to load XML documents is supported in all
modern browsers.

var xmlhttp = new XMLHttpRequest();

 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

Code for older browsers (IE5 and IE6) can be found in the AJAX tutorial.

Selecting Nodes
Unfortunately, there are different ways of dealing with XPath in different
browsers.

Chrome, Firefox, Edge, Opera, and Safari use the evaluate() method to select
nodes:

xmlDoc.evaluate(xpath, xmlDoc, null, XPathResult.ANY_TYPE,null);

Internet Explorer uses the selectNodes() method to select node:

xmlDoc.selectNodes(xpath);

In our examples we have included code that should work with most major
browsers.

Select all the titles

The following example selects all the title nodes:

Example
/bookstore/book/title

Select the title of the first book

The following example selects the title of the first book node under the
bookstore element:

Example
/bookstore/book[1]/title
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

Select all the prices

The following example selects the text from all the price nodes:

Example
/bookstore/book/price[text()]

Select price nodes with price>35

The following example selects all the price nodes with a price higher than 35:

Example
/bookstore/book[price>35]/price

Select title nodes with price>35

The following example selects all the title nodes with a price higher than 35:

Example
/bookstore/book[price>35]/title
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

XSL (eXtensible Stylesheet Language) is a styling language for XML.

XSLT stands for XSL Transformations.

This tutorial will teach you how to use XSLT to transform XML documents
into other formats (like transforming XML into HTML).

Online XSLT Editor

With our online editor, you can edit XML and XSLT code, and click on a button
to view the result.
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

XSLT Example
<?xml version="1.0"?>

<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

<xsl:template match="/">
<html>
<body>
<h2>My CD Collection</h2>
<table border="1">
<tr bgcolor="#9acd32">
<th>Title</th>
<th>Artist</th>
</tr>
<xsl:for-each select="catalog/cd">
<tr>
<td><xsl:value-of select="title"/></td>
<td><xsl:value-of select="artist"/></td>
</tr>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>

</xsl:stylesheet>

What You Should Already Know

Before you continue you should have a basic understanding of the following:

 HTML
 XML

If you want to study these subjects first, find the tutorials on our Home page.
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

XSLT References
XSLT Elements

Description of all the XSLT elements from the W3C Recommendation, and
information about browser support.

XSLT, XPath, and XQuery Functions

XSLT 2.0, XPath 2.0, and XQuery 1.0, share the same functions library. There
are over 100 built-in functions. There are functions for string values, numeric
values, date and time comparison, node and QName manipulation, sequence
manipulation, and more.

XSLT is a language for transforming XML documents.

XPath is a language for navigating in XML documents.

XQuery is a language for querying XML documents.

It Started with XSL

XSL stands for EXtensible Stylesheet Language.

The World Wide Web Consortium (W3C) started to develop XSL because there
was a need for an XML-based Stylesheet Language.

CSS = Style Sheets for HTML

HTML uses predefined tags. The meaning of, and how to display each tag is well
understood.

CSS is used to add styles to HTML elements.

 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

XSL = Style Sheets for XML

XML does not use predefined tags, and therefore the meaning of each tag is not
well understood.

A <table> element could indicate an HTML table, a piece of furniture, or

something else - and browsers do not know how to display it!

So, XSL describes how the XML elements should be displayed.

XSL - More Than a Style Sheet Language

XSL consists of four parts:

 XSLT - a language for transforming XML documents

 XPath - a language for navigating in XML documents
 XSL-FO - a language for formatting XML documents (discontinued in
2013)
 XQuery - a language for querying XML documents

With the CSS3 Paged Media Module, W3C has delivered a new standard for
document formatting. So, since 2013, CSS3 is proposed as an XSL-FO
replacement.

What is XSLT?
 XSLT stands for XSL Transformations
 XSLT is the most important part of XSL
 XSLT transforms an XML document into another XML document
 XSLT uses XPath to navigate in XML documents
 XSLT is a W3C Recommendation
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

XSLT = XSL Transformations

XSLT is the most important part of XSL.

XSLT is used to transform an XML document into another XML document, or

another type of document that is recognized by a browser, like HTML and
XHTML. Normally XSLT does this by transforming each XML element into an
(X)HTML element.

With XSLT you can add/remove elements and attributes to or from the output
file. You can also rearrange and sort elements, perform tests and make
decisions about which elements to hide and display, and a lot more.

A common way to describe the transformation process is to say that XSLT

transforms an XML source-tree into an XML result-tree.

XSLT Uses XPath

XSLT uses XPath to find information in an XML document. XPath is used to
navigate through elements and attributes in XML documents.

If you want to study XPath first, please read our XPath Tutorial.

How Does it Work?

In the transformation process, XSLT uses XPath to define parts of the source
document that should match one or more predefined templates. When a match
is found, XSLT will transform the matching part of the source document into the
result document.

XSLT Browser Support

 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

All major browsers support XSLT and XPath.

XSLT is a W3C Recommendation

XSLT became a W3C Recommendation 16. November 1999.

XSLT - Transformation
Example study: How to transform XML into XHTML using XSLT?

The details of this example will be explained in the next chapter.

Correct Style Sheet Declaration

The root element that declares the document to be an XSL style sheet is
<xsl:stylesheet> or <xsl:transform>.

Note: <xsl:stylesheet> and <xsl:transform> are completely synonymous and

either can be used!

The correct way to declare an XSL style sheet according to the W3C XSLT
Recommendation is:

<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

or:

<xsl:transform version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

To get access to the XSLT elements, attributes and features we must declare
the XSLT namespace at the top of the document.
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

The xmlns:xsl="http://www.w3.org/1999/XSL/Transform" points to the official

W3C XSLT namespace. If you use this namespace, you must also include the
attribute version="1.0".

Start with a Raw XML Document

We want to transform the following XML document ("cdcatalog.xml") into
XHTML:

<?xml version="1.0" encoding="UTF-8"?>

<catalog>
<cd>
<title>Empire Burlesque</title>
<artist>Bob Dylan</artist>
<country>USA</country>
<company>Columbia</company>
<price>10.90</price>
<year>1985</year>
</cd>
.
.
</catalog>

Viewing XML Files in IE, Chrome, Firefox, Safari, and Opera: Open the
XML file (click on the link below) - The XML document will be displayed with
color-coded root and child elements (except in Safari). Often, there is a plus (+)
or minus sign (-) to the left of the elements that can be clicked to expand or
collapse the element structure. Tip: To view the raw XML source, right-click
in XML file and select "View Source"!
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

Create an XSL Style Sheet

Then you create an XSL Style Sheet ("cdcatalog.xsl") with a transformation
template:

<?xml version="1.0" encoding="UTF-8"?>

<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

<xsl:template match="/">
<html>
<body>
<h2>My CD Collection</h2>
<table border="1">
<tr bgcolor="#9acd32">
<th>Title</th>
<th>Artist</th>
</tr>
<xsl:for-each select="catalog/cd">
<tr>
<td><xsl:value-of select="title"/></td>
<td><xsl:value-of select="artist"/></td>
</tr>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>

</xsl:stylesheet>

Link the XSL Style Sheet to the XML Document

Add the XSL style sheet reference to your XML document ("cdcatalog.xml"):

<?xml version="1.0" encoding="UTF-8"?>

<?xml-stylesheet type="text/xsl" href="cdcatalog.xsl"?>
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

<catalog>
<cd>
<title>Empire Burlesque</title>
<artist>Bob Dylan</artist>
<country>USA</country>
<company>Columbia</company>
<price>10.90</price>
<year>1985</year>
</cd>
.
.
</catalog>

If you have an XSLT compliant browser it will nicely transform your XML into
XHTML.

The details of the example above will be explained in the next chapters.

XSLT <xsl:template> Element

An XSL style sheet consists of one or more set of rules that are called
templates.

A template contains rules to apply when a specified node is matched.

The <xsl:template> Element

The <xsl:template> element is used to build templates.

The match attribute is used to associate a template with an XML element. The
match attribute can also be used to define a template for the entire XML
document. The value of the match attribute is an XPath expression (i.e.
match="/" defines the whole document).

Ok, let's look at a simplified version of the XSL file from the previous chapter:
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

Example
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

<xsl:template match="/">
<html>
<body>
<h2>My CD Collection</h2>
<table border="1">
<tr bgcolor="#9acd32">
<th>Title</th>
<th>Artist</th>
</tr>
<tr>
<td>.</td>
<td>.</td>
</tr>
</table>
</body>
</html>
</xsl:template>

</xsl:stylesheet>

Try it Yourself »

Example Explained
Since an XSL style sheet is an XML document, it always begins with the XML
declaration: <?xml version="1.0" encoding="UTF-8"?>.

The next element, <xsl:stylesheet>, defines that this document is an XSLT

style sheet document (along with the version number and XSLT namespace
attributes).

The <xsl:template> element defines a template. The match="/" attribute

associates the template with the root of the XML source document.

The content inside the <xsl:template> element defines some HTML to write to
the output.
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

The last two lines define the end of the template and the end of the style sheet.

The result from this example was a little disappointing, because no data was
copied from the XML document to the output. In the next chapter you will learn
how to use the <xsl:value-of> element to select values from the XML
elements.

XSLT <xsl:value-of> Element

❮ Previous Next ❯

The <xsl:value-of> element is used to extract the value of a selected node.

The <xsl:value-of> Element

The <xsl:value-of> element can be used to extract the value of an XML element
and add it to the output stream of the transformation:

Example
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

<xsl:template match="/">
<html>
<body>
<h2>My CD Collection</h2>
<table border="1">
<tr bgcolor="#9acd32">
<th>Title</th>
<th>Artist</th>
</tr>
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

<tr>
<td><xsl:value-of select="catalog/cd/title"/></td>
<td><xsl:value-of select="catalog/cd/artist"/></td>
</tr>
</table>
</body>
</html>
</xsl:template>

</xsl:stylesheet>

Example Explained
Note: The select attribute, in the example above, contains an XPath
expression. An XPath expression works like navigating a file system; a forward
slash (/) selects subdirectories.

The result from the example above was a little disappointing; only one line of
data was copied from the XML document to the output. In the next chapter you
will learn how to use the <xsl:for-each> element to loop through the XML
elements, and display all of the records.

The <xsl:for-each> element allows you to do looping in XSLT.

The <xsl:for-each> Element

The XSL <xsl:for-each> element can be used to select every XML element of a
specified node-set:

Example
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

<xsl:template match="/">
<html>
<body>
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

<h2>My CD Collection</h2>
<table border="1">
<tr bgcolor="#9acd32">
<th>Title</th>
<th>Artist</th>
</tr>
<xsl:for-each select="catalog/cd">
<tr>
<td><xsl:value-of select="title"/></td>
<td><xsl:value-of select="artist"/></td>
</tr>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>

</xsl:stylesheet>

Try it Yourself »

Note: The value of the select attribute is an XPath expression. An XPath

expression works like navigating a file system; where a forward slash (/) selects
subdirectories.

Filtering the Output

We can also filter the output from the XML file by adding a criterion to the select
attribute in the <xsl:for-each> element.

<xsl:for-each select="catalog/cd[artist='Bob Dylan']">

Legal filter operators are:

 = (equal)
 != (not equal)
 &lt; less than
 &gt; greater than

Take a look at the adjusted XSL style sheet:

 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

Example
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

<xsl:template match="/">
<html>
<body>
<h2>My CD Collection</h2>
<table border="1">
<tr bgcolor="#9acd32">
<th>Title</th>
<th>Artist</th>
</tr>
<xsl:for-each select="catalog/cd[artist='Bob Dylan']">
<tr>
<td><xsl:value-of select="title"/></td>
<td><xsl:value-of select="artist"/></td>
</tr>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>

</xsl:stylesheet>

XSLT <xsl:sort> Element

The <xsl:sort> element is used to sort the output.

Where to put the Sort Information

To sort the output, simply add an <xsl:sort> element inside the <xsl:for-each>
element in the XSL file:
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

Example
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

<xsl:template match="/">
<html>
<body>
<h2>My CD Collection</h2>
<table border="1">
<tr bgcolor="#9acd32">
<th>Title</th>
<th>Artist</th>
</tr>
<xsl:for-each select="catalog/cd">
<xsl:sort select="artist"/>
<tr>
<td><xsl:value-of select="title"/></td>
<td><xsl:value-of select="artist"/></td>
</tr>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>

</xsl:stylesheet>

Note: The select attribute indicates what XML element to sort on.

XSLT <xsl:if> Element

The <xsl:if> element is used to put a conditional test against the content of
the XML file.

The <xsl:if> Element

 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

To put a conditional if test against the content of the XML file, add an <xsl:if>
element to the XSL document.

Syntax
<xsl:if test="expression">
...some output if the expression is true...
</xsl:if>

Where to Put the <xsl:if> Element

To add a conditional test, add the <xsl:if> element inside the <xsl:for-each>
element in the XSL file:

Example
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

<xsl:template match="/">
<html>
<body>
<h2>My CD Collection</h2>
<table border="1">
<tr bgcolor="#9acd32">
<th>Title</th>
<th>Artist</th>
<th>Price</th>
</tr>
<xsl:for-each select="catalog/cd">
<xsl:if test="price &gt; 10">
<tr>
<td><xsl:value-of select="title"/></td>
<td><xsl:value-of select="artist"/></td>
<td><xsl:value-of select="price"/></td>
</tr>
</xsl:if>
</xsl:for-each>
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

</table>
</body>
</html>
</xsl:template>

</xsl:stylesheet>

Note: The value of the required test attribute contains the expression to be
evaluated.

The code above will only output the title and artist elements of the CDs that has
a price that is higher than 10.

XSLT <xsl:choose> Element

The <xsl:choose> element is used in conjunction with <xsl:when> and
<xsl:otherwise> to express multiple conditional tests.

The <xsl:choose> Element

Syntax
<xsl:choose>
<xsl:when test="expression">
... some output ...
</xsl:when>
<xsl:otherwise>
... some output ....
</xsl:otherwise>
</xsl:choose>

Where to put the Choose Condition

 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

To insert a multiple conditional test against the XML file, add the <xsl:choose>,
<xsl:when>, and <xsl:otherwise> elements to the XSL file:

Example
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

<xsl:template match="/">
<html>
<body>
<h2>My CD Collection</h2>
<table border="1">
<tr bgcolor="#9acd32">
<th>Title</th>
<th>Artist</th>
</tr>
<xsl:for-each select="catalog/cd">
<tr>
<td><xsl:value-of select="title"/></td>
<xsl:choose>
<xsl:when test="price &gt; 10">
<td bgcolor="#ff00ff">
<xsl:value-of select="artist"/></td>
</xsl:when>
<xsl:otherwise>
<td><xsl:value-of select="artist"/></td>
</xsl:otherwise>
</xsl:choose>
</tr>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>

</xsl:stylesheet>

The code above will add a pink background-color to the "Artist" column WHEN
the price of the CD is higher than 10.
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

Another Example
Here is another example that contains two <xsl:when> elements:

Example
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

<xsl:template match="/">
<html>
<body>
<h2>My CD Collection</h2>
<table border="1">
<tr bgcolor="#9acd32">
<th>Title</th>
<th>Artist</th>
</tr>
<xsl:for-each select="catalog/cd">
<tr>
<td><xsl:value-of select="title"/></td>
<xsl:choose>
<xsl:when test="price &gt; 10">
<td bgcolor="#ff00ff">
<xsl:value-of select="artist"/></td>
</xsl:when>
<xsl:when test="price &gt; 9">
<td bgcolor="#cccccc">
<xsl:value-of select="artist"/></td>
</xsl:when>
<xsl:otherwise>
<td><xsl:value-of select="artist"/></td>
</xsl:otherwise>
</xsl:choose>
</tr>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

</xsl:stylesheet>

The code above will add a pink background color to the "Artist" column WHEN
the price of the CD is higher than 10, and a grey background-color WHEN the
price of the CD is higher than 9 and lower or equal to 10.

XSLT <xsl:apply-templates> Element

The <xsl:apply-templates> element applies a template to the current
element or to the current element's child nodes.

The <xsl:apply-templates> Element

The <xsl:apply-templates> element applies a template to the current element
or to the current element's child nodes.

If we add a select attribute to the <xsl:apply-templates> element it will process

only the child element that matches the value of the attribute. We can use the
select attribute to specify the order in which the child nodes are processed.

Look at the following XSL style sheet:

Example
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

<xsl:template match="/">
<html>
<body>
<h2>My CD Collection</h2>
<xsl:apply-templates/>
</body>
</html>
</xsl:template>
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

<xsl:template match="cd">
<p>
<xsl:apply-templates select="title"/>
<xsl:apply-templates select="artist"/>
</p>
</xsl:template>

<xsl:template match="title">
Title: <span style="color:#ff0000">
<xsl:value-of select="."/></span>
<br />
</xsl:template>

<xsl:template match="artist">
Artist: <span style="color:#00ff00">
<xsl:value-of select="."/></span>
<br />
</xsl:template>

</xsl:stylesheet>

XSLT - On the Client

XSLT can be used to transform the document to XHTML in your browser.

A JavaScript Solution
In the previous chapters we have explained how XSLT can be used to transform
a document from XML to XHTML. We did this by adding an XSL style sheet to
the XML file and let the browser do the transformation.

Even if this works fine, it is not always desirable to include a style sheet
reference in an XML file (e.g. it will not work in a non XSLT aware browser.)

A more versatile solution would be to use a JavaScript to do the transformation.

 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

By using a JavaScript, we can:

 do browser-specific testing
 use different style sheets according to browser and user needs

That is the beauty of XSLT! One of the design goals for XSLT was to make it
possible to transform data from one format to another, supporting different
browsers and different user needs.

The XML File and the XSL File

Look at the XML document that you have seen in the previous chapters:

<?xml version="1.0" encoding="UTF-8"?>

<catalog>
<cd>
<title>Empire Burlesque</title>
<artist>Bob Dylan</artist>
<country>USA</country>
<company>Columbia</company>
<price>10.90</price>
<year>1985</year>
</cd>
.
.
</catalog>

View the XML file.

And the accompanying XSL style sheet:

<?xml version="1.0" encoding="UTF-8"?>

<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

<xsl:template match="/">
<h2>My CD Collection</h2>
<table border="1">
<tr bgcolor="#9acd32">
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

<th style="text-align:left">Title</th>
<th style="text-align:left">Artist</th>
</tr>
<xsl:for-each select="catalog/cd">
<tr>
<td><xsl:value-of select="title" /></td>
<td><xsl:value-of select="artist" /></td>
</tr>
</xsl:for-each>
</table>
</xsl:template>

</xsl:stylesheet>

View the XSL file.

Notice that the XML file does not have a reference to the XSL file.

IMPORTANT: The above sentence indicates that an XML file could be

transformed using many different XSL style sheets.

Transforming XML to XHTML in the Browser

Here is the source code needed to transform the XML file to XHTML on the
client:

Example
<!DOCTYPE html>
<html>
<head>
<script>
function loadXMLDoc(filename)
{
if (window.ActiveXObject)
{
xhttp = new ActiveXObject("Msxml2.XMLHTTP");
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

}
else
{
xhttp = new XMLHttpRequest();
}
xhttp.open("GET", filename, false);
try {xhttp.responseType = "msxml-document"} catch(err) {} // Helping IE11
xhttp.send("");
return xhttp.responseXML;
}

function displayResult()
{
xml = loadXMLDoc("cdcatalog.xml");
xsl = loadXMLDoc("cdcatalog.xsl");
// code for IE
if (window.ActiveXObject || xhttp.responseType == "msxml-document")
{
ex = xml.transformNode(xsl);
document.getElementById("example").innerHTML = ex;
}
// code for Chrome, Firefox, Opera, etc.
else if (document.implementation && document.implementation.createDocument)
{
xsltProcessor = new XSLTProcessor();
xsltProcessor.importStylesheet(xsl);
resultDocument = xsltProcessor.transformToFragment(xml, document);
document.getElementById("example").appendChild(resultDocument);
}
}
</script>
</head>
<body onload="displayResult()">
<div id="example" />
</body>
</html>

Tip: If you don't know how to write JavaScript, please study our JavaScript
tutorial.

Example Explained:
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

The loadXMLDoc() function does the following:

 Create an XMLHttpRequest object

 Use the open() and send() methods of the XMLHttpRequest object to send
a request to a server
 Get the response data as XML data

The displayResult() function is used to display the XML file styled by

the XSL file:

 Load XML and XSL files

 Test what kind of browser the user has
 If Internet Explorer:
o Use the transformNode() method to apply the XSL style sheet to
the xml document
o Set the body of the current document (id="example") to contain
the styled xml document
 If other browsers:
o Create a new XSLTProcessor object and import the XSL file to it
o Use the transformToFragment() method to apply the XSL style
sheet to the xml document
o Set the body of the current document (id="example") to contain
the styled xml document

XSLT - On the Server

❮ Previous Next ❯

To make XML data available to all kind of browsers, we can transform the
XML document on the SERVER and send it back to the browser as XHTML.

A Cross Browser Solution

In the previous chapter we explained how XSLT can be used to transform a
document from XML to XHTML in the browser. We used a JavaScript and an XML
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

parser for the transformation. However, this will not work in a browser that
doesn't have an XML parser.

To make XML data available to all kind of browsers, we can transform the XML
document on the server and send back to the browser as XHTML.

That's another beauty of XSLT. One of the design goals for XSLT was to make it
possible to transform data from one format to another on a server, returning
readable data to all kinds of browsers.

The XML File and the XSLT File

Look at the XML document that you have seen in the previous chapters:

<?xml version="1.0" encoding="UTF-8"?>

<catalog>
<cd>
<title>Empire Burlesque</title>
<artist>Bob Dylan</artist>
<country>USA</country>
<company>Columbia</company>
<price>10.90</price>
<year>1985</year>
</cd>
.
.
</catalog>

View the XML file.

And the accompanying XSL style sheet:

<?xml version="1.0" encoding="UTF-8"?>

<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

<xsl:template match="/">
<h2>My CD Collection</h2>
<table border="1">
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

<tr bgcolor="#9acd32">
<th style="text-align:left">Title</th>
<th style="text-align:left">Artist</th>
</tr>
<xsl:for-each select="catalog/cd">
<tr>
<td><xsl:value-of select="title" /></td>
<td><xsl:value-of select="artist" /></td>
</tr>
</xsl:for-each>
</table>
</xsl:template>

</xsl:stylesheet>

View the XSL file.

Notice that the XML file does not have a reference to the XSL file.

IMPORTANT: The above sentence indicates that an XML file could be

transformed using many different XSL style sheets.

Training
Group Wellesley’s training programs include a range of technical communication tools, technologies,
and core skills. We work with our clients to personalize the training to your specific business needs.
We can offer training sessions at your site or at off-site training facilities.
Our instructor credentials include:
 Authorized instructor for Certified Professional Technical Communicator (CPTC) Exam Preparation
Course.
 Adobe-Certified Instructor (ACI) in Adobe Captivate and FrameMaker
 Certified Technical Trainer (CTT+)
 Certified Online Training Professional (COTP)
Contact Group Wellesley at [email protected]. to learn more about our training courses or to
discuss training programs developed specifically for your company.

Training Programs
Adobe Captivate Courses
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

Adobe Captivate: The Essentials (2 days)

Adobe Captivate: Beyond the Essentials (2 days)
Adobe Captivate: Advanced Actions (1 day)

Adobe FrameMaker Courses

Basic Authoring (3 days)
Prerequisites: Basic computer skills; familiarity with a word processor, such as Microsoft Word.
Description: FrameMaker is no longer just for writing technical documents. FrameMaker is an
excellent tool for creating and publishing large, complex, maintainable documents. FrameMaker’s
built-in structured document authoring allows writers to author XML documents using a familiar
word-processing interface. Template-based authoring allows writers to generate content without
worrying about formatting issues. The multi-channel publishing capabilities of FrameMaker allow you
to publish your documents to print, PDF, HTML, or XML.
This course teaches you how to author and format documents using FrameMaker. The course
covers FrameMaker’s word processing, graphics, table and page layout capabilities, as well as basic
numbering, cross-references, and variables. The course covers both unstructured and structured
FrameMaker.
Topics Covered: FrameMaker overview; working with unstructured and structured documents;
editing text, finding text, spell-checking, and using the thesaurus; unstructured templates and
paragraph styles; character and paragraph formatting; tabs, pagination, and hyphenation; basic
numbering; using online help; editing structure; attributes; validation; advanced structure; drawing
graphics and text objects; anchored frames; imported files; working with cross references, system
variables, footnotes and tables.
Advanced Topics (2 days)
Prerequisites: FrameMaker Basic Authoring or previous FrameMaker experience.
Description: FrameMaker is no longer just for writing technical documents. If you need to create,
manage, and publish large, complex, maintainable documents, FrameMaker is the tool for you.
FrameMaker’s built-in XML authoring capabilities allow you to author XML documents using a
familiar word-processing interface. Template-based authoring allows writers to generate content
without worrying about formatting issues. The multi-channel publishing capabilities of FrameMaker
allow you to publish your documents to print, PDF, HTML, or XML.
This class builds on the knowledge provided in FrameMaker: Basic Authoring , and provides the
background necessary for students to create and maintain FrameMaker templates. The course
covers both unstructured and structured FrameMaker.
Topics Covered: Advanced system and user variables; text insets and advanced cross-references
advanced numbering; table formats; change bars and document revisions; conditional text;
hypertext; master page creation and use; basic reference page usage; color definitions; unstructured
and structured templates; building books; generated files; structured books; and output (making
PDF, HTML, and XML).

XML and Related Technologies Courses

Introduction to XML (2 days)
Prerequisites: Familiarity with HTML. Some familiarity with programming languages is helpful, but
not required.
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

Description: This two-day class teaches the basic concepts of XML. This course is appropriate for
technical writers, publication department managers, and information technology personnel who are
considering migrating to XML-based publishing. Students will learn how XML can improve and
transform conventional publishing processes.
Topics Covered: Designing XML documents; modeling real-world documents to prepare for
migration to XML; learning XML terminology and syntax; expressing your document model as an
XML document type definition (DTD); validating XML documents against a DTD; evaluating industry-
standard DTDs, such as DocBook; authoring XML documents in a text editor and using authoring
tools (Adobe FrameMaker); transforming and customizing XML documents; learning the basics of
XSLT (XML Transformation Language) and XPath (XML Path Language); using XSLT and XPath to
create customized documents by selecting appropriate content for publishing; publishing XML
documents; transforming XML documents to HTML/XHTML for web publishing; transforming XML
documents to WML (wireless markup language) for publishing to cell phones and personal digital
assistants.
Practical Transformation with XSLT and XPath (3 days)
Prerequisites: Introduction to XML , or familiarity with XML syntax and concepts; ability to use a text
editor. knowledge of HTML is highly desirable; and some programming experience with any
language (compiled or interpreted) is highly desirable.
Description: This three-day course completely covers the Extensible Stylesheet Language
Transformations (XSLT) and the XML Path Language (XPath) Recommendations of the World Wide
Web Consortium. XSLT and XPath are used together for transforming XML documents to other
formats or vocabularies (e.g. XML to XML, XML to HTML, XML to WML, XML to text, etc.). Every
element, attribute, and function of XSLT and XPath are covered. Students will design and develop
XSLT scripts during hands-on exercise sessions.
Topics Covered: Introduction to XSL transformations and the XML path language; getting started
with XSLT and XPath; XPath data model; XSLT processing model; XSLT transformation
environment; XSLT stylesheet management; XSLT instructions; XPath and XSLT expressions and
advanced techniques; sorting and grouping; XML to HTML transformation techniques; XSL
formatting semantics introduction; element, grammar, function, and object quick references; and
sample tool information.
Practical Formatting with XSL-FO (2 days)
Prerequisites: Introduction to XML and Practical Transformation with XSLT and XPath , or
equivalent hands-on experience with XML, XSLT, and XPath.
Description: This two-day course provides an overview of the Extensible Stylesheet Language
Formatting Objects (XSL-FO) Recommendation of the World Wide Web Consortium, used to specify
the format of XML documents on a printed page or other page-oriented display. Students will design
and develop XSL-FO scripts using XSLT and XPath during hands-on exercise sessions.
Topics Covered: Basic concepts and context of XSL-FO ; area and page basics; body contents;
lists, graphics, links, leaders; tables; pagination; headers and footers; floats and footnotes; keeps
and breaks; interactive objects; supplemental objects; XSL-FO object summary; XSL-FO property
summary; and sample tool information.

DITA (Darwin Information Typing Architecture)

Courses
 XPATHM
XPATH MANUAL
CHAPTER 1
BY WWW.W3SCHOOLS.COM

Introduction to DITA (1 day)

This one-day course provides an overview of the history, design, and features of the DITA
architecture.
Introduction to DITA (2 days)
This course provides more in-depth coverage of DITA than our 1-day seminar. Students will create
and publish DITA documents using the DITA Open Toolkit.
Using DITA and Adobe FrameMaker (3 days)
This three-day course teaches DITA concepts and provides training in authoring DITA documents
using Adobe FrameMaker.
Using DITA and Justsystems XMetal (3 days)
This three-day course teaches DITA concepts and provides training in authoring DITA documents
using Justsystems XMetaL XML authoring tool.