Axes XPath
L'exemple de document XML
Nous utiliserons le document XML suivant dans les exemples ci-dessous.
<?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>
Axes XPath
Un axe représente une relation avec le nœud de contexte (actuel) et est utilisé pour localiser les nœuds par rapport à ce nœud sur l'arbre.
| AxisName | Result |
|---|---|
| ancestor | Selects all ancestors (parent, grandparent, etc.) of the current node |
| ancestor-or-self | Selects all ancestors (parent, grandparent, etc.) of the 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 |
| descendant-or-self | Selects all descendants (children, grandchildren, etc.) of the current node and the current node itself |
| following | Selects everything in the document after the closing tag of the current node |
| following-sibling | Selects all siblings after the current node |
| 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-sibling | Selects all siblings before the current node |
| self | Selects the current node |
Expression de chemin d'emplacement
Un chemin de localisation peut être absolu ou relatif.
Un chemin de localisation absolu commence par une barre oblique (/) et un chemin de localisation relatif ne le fait pas. Dans les deux cas, le chemin de localisation consiste en une ou plusieurs étapes, chacune séparée par une barre oblique :
An absolute location path:
/step/step/...
A relative location path:
step/step/...
Chaque étape est évaluée par rapport aux nœuds de l'ensemble de nœuds actuel.
Une étape consiste à :
- un axe (définit la relation arborescente entre les nœuds sélectionnés et le nœud courant)
- un test de nœud (identifie un nœud dans un axe)
- zéro ou plusieurs prédicats (pour affiner davantage l'ensemble de nœuds sélectionné)
La syntaxe d'une étape de localisation est :
axisname::nodetest[predicate]
Exemples
| Example | Result |
|---|---|
| child::book | Selects all book nodes that are children of the current node |
| 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-self::book | Selects all book ancestors of the current node - and the current as well if it is a book node |
| child::*/child::price | Selects all price grandchildren of the current node |