<dataRef>

<dataRef> identifies the datatype of an attribute value, either by referencing an item in an externally defined datatype library, or by pointing to a TEI-defined data specification [23.5.3.1 Datatypes]
組件 tagdocs — Documentation Elements
屬性
key⚓︎ the identifier used for this datatype specification
狀態 非必備的
資料類型 teidata.xmlName
name⚓︎ the name of a datatype in the list provided by XML Schema Part 2: Datatypes Second Edition
狀態 非必備的
資料類型 teidata.xmlName
ref⚓︎ a pointer to a datatype defined in some datatype library
狀態 非必備的
資料類型 teidata.pointer
restriction⚓︎ supplies a string representing a regular expression providing additional constraints on the strings used to represent values of this datatype
狀態 非必備的
資料類型 teidata.pattern
俱乐部会员
model.contentPart model.oddRef
可包含在於
tagdocs: alternate content datatype schemaSpec sequence specGrp
可包含
tagdocs: dataFacet
註

Only one of the attributes key, name, and ref may be used on any given instance of dataRef.

Neither a restriction attribute nor a dataFacet child element may be used unless the dataRef refers to a datatype from the specification XML Schema Part 2: Datatypes Second Edition with a name attribute.
例子
<schemaSpec ident="myTEI"
 source="http://www.tei-c.org/Vault/P5/current/xml/tei/odd/p5subset.xml">
<!-- ... -->
 <dataRef key="teidata.enumerated"/>
<!-- ... -->
</schemaSpec>
例子
<schemaSpec ident="myTEI"
 source="http://www.tei-c.org/Vault/P5/current/xml/tei/odd/p5subset.xml">
<!-- ... -->
 <dataRef name="float"/>
<!-- ... -->
</schemaSpec>
例子
<dataSpec ident="data.integerExample">
 <desc>datatype used for attributes taking an integer value between 0 and 99</desc>
 <content>
  <dataRef name="nonNegativeInteger"
   restriction="[0-9][0-9]?"/>
 </content>
</dataSpec>
Schematron

<sch:rule context="tei:dataRef[tei:dataFacet]">
<sch:assert test="@name" role="nonfatal">Data facets can only be specified for references to datatypes specified by
XML Schema Part 2: Datatypes Second Edition — that is, for there to be a 'dataFacet' child there must be a @name attribute.</sch:assert>
<sch:report test="@restriction"
 role="nonfatal">Data facets and restrictions cannot both be expressed on the same data reference — that is, the @restriction attribute cannot be used when a 'dataFacet' element is present.</sch:report>
</sch:rule>
Schematron

<sch:rule context="tei:dataRef[@restriction]">
<sch:assert test="@name" role="nonfatal">Restrictions can only be specified for references to datatypes specified by
XML Schema Part 2: Datatypes Second Edition — that is, for there to be a @restriction attribute there must be a @name attribute, too.</sch:assert>
</sch:rule>
Content model 
<content>
 <elementRef minOccurs="0"
  maxOccurs="unbounded" key="dataFacet"/>
</content>
宣告 
<rng:element name="dataRef">
 <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:choice>
  <rng:optional>
   <rng:attribute name="key">
    <rng:ref name="teidata.xmlName"/>
   </rng:attribute>
  </rng:optional>
  <rng:optional>
   <rng:attribute name="name">
    <rng:ref name="teidata.xmlName"/>
   </rng:attribute>
  </rng:optional>
  <rng:optional>
   <rng:attribute name="ref">
    <rng:ref name="teidata.pointer"/>
   </rng:attribute>
  </rng:optional>
 </rng:choice>
 <rng:optional>
  <rng:attribute name="restriction">
   <rng:ref name="teidata.pattern"/>
  </rng:attribute>
 </rng:optional>
 <rng:zeroOrMore>
  <rng:ref name="dataFacet"/>
 </rng:zeroOrMore>
</rng:element>
element dataRef
{
   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 key { teidata.xmlName }?
    | attribute name { teidata.xmlName }?
    | attribute ref { teidata.pointer }?
   ),
   attribute restriction { teidata.pattern }?,
   dataFacet*
}