Name
[2.0] idref()
Given a sequence of ID values, returns a sequence containing
all the nodes with an IDREF
value matching one of the given IDs.
Syntax
node()*idref(xs:string*)node()*idref(xs:string*,node())
Inputs
A sequence of xs:strings,
each of which represents an ID
value. If the node()
argument is supplied, the XSLT processor looks for matching
IDREF and IDREFS values in the document that
contains that node. Without the node() argument, the processor looks
in the document that contains the context node.
Outputs
A sequence of nodes, each of which has an IDREF or IDREFS value that matches one of the
given IDs. The nodes are
returned in document order, and any duplicate nodes are
removed.
Defined in
XQuery 1.0 and XPath 2.0 Functions and Operators section 15.5, “Functions and Operators that Generate Sequences.”
Example
For our example, we’ll use a list of components and parts
with an embedded DTD. We’ll list each part, followed by the name
of each component that uses that part. The idref() function lets us retrieve
the <component> element
with the specific ID; from
there we can get the name of the component.
Note
This is the exact opposite of the example for the id() function. In that example, we
take each <component>
and list all of the parts that it uses.
To illustrate the idref() function, we’ll use an XML
document with an embedded DTD. (This allows us to demonstrate the
function without requiring a schema-aware XSLT processor.) Here is
a fragment of the document:
<?xml version="1.0"?> ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access