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 ».
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>
| 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) ) |
- topic/object
| 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 |
OASIS DITA Version 1.1 Language Specification — OASIS Standard, 1 August 2007
Copyright © OASIS Open 2005, 2007. All Rights Reserved.