7.23. object

L'élément <object> de DITA correspond à l'élément <object> de HTML.

L'élément <object> permet aux auteurs d'inclure des images animées, des applettes, des modules d'extension (plug-ins), des contrôles ActiveX, des clips vidéo et d'autres objets multimédias dans un thème pour un rendu après transformation vers HTML.

Pour gérer les animations et films Flash, la valeur "swflash.cab" est vérifiée dans l'attribut codebase. Cela permet à la balise <object> du HTML d'afficher des objets Flash dans le navigateur Internet Explorer. Afin que ceux-ci puissent aussi s'afficher dans des navigateurs tels que Netscape et Firefox, une balise <embed> est également ajoutée au HTML. Quoique la balise <embed> soit nécessaire pour afficher ces objets, elle est absente du jeu de balises « XHTML 1.0 Transitional ».

Exemple

Les processeurs de sortie devront peut-être modifier les données afin de permettre un fonctionnement compatible à travers les divers navigateurs, et ces exemples ne sont donc que représentatifs :

<p>Cutting the keys from the system unit:</p>
<object classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
 codebase="http://download.macromedia.com/pub/shockwave/cabs/
flash/swflash.cab#version=6,0,0,0"
 data="cutkey370.swf"
 type="application/x-shockwave-flash"
 height="280"
 width="370"
 id="cutkey370">
 <desc>A description of the task</desc>
 <param name="movie" value="cutkey370.swf"/>
 <param name="quality" value="high"/>
 <param name="bgcolor" value="#FFFFFF"/>
</object>
<p>What's EIM?</p>
<object classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
 codebase="http://download.macromedia.com/pub/shockwave/cabs/
flash/swflash.cab#version=6,0,0,0"
 data="eim.swf"
 height="400"
 width="500"
 id="eim">
 <desc>Some great, glorious info</desc>
 <param name="movie" value="eim.swf"/>
 <param name="quality" value="high"/>
 <param name="bgcolor" value="#FFFFFF"/>
 <param name="pluginspace"
 value="http://www.macromedia.com/go/getflashplayer"/>
</object>

Contient :

Doctype Modèle de contenu
ditabase, topic, task, reference, concept, glossary, map, bookmap ( ( desc) (optionnel) puis ( param) (un nombre quelconque) puis ( foreign ou unknown) (un nombre quelconque) )

Contenu par :

Doctype Parents
ditabase data, p, note, lq, li, itemgroup, dd, fig, 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 data, p, note, lq, li, itemgroup, dd, fig, stentry, draft-comment, fn, entry, abstract, body, section, example, pd
task data, p, note, lq, li, itemgroup, dd, fig, stentry, draft-comment, fn, entry, abstract, body, section, example, prereq, context, info, tutorialinfo, stepxmp, choice, choptionhd, chdeschd, choption, chdesc, stepresult, result, postreq, pd
concept data, p, note, lq, li, itemgroup, dd, fig, stentry, draft-comment, fn, entry, abstract, body, section, example, conbody, pd
reference data, p, note, lq, li, itemgroup, dd, fig, stentry, draft-comment, fn, entry, abstract, body, section, example, refsyn, proptypehd, propvaluehd, propdeschd, pd
map, bookmap data, p, note, lq, li, itemgroup, dd, fig, stentry, draft-comment, fn, entry

Héritage :

- topic/object

Attributs :

Nom Description Type de donnée Valeur par défaut Obligatoire ?
declare Lorsque cet attribut a la valeur "declare", la définition d'objet courante est seulement une déclaration. L'objet doit être instancié par une définition d'objet incorporée plus tard et appelant cette déclaration. "declare" #IMPLIED non
classid Contient une adresse URL qui indique l'emplacement de la mise en œuvre d'un objet. On peut l'utiliser avec l'attribut data qui est spécifié par rapport à la valeur de l'attribut codebase. CDATA #IMPLIED non
codebase Spécifie le chemin de base (une adresse URL) utilisé pour résoudre les valeurs URL données aux attributs classid, data et archive. Si l'attribut codebase n'est pas défini, la valeur par défaut est l'adresse URL du document courant. CDATA #IMPLIED non
data Contient une référence vers l'emplacement des données d'un objet. Si la valeur de cet attribut est une adresse URL, celle-ci est spécifiée relativement à la valeur de l'attribut codebase. Si cet attribut est défini, alors l'attribut type devrait l'être aussi. CDATA #IMPLIED non
type Indique le type de contenu des données spécifiées par l'attribut data. On devrait définir cet attribut si l'attribut data l'est afin d'éviter le chargement de types de contenu non gérés. Notez qu'il diffère de l'attribut type sur plusieurs autres éléments DITA. CDATA #IMPLIED (pas de type par défaut) non
codetype Indique le type de contenu des données spécifiées par l'attribut classid. On devrait définir cet attribut si l'attribut classid l'est afin d'éviter le chargement de types de contenu non gérés. Si la valeur de cet attribut n'est pas définie, la valeur par défaut est celle de l'attribut type. CDATA #IMPLIED non
archive Spécifie une liste d'adresses URL, séparées par des espaces, indiquant les ressources nécessitées par l'objet. Ces ressources peuvent comprendre celles désignées par les attributs classid et data. Le préchargement de ces ressources donne habituellement des temps de chargement plus brefs pour les objets. Les adresses URL dans la liste devraient être relatives à l'adresse URL spécifiée dans l'attribut codebase. CDATA #IMPLIED non
standby Contient un message à afficher pendant le chargement d'un objet. CDATA #IMPLIED non
height Indique la dimension verticale d'affichage de l'objet résultant. Si nécessaire, l'objet est ajusté à 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'objet résultant. Si nécessaire, l'objet est ajusté à 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
usemap Indique d'utiliser une image cliquable (image map) côté-client. Une image cliquable spécifie les régions géométriques actives d'un objet inclus et affecte un lien à chaque région. Lorsqu'un lien est sélectionné, un document sera récupéré ou un programme sera lancé sur le serveur. CDATA #IMPLIED non
name Définit un nom unique pour l'objet. CDATA #IMPLIED non
tabindex Positionne l'objet dans l'ordre de tabulation (tabbing order). NMTOKEN #IMPLIED non
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
%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