XML Schema element要素
完全な XML Schema リファレンスマニュアル
定義と使い方
element 要素は要素を定義します。
要素情報
- 親要素: schema, choice, all, sequence, group
構文
id=ID
name=NCName
ref=QName
type=QName
substitutionGroup=QName
default=string
fixed=string
form=qualified|unqualified
maxOccurs=nonNegativeInteger|unbounded
minOccurs=nonNegativeInteger
nillable=true|false
abstract=true|false
block=(#all|list of (extension|restriction))
final=(#all|list of (extension|restriction))
any attributes
>
annotation?,(simpleType|complexType)?,(unique|key|keyref)*
</element>
(? 記号は element 要素内で、その要素が0回または1回出現できることを宣言します。* 記号は要素が0回以上出現できることを宣言します。)
| 属性 | 説明 |
|---|---|
| id | 任意。この要素の一意の ID を指定します。 |
| name | 任意。要素の名前を指定します。親要素が schema 要素の場合、この属性は必須です。 |
| ref | 任意。別の要素への参照。ref 属性には名前空間プレフィックスを含めることができます。親要素が schema 要素の場合、この属性は使用されません。 |
| type | 任意。組み込みデータ型の名前、または simpleType または complexType 要素の名前を指定します。 |
| substitutionGroup | 任意。この要素を置き換えるために使用できる要素の名前を指定します。その要素は、指定された要素タイプと同じタイプ、またはそこから派生したタイプを持つ必要があります。親要素が schema 要素でない場合、この属性は使用できません。 |
| default | 任意。要素にデフォルト値を指定します(要素の内容が単純型または textOnly の場合のみ使用)。 |
| fixed | 任意。要素に固定値を指定します(要素の内容が単純型または textOnly の場合のみ使用)。 |
| form | 任意。この要素の形式。デフォルト値は、この属性を含む schema 要素の elementFormDefault 属性の値です。この値は次のいずれかの文字列である必要があります:"qualified" または "unqualified"。 親要素が schema 要素の場合、この属性は使用できません。
|
| maxOccurs | 任意。element 要素が親要素内に出現できる最大回数を指定します。この値は0以上の整数にできます。最大回数に制限を設定したくない場合は、文字列 "unbounded" を使用してください。デフォルト値は 1 です。 親要素が schema 要素の場合、この属性は使用できません。 |
| minOccurs | 任意。element 要素が親要素内に出現できる最小回数を指定します。この値は0以上の整数にできます。デフォルト値は 1 です。 親要素が schema 要素の場合、この属性は使用できません。 |
| nillable | 任意。明示的なゼロ値をこの要素に割り当てられるかどうかを示します。これは要素の内容に適用され、この要素の属性ではありません。デフォルト値は false です。 nillable が true の場合、この要素のインスタンスは nil 属性を true に設定できます。nil 属性は、インスタンスの XML スキーマ名前空間の一部として定義されます。 |
| abstract | 任意。要素がインスタンスドキュメントで使用できるかどうかを示します。この値が true の場合、要素はインスタンスドキュメントに出現できません。代わりに、substitutionGroup 属性にこの要素の限定名 (QName) を含む他の要素が、この要素の位置に出現する必要があります。複数の要素がその substitutionGroup 属性でこの要素を参照できます。デフォルト値は false です。 |
| block | 任意。派生型。block 属性は、指定された派生型を持つ要素がこの要素の代わりに使用されるのを防ぎます。この値には #all または extension、restriction、substitution のサブセットであるリストを含めることができます:
|
| final | 任意。element 要素の final 属性のデフォルト値を設定します。親要素が schema 要素でない場合、この属性は使用できません。この値には #all または extension または restriction のサブセットであるリストを含めることができます:
|
| any attributes | 任意。non-schema 名前空間を持つその他の属性を指定します。 |
例 1
以下の例は、4つの単純な要素 "fname"、"lname"、"age"、"dateborn" を持つスキーマです。型は string、nonNegativeInteger、date です:
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="fname" type="xs:string"/>
<xs:element name="lname" type="xs:string"/>
<xs:element name="age" type="xs:nonNegativeInteger"/>
<xs:element name="dateborn" type="xs:date"/>
</xs:schema>
例 2
以下の例は、複合型 "note" 要素を持つスキーマです。"note" 要素には4つの単純な要素 "to"、"from"、"heading"、"body" が含まれます:
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="note">
<xs:complexType>
<xs:sequence>
<xs:element name="to" type="xs:string"/>
<xs:element name="from" type="xs:string"/>
<xs:element name="heading" type="xs:string"/>
<xs:element name="body" type="xs:string"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
例 3
この例は例 2 と同じですが、この例では ref 属性を使用して要素名を参照することにしました:
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="note">
<xs:complexType>
<xs:sequence>
<xs:element ref="to"/>
<xs:element ref="from"/>
<xs:element ref="heading"/>
<xs:element ref="body"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="to" type="xs:string"/>
<xs:element name="from" type="xs:string"/>
<xs:element name="heading" type="xs:string"/>
<xs:element name="body" type="xs:string"/>
</xs:schema>
完全な XML Schema リファレンスマニュアル その他の拡張