<param>

The <param> (parameter) element specifies a set of values that might be required by an <object> at runtime.

Usage information

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 HMTL <param> element, and the attribute semantics derive from their HTML definitions. For example, the @type attribute differs from the @type attribute on many other DITA elements.

Processing expectations

The @keyref attribute on <param> has the following expectations:
  1. When the key specified by @keyref is resolvable and has an associated URI, that URI is used as the value of this element (overriding @value, if that is specified).
  2. When the key specified by @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 a fallback.
  3. When the key specified by @keyref is not resolvable, the value of the @value attribute is used as a fallback target for the <param> element.

Content model

EMPTY

Empty

Attributes

The following attributes are available on this element: universal attributes and the attributes defined below.

@keyref
Specifies a key reference to the thing the parameter references.
@name (REQUIRED)
Specifies the name of the parameter.
@value
Specifies the value of a run-time parameter that is described by the @name attribute.

The following attributes are available on this element: universal attributes and the attributes defined below.

@keyref
Specifies a key reference to the thing the parameter references.
@name (REQUIRED)
Specifies the name of the parameter.
@value
Specifies the value of a run-time parameter that is described by the @name attribute.

Example

This section is non-normative.

See <object>.