19.3. navref

L'élément <navref> représente un pointeur vers une autre carte qui devrait être conservé comme lien transcluant plutôt que résolu. Les formats de sortie qui gèrent une telle liaison intègreront la cible lors de l'affichage de la carte appelante pour l'utilisateur final

Par exemple, si on convertit une carte au format du système d'aide Eclipse, on devrait convertir l'élément DITA <navref mapref="other.ditamap"/> vers l'élément Eclipse <link toc="other.xml"/>. Lorsqu'Eclipse charge la carte appelante, il remplacera cet élément <link> par le contenu du fichier other.xml, à condition que ce fichier soit disponible.

Notez que les formats de sortie ne gèreront pas tous une telle liaison. Pour inclure des cartes cibles directement sans dépendre du format de sortie, on peut référencer la carte en utilisant un élément <topicref> avec l'attribut format="ditamap". Par exemple, le balisage suivant représente une inclusion littérale de la carte other.ditamap (similaire à un attribut conref) :

<topicref href="other.ditamap" format="ditamap"/>

Exemple

Dans cet exemple, la carte intitulée « MyComponent tasks » référence les cartes othermap2.dita et othermap3.dita.

<map title="MyComponent tasks">
 <navref mapref="../com.ibm.xml.doc/othermap1.ditamap" />
 <navref mapref="../com.ibm.xml.doc/othermap2.ditamap" />
</map>

Contient :

Doctype	Modèle de contenu
map, bookmap	pas de contenu

Contenu par :

Doctype	Parents
bookmap, map	map, topicref, topichead, topicgroup

Héritage :

- map/navref

Attributs :

Nom	Description	Type de donnée	Valeur par défaut	Obligatoire ?
`mapref`	Spécifie l'adresse URL (le nom de fichier local, au moins) du fichier carte à référencer. Elle peut pointer vers une carte DITA, ou vers un fichier approprié au format de sortie (tel qu'un fichier TOC XML pour une sortie Eclipse).	CDATA	#IMPLIED	non
%univ-atts; (%select-atts;, %id-atts;, %localization-atts;)	Un ensemble d'attributs liés, décrit à la section 25.7. %univ-atts;	entité paramètre	sans objet pour une entité paramètre	sans objet
%global-atts; (`xtrf`, `xtrc`)	Un ensemble d'attributs liés, décrit à la section 25.2. %global-atts;	entité paramètre	sans objet pour une entité paramètre	sans objet
`class`, `outputclass`	Attributs communs, décrit à la section 25.9. Autres attributs DITA communs

Section parente 19. Éléments de carte

Section précédente 19.2. anchor

Section suivante 19.4. reltable

Retour au sommaire.