XML Schema 限定 / Facets

XSD 限定 / Facets

#限定（restriction）用於為 XML 元素或屬性定義可接受的值。對 XML 元素的限定稱為 facet。

對值的限定

下面的範例定義了帶有一個限定且名為 "age" 的元素。 age 的值不能低於 0 或高於 120：

<xs:element name="age">
<xs:simpleType>
#      <xs:restriction base="xs:integer">
       <xs:minInclusive value="0"/>
       <xs:maxInclusive value="120"/>
     </xs:restriction>
</xs:simpleType>
</xs:element>

對一組值的限定

如需把XML 元素的內容限制為一組可接受的值，我們要使用枚舉約束（enumeration constraint）。

下面的範例定義了帶有一個限定的名為 "car" 的元素。可接受的值只有：Audi, Golf, BMW：

<xs:element name="car">
<xs:simpleType>
#      <xs:restriction base="xs:string">
       <xs:enumeration value="Audi"/>
       <xs:enumeration value="Golf"/>
       <xs:enumeration value="BMW"/>
     </xs:restriction>
</xs:simpleType>
</xs:element>

上面的範例也可以寫為：

##<xs:element name ="car" type="carType"/>

<xs:simpleType name="carType">
   <xs:restriction base="xs:string">
     <xs:enumeration value="Audi"/>
     <xs:enumeration value="Golf"/>
     <xs:enumeration value="BMW"/>
   </xs:restriction>
</xs:simpleType>

注意： 在這種情況下，類型 "carType" 可被其他元素使用，因為它不是 "car" 元素的組成部分。

對一系列值的限定

如需把 XML 元素的內容限制定義為一系列可使用的數字或字母，我們要使用模式限制（pattern constraint）。

下面的範例定義了帶有一個限定的名為 "letter" 的元素。可接受的值只有小寫字母 a - z 其中的一個：

<xs:element name="letter">
<xs:simpleType>
#      <xs:restriction base="xs:string">
       <xs:pattern value="[a-z]"/>
     </xs:restriction>
</xs:simpleType>
</xs:element>

下一個範例定義了限定的名為 "initials" 的元素。可接受的值是大寫字母 A - Z 其中的三個：

<xs:element name="initials">
<xs:simpleType>
#      <xs:restriction base="xs:string">
       <xs:pattern value="[A-Z][A-Z][A-Z]"/>
     </xs:restriction>
</xs:simpleType>
</xs:element>

下一個例子也定義了限定的名為 "initials" 的元素。可接受的值是大寫或小寫字母 a - z 其中的三個：

<xs:element name="initials">
<xs:simpleType>
#      <xs:restriction base="xs:string">
       <xs:pattern value="[a-zA-Z][a-zA-Z][a-zA-Z]"/>
     </xs:restriction>
</xs:simpleType>
</xs:element>

下一個範例定義了限定的名稱為"choice 的元素。可接受的值是字母x , y 或z 中的一個：

<xs:element name="choice">
<xs:simpleType>
#      <xs:restriction base="xs:string">
       <xs:pattern value="[xyz]"/>
     </xs:restriction>
</xs:simpleType>
</xs:element>

下一個範例定義了帶有一個限定的名為 "prodid" 的元素。可接受的值是五個阿拉伯數字的一個序列，且每個數字的範圍是 0-9：

#<xs:element name="prodid">
<xs:simpleType>
#      <xs:restriction base="xs:integer">
       <xs:pattern value="[0-9][0-9][0-9][0-9][0-9]"/>
     </xs:restriction>
</xs:simpleType>
</xs:element>

對一系列值的其他限定

下面的範例定義了帶有一個限定的名為"letter" 的元素。可接受的值是 a - z 中零個或多個字母：

<xs:element name="letter">
<xs:simpleType>
#      <xs:restriction base="xs:string">
       <xs:pattern value="([a-z])*"/>
     </xs:restriction>
</xs:simpleType>
</xs:element>

下面的範例定義了限定的名為 "letter" 的元素。可接受的值是一對或多對字母，每對字母由一個小寫字母後面跟著一個大寫字母組成。舉個例子，"sToP"將會通過這種模式的驗證，但是"Stop"、"STOP" 或"stop" 無法通過驗證：

<xs:element name="letter ">
<xs:simpleType>
#      <xs:restriction base="xs:string">
       <xs:pattern value="([a-z][A-Z])+"/>
     </xs:restriction>
</xs:simpleType>
</xs:element>

下面的範例定義了限定的名為 "gender" 的元素。可接受的值是 male 或 female：

<xs:element name="gender">
<xs:simpleType>
#      <xs:restriction base="xs:string">
       <xs:pattern value="male|female"/>
     </xs:restriction>
</xs:simpleType>
</xs:element>

下面的範例定義了帶有一個限定的名為 "password" 的元素。可接受的值是由8 個字符組成的一行字符，這些字符必須是大寫或小寫字母a - z 亦或數字0 - 9：

<xs:element name="password ">
<xs:simpleType>
#      <xs:restriction base="xs:string">
       <xs:pattern value="[a-zA-Z0-9]{8}"/>
     </xs:restriction>
</xs:simpleType>
</xs:element>

空白字元的限定

如需規定空白字元（ whitespace characters）的處理方式，我們需要使用whiteSpace 限定。

下面的範例定義了帶有一個限定的名為 "address" 的元素。這個 whiteSpace 限定被設定為 "preserve"，這表示 XML 處理器不會移除任何空白字元：

<xs:element name="address">
<xs:simpleType>
#      <xs:restriction base="xs:string">
       <xs:whiteSpace value="preserve"/>
     </xs:restriction>
</xs:simpleType>
</xs:element>

這個範例也定義了限定的名為 "address" 的元素。這個whiteSpace 限定被設定為"replace"，這意味著XML 處理器將移除所有空白字元（換行、回車、空格以及製表符）：

<xs:element name ="address">
<xs:simpleType>
#      <xs:restriction base="xs:string">
       <xs:whiteSpace value="replace"/>
     </xs:restriction>
</xs:simpleType>
</xs:element>

這個範例也定義了一個帶有一個限定的名為 "address" 的元素。這個whiteSpace 限定被設定為"collapse"，這表示XML 處理器將移除所有空白字元（換行、回車、空格以及製表符會被替換為空格，開頭和結尾的空格會被移除，而多個連續的空格會縮減為單一的空格）：

<xs:element name="address">
<xs:simpleType>
#      <xs:restriction base="xs:string">
       <xs:whiteSpace value="collapse"/>
     </xs:restriction>
</xs:simpleType>
</xs:element>

長度的限定

如需限制元素中值的長度，我們需要使用length、maxLength 以及minLength 限定。

本範例定義了帶有一個限定且名為 "password" 的元素。其值必須精確到 8 個字元：

<xs:element name="password">
<xs:simpleType>
#      <xs:restriction base="xs:string">
       <xs:length value="8"/>
     </xs:restriction>
</xs:simpleType>
</xs:element>

這個範例也定義了限定的名為 "password" 的元素。其值最小為 5 個字符，最大為 8 個字符：

<xs:element name="password">
<xs:simpleType>
#      <xs:restriction base="xs:string">
       <xs:minLength value="5"/>
       <xs:maxLength value="8"/>
     </xs:restriction>
</xs:simpleType>
</xs:element>

資料類型的限定

限定
#enumeration	定義可接受值的一個清單
fractionDigits	定義所允許的最大的小數位數。必須大於等於0。
length	定義所允許的字元或清單項目的精確數目。必須大於或等於0。
maxExclusive	定義數值的上限。所允許的值必須小於此值。
maxInclusive	定義數值的上限。所允許的值必須小於或等於此值。
maxLength	定義所允許的字元或是清單項目的最大數目。必須大於或等於0。
minExclusive	定義數值的下限。所允許的值必需大於此值。
minInclusive	定義數值的下限。所允許的值必需大於或等於此值。
minLength	定義所允許的字元或是清單項目的最小數目。必須大於或等於0。
pattern	定義可接受的字元的精確序列。
totalDigits	定義所允許的阿拉伯數字的精確位數。必須大於0。
whiteSpace	定義空白字元（換行、回車、空格以及製表符）的處理方式。

← XML Schema 屬性

XML Schema 複合元素 →