Оси XPath
Пример XML-документа
Мы будем использовать следующий 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>
Оси XPath
Ось представляет отношение к контекстному (текущему) узлу и используется для определения местоположения узлов относительно этого узла в дереве.
| 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 |
Выражение пути местоположения
Путь местоположения может быть абсолютным или относительным.
Путь абсолютного местоположения начинается с косой черты (/), а путь относительного местоположения — нет. В обоих случаях путь местоположения состоит из одного или нескольких шагов, разделенных косой чертой:
An absolute location path:
/step/step/...
A relative location path:
step/step/...
Каждый шаг оценивается по узлам в текущем наборе узлов.
Шаг состоит из:
- ось (определяет древовидную связь между выбранными узлами и текущим узлом)
- проверка узла (идентифицирует узел внутри оси)
- ноль или более предикатов (для дальнейшего уточнения выбранного набора узлов)
Синтаксис шага местоположения:
axisname::nodetest[predicate]
Примеры
| 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 |