<learningGroup>
In addition to organizing <learningObject> elements, a <learningGroup> can include topic references to <learningPlan>, <learningOverview>. and <learningSummary> topics, and can also include references to <learningAssessment> topics. A <learningGroup> can also contain other <learningGroup> elements, allowing you to organize learning content at course, module, or other higher levels of hierarchy.
Content models
See appendix for information about this element in OASIS document type shells.
Inheritance
+ map/topicref learningmap-d/learningGroup
Example
<map id="learningGroup_example">
<!-- a learningGroup can appear anywhere in a map hierarchy but always
follows a consistent information pattern -->
<!-- ************************************************************* -->
<!-- a course=level learning group -->
<learningGroup href="course_top_Overview.dita" type="learningOverview">
<!-- ************************************************************* -->
<learningPlanRef href="course_Plan_topic.dita" type="learningPlan" />
<learningOverviewRef href="course_Overview.dita" type="learningOverview"/>
<!-- ************************************************************* -->
<!-- module-level learning groups -->
<learningGroup href="module1_Overview.dita" type="learningOverview">
<!-- ************************************************************* -->
<learningOverviewRef href="module1_Overview.dita" type="learningOverview"/>
<!-- ************************************************************* -->
<!-- This module has two lesson-level groups of learning objects -->
<learningGroup href="lesson1_Overview.dita" type="learningOverview">
<!-- ************************************************************* -->
<learningOverviewRef href="lesson1_Overview.dita" type="learningOverview"/>
<!-- learning objects in lesson1 -->
<learningObject collection-type="sequence" href="lo1_Overview.dita" type="learningOverview">
<!-- . . . -->
</learningObject>
<learningObject collection-type="sequence" href="lo2_Overview.dita" type="learningOverview">
<!-- . . . -->
</learningObject>
<learningAssessmentRef href="lesson1_Assessment.dita" type="learningAssessment"/>
<learningSummaryRef href="lesson1_Summary.dita" type="learningSummary"/>
</learningGroup>
<!-- ************************************************************* -->
<learningGroup href="lesson2_Overview.dita" type="learningOverview">
<!-- ************************************************************* -->
<learningOverviewRef href="lesson1_Overview.dita" type="learningOverview"/>
<!-- learning objects in lesson2 -->
<learningObject collection-type="sequence" href="lo3_Overview.dita" type="learningOverview">
<!-- . . . -->
</learningObject>
<learningObject collection-type="sequence" href="lo4_Overview.dita" type="learningOverview">
<!-- . . . -->
</learningObject>
<learningAssessmentRef href="lesson2_Assessment.dita" type="learningAssessment"/>
<learningSummaryRef href="lesson2_Summary.dita" type="learningSummary"/>
</learningGroup>
</learningGroup>
<!-- ************************************************************* -->
<learningGroup href="module2_Overview.dita" type="learningOverview">
<!-- ************************************************************* -->
<learningOverviewRef href="module1_Overview.dita" type="learningOverview"/>
<!-- learning objects in module 2 (no lesson-level groups) -->
<learningObject collection-type="sequence" href="loA_Overview.dita" type="learningOverview">
<!-- . . . -->
</learningObject>
<learningObject collection-type="sequence" href="loB_Overview.dita" type="learningOverview">
</learningObject>
<!-- . . . -->
<learningObject collection-type="sequence" href="loC_Overview.dita" type="learningOverview">
</learningObject>
<learningAssessmentRef href="module2_Assessment.dita" type="learningAssessment"/>
<learningSummaryRef href="module2_Summary.dita" type="learningSummary"/>
</learningGroup>
<!-- ************************************************************* -->
<learningAssessmentRef href="course_Assessment.dita" type="learningAssessment"/>
<learningSummaryRef href="course_Summary.dita" type="learningSummary"/>
</learningGroup>
<!-- ************************************************************* -->
</map>
Attributes
The following attributes are available on this element: Universal attribute group, Link relationship attribute group (with a narrowed definition of @href, given below), Attributes common to many map elements, Topicref element attributes group, @outputclass, @keys, and @keyref.
- @href
- A pointer to the resource represented by the <topicref>. See The @href attribute for detailed information on supported values and processing implications. References to DITA content cannot be below the topic level: that is, you cannot reference individual elements inside a topic. References to content other than DITA topics should use the @format attribute to identify the kind of resource being referenced.