<param>
The <param>
(parameter) element specifies a set of values that might be required by an <object>
at runtime.
Any number of <param>
elements might
appear in the content of an <object>
in any order, but must be placed at
the start of the content of the enclosing object. This element is comparable to the XHMTL
<param>
element, and its attributes' semantics derive from their HTML
definitions. For example, the @type
attribute differs from the
@type
attribute on many other DITA elements.
See appendix for information about this element in OASIS document type shells.
- topic/param
See object.
The following attributes are available on this element: Universal attribute group and the attributes defined below.
@name
(REQUIRED)@value
@name
attribute.
@valuetype
@value
attribute. Allowed values are: @value
attribute
is a URL that designates a resource where run-time values are stored. This allows
support tools to identify URLs that are given as parameters. @valuetype
is an
identifier that refers to an object declaration in the document. The identifier
must be the value of the ID attribute set for the declared object element. @type
@value
. Note that this differs from the @type
attribute on many other DITA elements.
@valuetype
is set to "ref", this attribute directly specifies
the content type of the resource designated by @value
.@type
is specified
and @keyref
is specified and resolvable, this attribute specifies
the content type of the resource designated by @keyref
.@type
is not
specified and @keyref
is specified and is resolvable, the
effective type value specified for the key that is named by the
@keyref
attribute is used as the value of the
@type
attribute.@keyref
@valuetype
is
specified but is not set to "ref", this attribute is ignored. When
@valuetype
is not specified and @keyref
is specified,
it implies a setting of valuetype="ref"
. When @keyref
is specified and the effective value of @valuetype
is "ref":@keyref
is resolvable and has an
associated URI, that URI is used as the value of this element (overriding
@value
, if that is specified).@keyref
is resolvable and has no
associated resource (only link text), the @keyref
attribute
is considered to be unresolvable for this element. If @value
is
specified, it is used as fallback.@keyref
is not resolvable, the value of
the @value
attribute is used as a fallback target for the
<param>
element.