XML Schema element要素


XML Schema 参考手册完全な XML Schema リファレンスマニュアル

定義と使い方

element 要素は要素を定義します。

要素情報

  • 親要素: schema, choice, all, sequence, group

構文

<element
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回以上出現できることを宣言します。)

任意。明示的なゼロ値をこの要素に割り当てられるかどうかを示します。これは要素の内容に適用され、この要素の属性ではありません。デフォルト値は false です。

nillable が true の場合、この要素のインスタンスは nil 属性を true に設定できます。nil 属性は、インスタンスの XML スキーマ名前空間の一部として定義されます。

属性 説明
id 任意。この要素の一意の ID を指定します。
name 任意。要素の名前を指定します。親要素が schema 要素の場合、この属性は必須です。
ref 任意。別の要素への参照。ref 属性には名前空間プレフィックスを含めることができます。親要素が schema 要素の場合、この属性は使用されません。
type 任意。組み込みデータ型の名前、または simpleType または complexType 要素の名前を指定します。
substitutionGroup 任意。この要素を置き換えるために使用できる要素の名前を指定します。その要素は、指定された要素タイプと同じタイプ、またはそこから派生したタイプを持つ必要があります。親要素が schema 要素でない場合、この属性は使用できません。
default 任意。要素にデフォルト値を指定します(要素の内容が単純型または textOnly の場合のみ使用)。
fixed 任意。要素に固定値を指定します(要素の内容が単純型または textOnly の場合のみ使用)。
form

任意。この要素の形式。デフォルト値は、この属性を含む schema 要素の elementFormDefault 属性の値です。この値は次のいずれかの文字列である必要があります:"qualified" または "unqualified"。

親要素が schema 要素の場合、この属性は使用できません。

  • この値が "unqualified" の場合、名前空間プレフィックスでこの要素を修飾する必要はありません。
  • この値が "qualified" の場合、名前空間プレフィックスでこの要素を修飾する必要があります。
maxOccurs

任意。element 要素が親要素内に出現できる最大回数を指定します。この値は0以上の整数にできます。最大回数に制限を設定したくない場合は、文字列 "unbounded" を使用してください。デフォルト値は 1 です。

親要素が schema 要素の場合、この属性は使用できません。

minOccurs

任意。element 要素が親要素内に出現できる最小回数を指定します。この値は0以上の整数にできます。デフォルト値は 1 です。

親要素が schema 要素の場合、この属性は使用できません。

nillable
abstract

任意。要素がインスタンスドキュメントで使用できるかどうかを示します。この値が true の場合、要素はインスタンスドキュメントに出現できません。代わりに、substitutionGroup 属性にこの要素の限定名 (QName) を含む他の要素が、この要素の位置に出現する必要があります。複数の要素がその substitutionGroup 属性でこの要素を参照できます。デフォルト値は false です。

block

任意。派生型。block 属性は、指定された派生型を持つ要素がこの要素の代わりに使用されるのを防ぎます。この値には #all または extension、restriction、substitution のサブセットであるリストを含めることができます:

  • extension - 拡張によって派生した要素がこの要素の代わりに使用されるのを防ぎます。
  • restriction - 制限によって派生した要素がこの要素の代わりに使用されるのを防ぎます。
  • substitution - 置換によって派生した要素がこの要素の代わりに使用されるのを防ぎます。
  • #all - すべての派生要素がこの要素の代わりに使用されるのを防ぎます。
final

任意。element 要素の final 属性のデフォルト値を設定します。親要素が schema 要素でない場合、この属性は使用できません。この値には #all または extension または restriction のサブセットであるリストを含めることができます:

  • extension - 拡張によって派生した要素がこの要素の代わりに使用されるのを防ぎます
  • restriction - 制限によって派生した要素がこの要素の代わりに使用されるのを防ぎます
  • #all - すべての派生要素がこの要素の代わりに使用されるのを防ぎます
any attributes

任意。non-schema 名前空間を持つその他の属性を指定します。

例 1

以下の例は、4つの単純な要素 "fname"、"lname"、"age"、"dateborn" を持つスキーマです。型は string、nonNegativeInteger、date です:

<?xml version="1.0"?>
<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" が含まれます:

<?xml version="1.0"?>
<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 属性を使用して要素名を参照することにしました:

<?xml version="1.0"?>
<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 参考手册完全な XML Schema リファレンスマニュアル その他の拡張