TEI: Guidelines for Electronic Text Encoding and Interchange

P5 Version 4.10.2. Last updated on 4th September 2025, revision bcfa98f42

<param>

<param> provides a parameter for a model behaviour by supplying its name and an XPath expression identifying the location of its content. [23.5.4.5 Behaviours and their parameters]
Module tagdocs — Documentation Elements
Attributes
name name⚓︎ a name for the parameter being supplied.
Status Required
Datatype teidata.enumerated
Suggested values include:
alternate
when used with behaviour alternate, a parameter of this name supplies one of the pair of possible values; for example the regularized form rather than the original form within a choice element.
default
when used with behaviour alternate, a parameter of this name supplies one of the pair of possible values; for example the original form rather than the regularized form within a choice element.
height
when used with behaviour graphic, a parameter of this name supplies a value for the height of the graphic e.g. ‘300px’, ‘50%’.
id
a parameter of this name should supply a unique identifier for the element being processed; as for example with the anchor behaviour
label
a parameter of this name should supply an expression to be used to label something, for example concat('Page ', @n) for a page beginning or @n for a footnote reference; typically used with the note or break behaviours
level
when used with the heading behaviour, a parameter of this name supplies a positive integer indicating the hierarchic level of a heading.
link
when used with the link behaviour, a parameter of this name should supply a URL to be used as the target of a link.
place
when used with the note behaviour, a parameter of this name should provide a string which describes the intended placement of some text; typical values include ‘margin’, ‘footnote’, ‘endnote’, ‘inline’, ‘bottom’
type
a parameter of this name can be used to categorize the specified behaviour in any way; for example the kind of break (when used with the break behaviour) or the kind of index to be generated (if used with the index behaviour) etc.
url
when used with behaviour graphic, a parameter of this name supplies a a URL indicating the graphic intended.
width
when used with behaviour graphic, a parameter of this name supplies a value for the width of the graphic e.g. ‘400px’, ‘70%’.
value value⚓︎ supplies an XPath expression which when evaluated provides the value for the parameter
Status Required
Datatype teidata.xpath
Contained by
tagdocs: model
May contain Empty element
Note

An implementation may require parameters other than those listed here, and is not required to follow this partial specification.

The names and datatypes of the expected parameters should be documented in the corresponding customization using a paramSpec element. Literal strings provided in an XPath expression should be quoted.

Example

In this example, which will be processed for a choice element which has both sic and corr child elements, the default parameter will provide the value of the child corr element, and the alternate parameter will provide that of the child sic elements. If neither param element was supplied, both elements would still be available to an application, but the application would need to distinguish them for itself.

<elementSpec ident="choice">
<model predicate="sic and corr"
behaviour="alternate">
<param name="default" value="corr"/>
<param name="alternate" value="sic"/>
</model>
</elementSpec>
Example
<elementSpec ident="graphic" mode="change">
<model behaviour="graphic">
<param name="url" value="@url"/>
<param name="width" value="@width"/>
<param name="height" value="@height"/>
</model>
</elementSpec>
Content model 
<content>
 <empty/>
</content>
Schema Declaration 
<rng:element name="param">
 <rng:ref name="att.global.attributes"/>
 <rng:ref name="att.global.analytic.attributes"/>
 <rng:ref name="att.global.change.attributes"/>
 <rng:ref name="att.global.facs.attributes"/>
 <rng:ref name="att.global.linking.attributes"/>
 <rng:ref name="att.global.rendition.attributes"/>
 <rng:ref name="att.global.responsibility.attributes"/>
 <rng:ref name="att.global.source.attributes"/>
 <rng:attribute name="name">
 <rng:choice>
  <rng:value>alternate</rng:value>
  <rng:value>default</rng:value>
  <rng:value>height</rng:value>
  <rng:value>id</rng:value>
  <rng:value>label</rng:value>
  <rng:value>level</rng:value>
  <rng:value>link</rng:value>
  <rng:value>place</rng:value>
  <rng:value>type</rng:value>
  <rng:value>url</rng:value>
  <rng:value>width</rng:value>
  <rng:ref name="teidata.enumerated"/>
 </rng:choice>
 </rng:attribute>
 <rng:attribute name="value">
 <rng:ref name="teidata.xpath"/>
 </rng:attribute>
 <rng:empty/>
</rng:element>
element param
{
 att.global.attributes,
 att.global.analytic.attributes,
 att.global.change.attributes,
 att.global.facs.attributes,
 att.global.linking.attributes,
 att.global.rendition.attributes,
 att.global.responsibility.attributes,
 att.global.source.attributes,
 attribute name
 {
 "alternate"
 | "default"
 | "height"
 | "id"
 | "label"
 | "level"
 | "link"
 | "place"
 | "type"
 | "url"
 | "width"
 | teidata.enumerated
 },
 attribute value { teidata.xpath },
 empty
}

[English] [Deutsch] [Español] [Italiano] [Français] [日本語] [한국어] [中文]


TEI Guidelines P5 Version 4.10.2. Last updated on 4th September 2025, revision bcfa98f42. This page generated on 2025年09月04日T16:27:03Z.

AltStyle によって変換されたページ (->オリジナル) /