<object>
The DITA <object>
element corresponds to the
HTML <object>
element, and attribute semantics derive from their
HTML definitions. For example, the @type
attribute differs from the
@type
attribute on many other DITA elements.
The <object>
element enables authors to include animated images, applets,
plug-ins, ActiveX controls, video clips, and other multimedia objects in a
topic.
See appendix for information about this element in OASIS document type shells.
- topic/object
Output processors might need to modify data in order to enable compatible function across various browsers, so these examples are only representative:
<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>
<param>
elements<object id="E5123_026.mp4" width="300" height="300"> <param name="poster" keyref="E5123_026_poster" /> <param name="source" keyref="E5123_026_video" /> </object>
<map> <!-- ... --> <keydef keys="E5123_026_poster" href="../images/E5123_026_poster.png" type="video/mp4" /> <keydef keys="E5123_026_video" href="../media/E5123_026_poster.mp4" type="video/mp4" /> <!-- ... --> </map>
@data
value<object classidkeyref="video_classid" codebasekeyref="video_codebase" datakeyref="cutkey370" height="280" width="370" id="cutkey370"> <desc>A description of the task</desc> <param name="movie" keyref="cutkey370"/> <param name="quality" value="high"/> <param name="bgcolor" value="#FFFFFF"/> </object>
<map> <!-- ... --> <!-- NOTE: Using @scope="external" because the class ID is a URI that is not intended to be directly resolved. --> <keydef keys="video_classid" href="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" scope="external" /> <!-- NOTE: Using @scope="external" to avoid systems trying to download this file when they don't need to. --> <keydef keys="video_codebase" href="http://download.macromedia.com/pub/shockwave/cabs/ flash/swflash.cab#version=6,0,0,0" format="shockwave" scope="external" /> <!-- Using @scope="external" here because the referenced URL is not intended to be resolved in isolation but relative to the codebase URI. --> <keydef keys="cutkey370" href="cutkey370.swf" type="application/x-shockwave-flash" scope="external" /> <!-- ... --> </map>
The following attributes are available on this element: Universal attribute group, outputclass, and the attributes defined below.
@archive
@classid
and @data
attributes.
Preloading these resources usually results in faster loadtimes for objects.
The URIs in the list should be relative to the URI specified in the
@codebase
attribute.
@archivekeyrefs
@archive
. The value is a
space-separated list of key names. Each resolvable key reference is treated
as a URI as though it had been specified on the @archive
attribute. When specified, and at least one key name is resolvable, the
key-provided archive list is used. If @archive
is specified,
it is used as a fallback when no key names can be resolved to a URI.
@classid
@data
attribute which is specified relative to the value of the
@codebase
attribute.
@classidkeyref
@classid
. When specified, and the key is resolvable, the
key-provided class ID URI is used. If @classid
is specified,
it is used as a fallback when the key cannot be resolved to a URI.
@codebase
@classid
, @data
, and
@archive
attributes. If @codebase
is not
set, the default is the base URI of the current element.
@codebasekeyref
@codebase
. When specified, and the key is resolvable,
the key-provided code base URI is used. If @codebase
is
specified, it is used as a fallback if the key cannot be resolved to a URI.
If no URI results from processing @codebasekeyref
and
@codebase
is not specified, the default is the base URL
of the current element.
@data
@codebase
attribute. If this attribute is set, the
@type
attribute should also be set.
@datakeyref
@data
. When
specified and the key is resolvable, the key-provided URI is used. A key
that has no associated resource, only link text, is considered to be
unresolved for the purpose of the @datakeyref
attribute. If
@data
is specified, it is used as a fallback when the
key cannot be resolved to a resource.
@declare
@type
@data
or @datakeyref
attribute. This attribute should be set when the @data
attribute is set to avoid loading unsupported content types. Note that this
differs from the @type
attribute on many other DITA elements
(it specifies a MIME type rather than a content type). If @type
is not specified,
the effective type value for the key named by the
@datakeyref
attribute is used as the this
attribute's value.@standby
@height
@width
@usemap
@name
@tabindex
@longdescref
(DEPRECATED)
Return to main page.
dita-v1.3-csd01-part1-base Standards Track Work Product | Copyright © OASIS Open 2015. All Rights Reserved. | 30 June 2015 |