Axis steps

The basic primitive for accessing a source document is the axis step. Axis steps may be combined into path expressions using the path operators / and //, and they may be filtered using filter expressions in the same way as the result of any other expression.

An axis step has the basic form axis :: node-test, and selects nodes on a given axis that satisfy the node-test. The axes available are:

ancestor	Selects ancestor nodes starting with the current node and ending with the document node
ancestor-or-self	Selects the current node plus all ancestor nodes
attribute	Selects all attributes of the current node (if it is an element)
child	Selects the children of the current node, in document order
descendant	Selects the children of the current node and their children, recursively (in document order)
descendant-or-self	Selects the current node plus all descendant nodes
following	Selects the nodes that follow the current node in document order, other than its descendants
following-sibling	Selects all subsequent child nodes of the same parent node
namespace	Selects all the in-scope namespaces for an element (this axis is deprecated in the W3C XPath specification, but Saxon will continue to support it)
parent	Selects the parent of the current node
preceding	Selects the nodes that precede the current node in document order, other than its ancestors
preceding-sibling	Selects all preceding child nodes of the same parent node
self	Selects the current node

When the child axis is used, child:: may be omitted, and when the attribute axis is used, attribute:: may be abbreviated to @. The expression parent::node() may be shortened to ..

The expression . is no longer synonymous with self::node(), since it may now select items that are not nodes. If the context item is not a node, any use of a path expression will raise an error.

The node-test may be, for example:

a node name
prefix:* to select nodes in a given namespace
*:localname to select nodes with a given local name, regardless of namespace
text() to select text nodes
node() to select any node
processing-instruction() to select any processing instruction
processing-instruction('literal') to select processing instructions with the given name (target)
comment() to select comment nodes
element() or element(*) to select any element node
element(N) to select any element node named N
element(*, T) to select any element node whose type annotation is T, or a subtype of T
element(N, T) to select any element node whose name is N and whose type annotation is T, or a subtype of T
schema-element(N) to select any element node whose name is N, or an element in the substitution group of N, that conforms to the schema-defined type for a global element declaration named N in an imported schema
attribute or attribute(*) to select any attribute node
attribute(N) to select any attribute node named N
attribute(*, T) to select any attribute node whose type annotation is T, or a subtype of T
attribute(N, T) to select any attribute node whose name is N and whose type annotation is T, or a subtype of T
schema-attribute(N) to select any attribute node whose name is N, that conforms to the schema-defined type for a global attribute declaration named N in an imported schema