126.96.36.199.1 Cascading of attributes from map to map
Certain elements cascade from map to map, although some of the attributes that cascade within a map do not cascade from map to map.
@propsand any attribute specialized from
@formatattribute must be set to "ditamap" in order to reference a map or a branch of a map, so it cannot cascade through to the referenced map.
- Cascading behavior for
@xml:langis defined in The xml:lang attribute . The
@dirattribute work the same way.
- The value of the
@scopeattribute describes the map itself, rather than the content. When the
@scopeattribute is set to "external", it indicates that the referenced map itself is external and unavailable, so the value cannot cascade into that referenced map.
@class attribute is used to determine the processing roles that cascade
from map to map. See Cascading of roles from map to map
As with values that cascade within a map, the cascading is additive if the attribute permits
multiple values (such as
@audience). When the attribute only permits one
value, the cascading value overrides the top-level element.
Example of attributes cascading between maps
<map> <topicref href="a.ditamap" format="ditamap" toc="no"/> <mapref href="b.ditamap" audience="developer"/> <topicref href="c.ditamap#branch1" format="ditamap" print="no"/> <mapref href="c.ditamap#branch2" platform="myPlatform"/> </map>
- The map a.ditamap is treated as if
toc="no"is specified on the root
<map>element. This means that the topics that are referenced by a.ditamap do not appear in the navigation generated by test.ditamap (except for branches within the map that explicitly set
- The map b.ditamap is treated as if
audience="developer"is set on the root
<map>element. If the
@audienceattribute is already set on the root
<map>element within b.ditamap, the value "developer" is added to any existing values.
- The element with
id="branch1"within the map c.ditamap is treated as if
print="no"is specified on that element. This means that the topics within the branch with
id="branch1"do not appear in the printed output generated by test.ditamap (except for nested branches within that branch that explicitly set
- The element with
id="branch2"within the map c.ditamap is treated as if
platform="myPlatform"is specified on that element. If the
@platformattribute is already specified on the element with
id="branch", the value "myPlatform" is added to existing values.