19.2. anchor

L'élément <anchor> est utilisé pour l'intégration de la navigation à l'exécution. Il fournit un point d'intégration vers lequel une autre carte peut pointer afin d'insérer sa navigation dans l'arbre de navigation courant. Ceux qui sont familiarisés avec les systèmes d'aide Eclipse y reconnaîtront la même utilisation que l'élément <anchor> dans ce système. La gestion de cet élément n'est pas assurée pour tous les formats de sortie.

Pour une intégration lors de la construction, on peut utiliser l'attribut conref sur un élément au sein de la carte (par exemple, un <topicref>) pour amener du contenu d'un autre élément correspondant (par exemple, un autre <topicref>) d'une autre carte.

Exemple

Dans cet exemple, on définit une ancre d'identificateur "a1". Cet ancre peut être référencée par l'attribut anchorref sur un élément <map> d'une autre carte.

<map title="MyComponent tasks">
 <topicref navtitle="Start here" href="start.dita" toc="yes">
  <navref mapref="othermap2.ditamap"/>
  <navref mapref="othermap3.ditamap"/>
  <anchor id="a1" />
 </topicref>
</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/anchor

Attributs :

Nom Description Type de donnée Valeur par défaut Obligatoire ?
id Fournit un point d'intégration qu'une autre carte peut référencer afin d'insérer sa navigation dans l'arbre de navigation courant. L'attribut anchorref sur une carte peut être utilisé pour référencer cet attribut. NMTOKEN #REQUIRED oui
conref On utilise cet attribut pour référencer un identificateur sur un contenu réutilisable. Cf. la section 25.10.1. L'attribut conref pour des exemples et des détails à propos de la syntaxe. CDATA #IMPLIED non
%select-atts; (props, base, platform, product, audience, otherprops, importance, rev, status) Un ensemble d'attributs liés, décrit à la section 25.5. %select-atts; entité paramètre sans objet pour une entité paramètre sans objet
%localization-atts; (translate, xml:lang, dir) Un ensemble d'attributs liés, décrit à la section 25.6. %localization-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