<ditavalref> element references a DITAVAL document that
specifies filter conditions that can be used to process a map or map branch. Other
DITAVAL-reference domain elements can be used to imply multiple copies of the map branch that
contains them and so apply a different set of conditions to each copy.
<ditavalref> element is included in a map, the conditions in
the referenced DITAVAL document are used to filter the elements in the branch. The branch
includes the parent element that contains the
any child elements, and all resources that are referenced by the parent element or its
children. While there is no technical restriction that forces
<ditavalref> to appear before peer topic references, placing them
first is considered a best practice and all examples in the specification will use this
<map> <topicref href="sampleBranch.dita" audience="admin"> <topicmeta> <navtitle>Navigation title for branch</navtitle> </topicmeta> <ditavalref href="conditions.ditaval"/> <topicref href="insideBranch.dita" platform="win linux mac"/> </topicref> <!-- Other branches not affected by conditions.ditaval --> </map>
<topicref>element that references sampleBranch.dita and all child elements:
When more than one
<ditavalref> element is specified in the same
branch at the same level, the effective result is one copy of the branch for each
<ditavalref> element. If the example above contains a reference to
otherConditions.ditaval as a peer to the existing
<ditavalref> element, the rendered version of this map would
reflect two copies of "Sample branch", each reflecting the conditions that are specified in
the corresponding DITAVAL document. One copy is created using the conditions in
conditions.ditaval, while the other copy uses the conditions from
otherConditions.ditaval. Map authors can use specific elements from
the DITAVAL reference domain to indicate how resources are
renamed, or processors can recover from naming collisions by
using an alternate naming scheme. See Limitations
below for more information.
@audienceattribute might be set to "exclude" by default, with no specific condition specified for the value audience="novice".
<topicref href="ancestor.dita"> <ditavalref href="highLevel.ditaval"/> <topicref href="descendent.dita"> <ditavalref href="lowLevel.ditaval"/> <!-- Other topicrefs --> </topicref> </topicref>
<ditavalref> element is used that does not specify the
@href attribute, the element is still processed but no additional
filtering is applied. This can be used to create an unfiltered copy of a map branch
alongside other filtered copies; other aspects of the
(such as any specified key scope or modified resource name) will still be applied to the
The following limitations apply when using the
these limitations cannot be enforced in a DTD or other XML grammar files.
<ditavalref>element results in multiple copies of a branch, resource names within that branch can be controlled with sub-elements of the effective
<ditavalref>. For situations where resource names are relevant, it is an error condition for multiple
<ditavalref>elements to result in conflicting resource names for different content. For example, the following map fragment would result in two distinct copies of the c.dita topic with the same file name:
<topicref href="c.dita"> <ditavalref href="one.ditaval"/> <ditavalref href="two.ditaval"/> </topicref>
Processors MAY recover by using an alternate naming scheme for the conflicting copies.
See appendix for information about this element in OASIS document type shells.
+ map/topicref ditavalref-d/ditavalref
See Examples of branch filtering for several
examples of the
The following attributes are available on this element: Universal attribute group (except for
which is removed for all elements in this domain) and the attributes defined below.
@hrefattribute is unspecified, this
<ditavalref>will not result in any new filtering behavior, but other aspects of the element are still evaluated. See The href attribute for general information on the format and processing implications of the
Return to main page.
Standards Track Work Product
|Copyright © OASIS Open 2016. All Rights Reserved.||25 October 2016|