osy XPath
Vzorový dokument XML
V níže uvedených příkladech použijeme následující dokument XML.
<?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>
osy XPath
Osa představuje vztah ke kontextovému (aktuálnímu) uzlu a používá se k vyhledání uzlů vzhledem k tomuto uzlu ve stromu.
| 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 |
Vyjádření cesty umístění
Cesta umístění může být absolutní nebo relativní.
Cesta absolutního umístění začíná lomítkem ( / ) a cesta relativního umístění nikoli. V obou případech se cesta umístění skládá z jednoho nebo více kroků, každý oddělených lomítkem:
An absolute location path:
/step/step/...
A relative location path:
step/step/...
Každý krok je vyhodnocen proti uzlům v aktuální sadě uzlů.
Krok se skládá z:
- osa (definuje stromový vztah mezi vybranými uzly a aktuálním uzlem)
- test uzlu (identifikuje uzel v ose)
- nula nebo více predikátů (pro další upřesnění vybrané sady uzlů)
Syntaxe pro krok umístění je:
axisname::nodetest[predicate]
Příklady
| 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 |