when

首頁 | 內容
C 元素

<when>

<when> indicates a point in time either relative to other elements in the same timeline tag, or absolutely. 16.5.2 Placing Synchronous Events in Time

組件

linking — 16 Linking, Segmentation, and Alignment

屬性

absolute

supplies an absolute value for the time.

狀態	可應用時必備的
資料類型	<rng:ref name="data.temporal.w3c"/> data.temporal.w3c
值	Times may be given in standard form, as specified in the Encoding Declarations section of the header.
註	Required for the element designated as the value of the origin attribute in the timeline tag.

unit

specifies the unit of time in which the interval value is expressed, if this is not inherited from the parent <timeline>.

狀態	可應用時必備的
資料類型	<rng:ref name="data.enumerated"/> data.enumerated
被推薦的值包含:	d (days) h (hours) min (minutes) s (seconds) ms (milliseconds)

interval

specifies the numeric portion of a time interval

狀態	可應用時必備的
資料類型	<rng:choice> <rng:data type="float"> <rng:param name="minExclusive">0</rng:param> </rng:data> <rng:value>unknown</rng:value> </rng:choice> xsd:float { minExclusive = "0" } \| "unknown"
值	a positive number, or the special value unknown.
註	The value unknown indicates uncertainty about the interval.

since

identifies the reference point for determining the time of the current <when> element, which is obtained by adding the interval to the time of the reference point.

狀態	可應用時必備的
資料類型	<rng:ref name="data.pointer"/> data.pointer
值	Should point to another <when> element in the same <timeline>.
註	If this attribute is omitted, and the absolute attribute is not specified, then the reference point is understood to be the origin of the enclosing <timeline> tag.

屬於

timeline

可包含

空白元素

宣告


<rng:element name="when">
<rng:ref name="att.global.attributes"/>
<rng:optional>
 <rng:attribute name="absolute">
  <rng:ref name="data.temporal.w3c"/>
 </rng:attribute>
</rng:optional>
<rng:optional>
 <rng:attribute name="unit">
  <rng:choice>
   <rng:value>d</rng:value>
   <rng:value>h</rng:value>
   <rng:value>min</rng:value>
   <rng:value>s</rng:value>
   <rng:value>ms</rng:value>
   <rng:data type="Name"/>
  </rng:choice>
 </rng:attribute>
</rng:optional>
<rng:optional>
 <rng:attribute name="interval">
  <rng:choice>
   <rng:data type="float">
    <rng:param name="minExclusive">0</rng:param>
   </rng:data>
   <rng:value>unknown</rng:value>
  </rng:choice>
 </rng:attribute>
</rng:optional>
<rng:optional>
 <rng:attribute name="since">
  <rng:ref name="data.pointer"/>
 </rng:attribute>
</rng:optional>
<rng:empty/>
</rng:element>

element when
{
   att.global.attributes,
   attribute absolute { data.temporal.w3c }?,
   attribute unit { "d" | "h" | "min" | "s" | "ms" | xsd:Name }?,
   attribute interval { xsd:float { minExclusive = "0" } | "unknown" }?,
   attribute since { data.pointer }?,
   empty
}

例子

註

On this element, the global xml:id attribute must be supplied to specify an identifier for this point in time. The value used may be chosen freely provided that it is unique within the document and is a syntactically valid name. There is no requirement for values containing numbers to be in sequence.

P5: TEI指引

<when>