7.21. image

Incluez un dessin ou des images dans un thème DITA en utilisant l'élément <image>. L'élément <image> a des attributs optionnels qui indiquent si le placement du graphique ou du dessin inclus devrait être dans la ligne (comme un bouton ou une icone) ou sur une ligne séparée pour une image plus grande. Il y a aussi des attributs optionnels qui indiquent la dimension à laquelle le graphique ou le dessin inclus devrait être redimensionnés. Un attribut href est obligatoire sur l'élément <image>, car cet attribut crée un pointeur vers l'image et permet au processeur de formatage en sortie de placer l'image dans le flux de texte. Pour rendre le sens de l'image plus accessible pour les utilisateurs de lecteurs d'écran ou de lecteurs en texte seul, incluez toujours une description du contenu de l'image dans l'élément <alt>.

Exemple

<image href="bike.gif" placement="break"><alt>Two-wheeled bicycle</alt></image>

Contient :

Doctype Modèle de contenu
ditabase, topic, task, reference, concept, glossary, map, bookmap ( alt) (optionnel)

Contenu par :

Doctype Parents
bookmap data, title, shortdesc, desc, p, note, lq, sli, li, itemgroup, dthd, ddhd, dt, dd, fig, ph, stentry, draft-comment, fn, xref, entry, booklibrary, mainbooktitle, booktitlealt, organizationname
map data, title, shortdesc, desc, p, note, lq, sli, li, itemgroup, dthd, ddhd, dt, dd, fig, ph, stentry, draft-comment, fn, xref, entry
ditabase data, title, shortdesc, desc, p, note, lq, sli, li, itemgroup, dthd, ddhd, dt, dd, fig, ph, stentry, draft-comment, fn, xref, entry, abstract, body, section, example, linkinfo, conbody, prereq, context, cmd, info, tutorialinfo, stepxmp, choice, choptionhd, chdeschd, choption, chdesc, stepresult, result, postreq, refsyn, proptypehd, propvaluehd, propdeschd, proptype, propvalue, propdesc, glossterm, glossdef, uicontrol, pt, pd, imagemap
topic data, title, shortdesc, desc, p, note, lq, sli, li, itemgroup, dthd, ddhd, dt, dd, fig, ph, stentry, draft-comment, fn, xref, entry, abstract, body, section, example, linkinfo, uicontrol, pt, pd, imagemap
task data, title, shortdesc, desc, p, note, lq, sli, li, itemgroup, dthd, ddhd, dt, dd, fig, ph, stentry, draft-comment, fn, xref, entry, abstract, body, section, example, linkinfo, prereq, context, cmd, info, tutorialinfo, stepxmp, choice, choptionhd, chdeschd, choption, chdesc, stepresult, result, postreq, uicontrol, pt, pd, imagemap
concept data, title, shortdesc, desc, p, note, lq, sli, li, itemgroup, dthd, ddhd, dt, dd, fig, ph, stentry, draft-comment, fn, xref, entry, abstract, body, section, example, linkinfo, conbody, uicontrol, pt, pd, imagemap
reference data, title, shortdesc, desc, p, note, lq, sli, li, itemgroup, dthd, ddhd, dt, dd, fig, ph, stentry, draft-comment, fn, xref, entry, abstract, body, section, example, linkinfo, refsyn, proptypehd, propvaluehd, propdeschd, proptype, propvalue, propdesc, uicontrol, pt, pd, imagemap
glossary data, title, shortdesc, desc, p, note, lq, sli, li, itemgroup, dthd, ddhd, dt, dd, fig, ph, stentry, draft-comment, fn, xref, entry, abstract, body, section, example, linkinfo, conbody, glossterm, glossdef, uicontrol, pt, pd, imagemap

Héritage :

- topic/image

Attributs :

Nom Description Type de donnée Valeur par défaut Obligatoire ?
href Le chemin relatif ou l'adresse URL de l'image. L'attribut href utilise une syntaxe URL conventionnelle pour pointer vers la ressource :
href="../images/construction.gif"
CDATA #IMPLIED oui
longdescref Une référence vers une description textuelle du graphique ou de l'objet. Cet attribut soutient la création de contenu accessible. Il utilise la syntaxe href standard. Cela peut être une référence à un autre thème DITA, ou à une description non-DITA. Pour des exemples sur la façon d'utiliser cet attribut en sortie, cf. ce sujet à propos des descriptions longues. CDATA #IMPLIED non
height Indique la dimension verticale d'affichage de l'image résultante. Si nécessaire, l'image est ajustée à la dimension spécifiée. La valeur de cet attribut est un nombre réel, suivi en option d'une unité de mesure prise dans l'ensemble suivant : pc, pt, px, in, cm, mm, em (pica, point, pixel, pouce, centimètre, millimètre et em respectivement). L'unité par défaut est le pixel (px). Exemples de valeurs possibles : "5", "5in" et "10.5cm". Si une valeur de hauteur est spécifiée et pas de valeur de largeur, la largeur sera redimensionnée du même facteur que la hauteur. Si une valeur de hauteur et une valeur de largeur sont spécifiées, certaines mises en œuvre qui sont incapables de redimensionnement dans les deux directions dans un facteur différent peuvent ignorer l'une des deux valeurs. NMTOKEN #IMPLIED non
width Indique la dimension horizontale d'affichage de l'image résultante. Si nécessaire, l'image est ajustée à la dimension spécifiée. La valeur de cet attribut est un nombre réel, suivi en option d'une unité de mesure prise dans l'ensemble suivant : pc, pt, px, in, cm, mm, em (pica, point, pixel, pouce, centimètre, millimètre et em respectivement). L'unité par défaut est le pixel (px). Exemples de valeurs possibles : "5", "5in" et "10.5cm". Si une valeur de largeur est spécifiée et pas de valeur de hauteur, la hauteur sera redimensionnée du même facteur que la largeur. Si une valeur de hauteur et une valeur de largeur sont spécifiées, certaines mises en œuvre qui sont incapables de redimensionnement dans les deux directions dans un facteur différent peuvent ignorer l'une des deux valeurs. NMTOKEN #IMPLIED non
align Contrôle l'alignement horizontal d'une image lorsque la valeur de l'attribut placement est "break". Les valeurs admissibles (validées par le processeur) sont : "left", "right", "center" et "current". CDATA #IMPLIED non
scale Spécifie un pourcentage selon lequel redimensionner l'image en absence d'une hauteur ou largeur d'image spécifiée. Une valeur de "100" implique une présentation de l'image à sa dimension intrinsèque. Si une valeur est défini pour l'attribut height ou width (ou les deux), l'attribut scale est ignoré. NMTOKEN dont l'espace de valeur est un entier non signé #IMPLIED non
placement Indique si une image devrait s'afficher dans le texte ou séparée du texte environnant. Le traitement par défaut est dans le texte ("inline"). Les valeurs admissibles sont : "inline" ou "break". Cf. la section 25.10.1.1. Utilisation de la valeur "-dita-use-conref-target" pour plus d'informations sur la valeur de l'attribut conref. (inline | break | -dita-use-conref-target) "inline" non
alt (à éviter) Texte de remplacement qui décrit l'image pour l'accessibilité dans les lecteurs de pages (page readers), ou fournit une description textuelle si le logiciel de l'utilisateur ne peut pas afficher l'image. L'attribut alt est déconseillé (deprecated) ; utilisez l'élément <alt> à la place. 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, keyref Attributs communs, décrit à la section 25.9. Autres attributs DITA communs