17.1. imagemap

L'élément <imagemap> soutient la fonctionnalité de base du balisage d'image sensible HTML côté-client. L'élément <imagemap> permet de créer une zone ou une région dynamique sur une image, afin qu'un lien dans cette région puisse afficher un autre thème.

Une image sensible (image map) HTML côté-client lie une image à la structure de navigation — la « carte » (map) — au moyen d'une association d'identificateur de la carte à l'image. En contraste, la version DITA du balisage d'image sensible inclut simplement l'image cible comme premier élément obligatoire dans le balisage, suivi d'une séquence d'éléments <area> qui représentent les liens associés à l'image incluse.

Une structure <imagemap> peut être transformée soit en une image sensible HTML standard, soit en d'autres formes de navigation (telles que des images sensibles en tableau). En sortie PDF, la forme minimale consisterait à représenter l'image ; les processeurs de sortie PDF évolués devraient être capables de fournir des hyperliens de région équivalents.

Le contenu <xref> contient le texte de remplacement ou texte de survol voulus pour la zone de la carte.

Exemple

Une image sensible simple ressemble à ceci (notez que le rendu dépendra de la façon dont ce balisage est géré pour des formats de sortie particuliers) :

<imagemap>
 <image href="imagemapworld.jpg"></image>
 <area><shape>rect</shape><coords>2,0,53,59</coords>
  <xref href="d1-s1.xml">Section 1</xref>
 </area>
 <area><shape>rect</shape><coords>54,1,117,60</coords>
  <xref href="d1-s2.xml"></xref>
 </area>
 <area><shape>rect</shape><coords>54,62,114,116</coords>
  <xref href="#inline" type="topic"></xref>
 </area>
 <area><shape>circle</shape><coords>120,154,29</coords>
  <xref format="html" href="test.html"></xref>
 </area>
 <area><shape>poly</shape>
  <coords>246,39,200,35,173,52,177,86,215,90,245,84,254,65</coords>
  <xref format="pdf" href="test.pdf"></xref>
 </area>
</imagemap>

Les zones définies correspondent à l'image suivante, les zones sont visibles :

Carte du monde affichant cinq zones.

Les valeurs à utiliser dans les éléments <shape> et <coords> doivent suivre les directives définies pour les images sensibles dans la spécification HTML 4.1, section Images sensibles côté-client — Les éléments MAP et AREA.

Contient :

Doctype Modèle de contenu
ditabase, topic, task, reference, concept, glossary ( ( image) puis ( area) (un ou plus) )

Contenu par :

Doctype Parents
ditabase p, note, lq, li, itemgroup, dd, stentry, draft-comment, fn, entry, abstract, body, section, example, conbody, prereq, context, info, tutorialinfo, stepxmp, choice, choptionhd, chdeschd, choption, chdesc, stepresult, result, postreq, refsyn, proptypehd, propvaluehd, propdeschd, glossdef, pd
topic p, note, lq, li, itemgroup, dd, stentry, draft-comment, fn, entry, abstract, body, section, example, pd
task p, note, lq, li, itemgroup, dd, stentry, draft-comment, fn, entry, abstract, body, section, example, prereq, context, info, tutorialinfo, stepxmp, choice, choptionhd, chdeschd, choption, chdesc, stepresult, result, postreq, pd
concept p, note, lq, li, itemgroup, dd, stentry, draft-comment, fn, entry, abstract, body, section, example, conbody, pd
reference p, note, lq, li, itemgroup, dd, stentry, draft-comment, fn, entry, abstract, body, section, example, refsyn, proptypehd, propvaluehd, propdeschd, pd
glossary p, note, lq, li, itemgroup, dd, stentry, draft-comment, fn, entry, abstract, body, section, example, conbody, glossdef, pd

Héritage :

+ topic/fig ut-d/imagemap

Attributs :

Nom Description Type de donnée Valeur par défaut Obligatoire ?
spectitle L'attribut de titre spécialisé permet aux architectes de types spécialisés de définir un titre fixe ou par défaut pour un élément spécialisé. Non prévu pour une utilisation directe par les auteurs. CDATA #IMPLIED non
%display-atts; (scale, frame, expanse) Un ensemble d'attributs liés, décrit à la section 25.1. %display-atts; entité paramètre sans objet pour une entité paramètre sans objet
%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