<param>

<param> provides a parameter for a model behaviour by supplying its name and an XPath expression identifying the location of its content. [22.5.4.5 Behaviours and their parameters]
組件 tagdocs — Documentation Elements
屬性
name⚓︎ a name for the parameter being supplied
狀態 必備的
資料類型 teidata.enumerated
被推薦的值包含:
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 break 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⚓︎ supplies an XPath expression which when evaluated provides the value for the parameter
狀態 必備的
資料類型 teidata.xpath
可包含在於
tagdocs: model
可包含 空白元素

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.

例子

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="defaultvalue="corr"/>
  <param name="alternatevalue="sic"/>
 </model>
</elementSpec>
例子
<elementSpec ident="graphicmode="change">
 <model behaviour="graphic">
  <param name="urlvalue="@url"/>
  <param name="widthvalue="@width"/>
  <param name="heightvalue="@height"/>
 </model>
</elementSpec>
Content model
<content>
 <empty/>
</content>
宣告
<rng:element name="param">
 <rng:ref name="att.global.attributes"/>
 <rng:ref name="att.global.rendition.attributes"/>
 <rng:ref name="att.global.linking.attributes"/>
 <rng:ref name="att.global.analytic.attributes"/>
 <rng:ref name="att.global.facs.attributes"/>
 <rng:ref name="att.global.change.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.rendition.attributes,
   att.global.linking.attributes,
   att.global.analytic.attributes,
   att.global.facs.attributes,
   att.global.change.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
}