XML Schema elementÉlément
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
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.)
| 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é.
|
| 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 | 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. |
| 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 :
|
| 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 :
|
| 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 :
<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" :
<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 :
<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>
Manuel de référence complet XML Schema Autres extensions