XML Schema attributeÉlément
Manuel de référence complet XML Schema
Définition et utilisation
L'élément attribute définit un attribut.
Informations sur l'élément
- Élément(s) parent(s) : attributeGroup, schema, complexType, restriction (à la fois simpleContent et complexContent), extension (à la fois simpleContent et complexContent)
Syntaxe
default=string
fixed=string
form=qualified|unqualified
id=ID
name=NCName
ref=QName
type=QName
use=optional|prohibited|required
attributs quelconques
>
(annotation?,(simpleType?))
</attribute>
(Le signe ? déclare que l'élément peut apparaître zéro ou une fois au sein de l'élément attribute.)
| Attributes | Description |
|---|---|
| default | Facultatif. Spécifie la valeur par défaut de l'attribut. Les attributs default et fixed ne peuvent pas apparaître tous les deux. |
| fixed | Facultatif. Spécifie la valeur fixe de l'attribut. Les attributs default et fixed ne peuvent pas apparaître tous les deux. |
| forme | Facultatif. Spécifie le format de l'attribut. La valeur par défaut est la valeur de l'attribut attributeFormDefault de l'élément schema contenant l'attribut. Peut être défini sur les valeurs suivantes :
|
| id | Facultatif. Spécifie un ID unique pour l'élément. |
| name | Facultatif. Spécifie le nom de l'attribut. Les attributs name et ref ne peuvent pas apparaître tous les deux. |
| ref | Facultatif. Spécifie une référence à l'attribut spécifié. Les attributs name et ref ne peuvent pas apparaître tous les deux. Si ref apparaît, l'élément simpleType, form et type ne peuvent pas apparaître. |
| type | Facultatif. Spécifie un type de données intégré ou un type simple. L'attribut type ne peut apparaître que lorsque le contenu ne contient pas d'élément simpleType. |
| use | Facultatif. Spécifie comment l'attribut est utilisé. Peut prendre les valeurs suivantes :
|
| attributs quelconques | Facultatif. Spécifie tout autre attribut avec un espace de noms non-schema. |
Exemple 1
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="[A-Z][A-Z]"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
L'exemple ci-dessus indique que l'attribut "code" a une restriction. Les seules valeurs acceptables sont deux lettres majuscules de A à Z.
Exemple 2
Pour déclarer un attribut à l'aide d'une définition d'attribut existante dans un type complexe, utilisez l'attribut ref :
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="[A-Z][A-Z]"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:complexType name="someComplexType">
<xs:attribute ref="code"/>
</xs:complexType>
Exemple 3
Un attribut peut avoir soit une valeur par défaut, soit une valeur fixe spécifiée. Lorsqu'aucune autre valeur n'est spécifiée, la valeur par défaut est automatiquement attribuée à l'attribut. Dans l'exemple ci-dessous, la valeur par défaut est "EN" :
Lorsqu'aucune autre valeur n'est spécifiée, la valeur fixe est automatiquement attribuée à l'attribut. Toutefois, contrairement à la valeur par défaut, si vous spécifiez une valeur autre que la valeur fixe pour l'attribut, le document sera considéré comme invalide. Dans l'exemple ci-dessous, la valeur fixe est "EN" :
Exemple 4
Tous les attributs sont facultatifs par défaut. Pour spécifier explicitement qu'un attribut est facultatif, utilisez l'attribut "use" :
Rendre un attribut obligatoire :
Manuel de référence complet XML Schema Autres extensions