<?xml version="1.0" encoding="utf-8"?>
<!-- (c) Copyright IBM Corp. 2004, 2005 All Rights Reserved. -->

<!DOCTYPE elementref PUBLIC "-//IBM//DTD DITA Element Reference//EN" "elementref_shell.dtd">

<elementref id="topicref" xml:lang="en-us">
<elementname>
<element>topicref</element>
</elementname>
<elementdesc>
<purpose>The &lt;<apiname>topicref</apiname>> element designates a topic (such
as a concept, task, or reference) as a link in a DITA map. A &lt;<apiname>topicref</apiname>>
can contain other&lt;<apiname>topicref</apiname>> elements, allowing you to
express navigation or table-of-contents hierarchies.
<p>
<indexterm
>topicref<indexterm>Map elements<indexterm>topicref</indexterm></indexterm></indexterm></p></purpose>
<containedby><xref href="map.xml" type="topic">map</xref>,  <xref href="topicref.xml" type="topic">topicref</xref></containedby>
<contains><xref href="topicref.xml" type="topic">topicref</xref> (0 or more) </contains>
<attributes>
<attlist id="topicref_attr">
<attribute conref="commonLRdefs.xml#commonLRdefs/navtitle">
<attname></attname>
<attdesc></attdesc>
<atttype></atttype>
<attdefvalue></attdefvalue>
<attrequired></attrequired>
</attribute>
<attribute conref="commonLRdefs.xml#commonLRdefs/id">
<attname></attname>
<attdesc></attdesc>
<atttype></atttype>
<attdefvalue></attdefvalue>
<attrequired></attrequired>
</attribute>
<attribute conref="commonLRdefs.xml#commonLRdefs/href">
<attname></attname>
<attdesc></attdesc>
<atttype></atttype>
<attdefvalue></attdefvalue>
<attrequired></attrequired>
</attribute>
<attribute conref="commonLRdefs.xml#commonLRdefs/type">
<attname></attname>
<attdesc></attdesc>
<atttype></atttype>
<attdefvalue></attdefvalue>
<attrequired></attrequired>
</attribute>
<attribute conref="commonLRdefs.xml#commonLRdefs/class">
<attname></attname>
<attdesc></attdesc>
<atttype></atttype>
<attdefvalue></attdefvalue>
<attrequired></attrequired>
</attribute>
</attlist>
</attributes>
<examples>In this example, there are six topicrefs. They are nested and have
a hierarchical relationship. Bats.xml is the parent topic and the other topics
are its children.<codeblock>&lt;map title="Bats" Bats
 &lt;topicref href="bats.xml" type="topic">
  &lt;topicref href="batcaring.xml" type="task">&lt;/topicref>
  &lt;topicref href="batfeeding.xml" type="task">&lt;/topicref>
  &lt;topicref href="batsonar.xml" type="concept">&lt;/topicref>
  &lt;topicref href="batguano.xml" type="reference">&lt;/topicref>
  &lt;topicref href="bathistory.xml" type="reference">&lt;/topicref>
 &lt;/topicref>
&lt;/map></codeblock></examples></elementdesc>
</elementref>

