XML Schema elementÉlément


XML Schema 参考手册Manuel de référence complet XML Schema

Définition et utilisation

L'élément element définit un élément.

Informations sur l'élément

  • Élément parent : schema, choice, all, sequence, group

Syntaxe

<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|liste de (extension|restriction))
final=(#all|liste de (extension|restriction))
attributs quelconques
>

annotation?,(simpleType|complexType)?,(unique|key|keyref)*

</element>

(Le symbole ? indique que l'élément peut apparaître zéro ou une fois au sein de l'élément element ; le symbole * indique que l'élément peut apparaître zéro ou plusieurs fois.)

Facultatif. Indique si une valeur nil explicite peut être assignée à l'élément. Cela s'applique au contenu de l'élément et n'est pas un attribut de l'élément. La valeur par défaut est false.

Si nillable est true, cela permettra à une instance de cet élément de définir l'attribut nil sur true. L'attribut nil est défini comme faisant partie de l'espace de noms XML Schema pour les instances.

Attributes Description
id Facultatif. Spécifie un ID unique pour l'élément.
name Facultatif. Spécifie le nom de l'élément. Si l'élément parent est l'élément schema, cet attribut est requis.
ref Facultatif. Une référence à un autre élément. L'attribut ref peut contenir un préfixe d'espace de noms. Cet attribut n'est pas utilisé si l'élément parent est l'élément schema.
type Facultatif. Spécifie le nom d'un type de données intégré, ou le nom d'un élément simpleType ou complexType.
substitutionGroup Facultatif. Spécifie le nom d'un élément qui peut être utilisé pour remplacer cet élément. Cet élément doit avoir le même type ou un type dérivé du type d'élément spécifié. Cet attribut ne peut pas être utilisé si l'élément parent n'est pas l'élément schema.
default Facultatif. Spécifie une valeur par défaut pour l'élément (utilisé uniquement lorsque le contenu de l'élément est un type simple ou textOnly).
fixed Facultatif. Spécifie une valeur fixe pour l'élément (utilisé uniquement lorsque le contenu de l'élément est un type simple ou textOnly).
forme

Facultatif. La forme de l'élément. La valeur par défaut est la valeur de l'attribut elementFormDefault de l'élément schema contenant cet attribut. La valeur doit être l'une des chaînes suivantes : "qualified" ou "unqualified".

Si l'élément parent est l'élément schema, cet attribut ne peut pas être utilisé.

  • Si la valeur est "unqualified", l'élément n'a pas besoin d'être qualifié avec un préfixe d'espace de noms.
  • Si la valeur est "qualified", l'élément doit être qualifié avec un préfixe d'espace de noms.
maxOccurs

Facultatif. Spécifie le nombre maximal de fois où l'élément element peut apparaître dans l'élément parent. La valeur peut être un entier supérieur ou égal à zéro. Pour ne fixer aucune limite sur le nombre maximal, utilisez la chaîne "unbounded". La valeur par défaut est 1.

Si l'élément parent est l'élément schema, cet attribut ne peut pas être utilisé.

minOccurs

Facultatif. Spécifie le nombre minimal de fois où l'élément element peut apparaître dans l'élément parent. La valeur peut être un entier supérieur ou égal à zéro. La valeur par défaut est 1.

Si l'élément parent est l'élément schema, cet attribut ne peut pas être utilisé.

nillable
abstract

Facultatif. Indique si l'élément peut être utilisé dans un document d'instance. Si cette valeur est true, l'élément ne peut pas apparaître dans un document d'instance. À la place, un autre élément dont l'attribut substitutionGroup contient le nom qualifié (QName) de cet élément doit apparaître à sa place. Plusieurs éléments peuvent référencer cet élément dans leur attribut substitutionGroup. La valeur par défaut est false.

block

Facultatif. Types dérivés. L'attribut block empêche les éléments avec le type de dérivation spécifié d'être utilisés pour remplacer cet élément. La valeur peut contenir #all ou une liste qui est un sous-ensemble de extension, restriction ou substitution :

  • extension - empêche les éléments dérivés par extension d'être utilisés pour se substituer à cet élément.
  • restriction - empêche les éléments dérivés par restriction d'être utilisés pour se substituer à cet élément.
  • substitution - empêche les éléments dérivés par substitution d'être utilisés pour se substituer à cet élément.
  • #all - empêche tous les éléments dérivés d'être utilisés pour se substituer à cet élément.
final

Facultatif. Définit la valeur par défaut de l'attribut final sur l'élément element. Cet attribut ne peut pas être utilisé si l'élément parent n'est pas l'élément schema. La valeur peut contenir #all ou une liste qui est un sous-ensemble de extension ou de restriction :

  • extension - empêche les éléments dérivés par extension d'être utilisés pour se substituer à cet élément
  • restriction - empêche les éléments dérivés par restriction d'être utilisés pour se substituer à cet élément
  • #all - empêche tous les éléments dérivés d'être utilisés pour se substituer à cet élément
attributs quelconques

Facultatif. Spécifie tout autre attribut avec un espace de noms non-schéma.

Exemple 1

L'exemple suivant est un schéma contenant quatre éléments simples : "fname", "lname", "age" et "dateborn", avec les types string, nonNegativeInteger et 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>

Exemple 2

L'exemple suivant est un schéma avec un élément "note" de type complexe. L'élément "note" contient quatre éléments simples : "to", "from", "heading" et "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>

Exemple 3

Cet exemple est identique à l'exemple 2, mais dans ce cas, nous choisissons d'utiliser l'attribut ref pour référencer les noms des éléments :

<?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 参考手册Manuel de référence complet XML Schema Autres extensions