Object References
For the following object references, x and y represent numerical indexes.
doc.element[x].property
An absolute reference uses a numerical index into an element array.
doc.element[x].element[x].property
Nested element arrays scope the object reference to children elements.
doc.element[x].line[x].property
An array of lines is fabricated when the text property of a node contains line breaks.
doc.element[x].^.property
The parent of an element is referenced with ^.
doc.element[x].?[x].property
A ? matches any type of element array.
doc.element[].property
Empty brackets signify that all members of an element array are to be returned.
doc.element|element[].property
The | is used to signify a logical 'OR'. The contents of two or more element arrays can be returned.
doc.element[x-y].property
Returns a range of elements from an array.
doc.element[x-end].property
end is a reserved word that returns the final element of an array.
doc.element[x,y,z].property
Returns items x, y, and z where x, y, and z represent numerical indexes into an element array.
doc.element[x+y].property
Returns element x and every y element thereafter.
doc.element['match'].property
Returns an array of elements whose text property matches the match string, which can contain the following wildcard characters:
Use this character... | To... |
* | Match any sequence of zero or more characters. |
? | Match any single character. |
% | Matches a single word, where word is defined to be any sequence of non-whitespace characters. |
\ | Escape any of the above wildcard characters. |
Match strings are compared with the .text property of the indexed object. The .text property contains the text of all child objects.
doc.element[/RegularExpression/].property
Returns an array of elements whose text property matches the specified regular expression. For information about how to construct a regular expression, see
Regular Expressions.
doc.element(property='match').property
Matches the value of a specific element property.