Each selector given to this function will be translated to an
equivalent XPath expression. The resulting XPath expression can be
given a prefix which determines the scope of the expression. The
default prefix determines the scope to be the node itself and all
descendants of the node. Most commonly the prefix is either the
default or ""
, unless it is known what scope a particular XPath
expression should have.
The translator used is usually unnecessary to specify as the default
is sufficient for most cases. However, it is of use when creating
expressions relating to (X)HTML pseudo elements and languages. In
particular it qualifies the following pseudo selectors to apply only
to relevant (X)HTML elements: :checked
, :disabled
,
:enabled
and :link
.
When the translator is set to html
, all elements and
attributes will be converted to lower case. This restriction is
removed when the translator is xhtml
(or the default
generic
translator).