@conkeyref
attributeThe @conkeyref
attribute provides an indirect content reference to
topic elements, map elements, or elements within maps or topics. When the DITA content is
processed, the key references are resolved using key definitions from DITA maps.
For content references from map elements to map elements or topic elements to topic
elements, the value of the @conkeyref
attribute is a key name, where the key
must be bound to a map element (for references from map elements) or a topic element (for
references from topic elements). For all other elements, the value of the
@conkeyref
attribute is a key name, an optional slash ("/"), and the ID of the target element, where the key name must be bound to
the map or topic that contains the topic element.
When the key name specified by the @conkeyref
attribute is not defined and
the element also specifies a @conref
attribute, the @conref
attribute is used to determine the content reference relationship. If no
@conref
attribute is specified there is no content reference relationship.
Processors SHOULD issue a warning when
a @conkeyref
reference cannot be resolved and there is no
@conref
attribute to use as a fallback. Processors MAY issue a warning when a @conkeyref
cannot
be resolved to an element and a specified @conref
is used as a fallback.
The @conrefend
attribute, which defines the end of a conref range, cannot include a key. Instead the map or topic element
addressed by the key name component of the @conkeyref
is used in place of
whatever map or topic element is addressed by the @conrefend
attribute. See
Using conrefend together with conkeyref for more
information and for examples of this behavior.