XML Schema attributeÉlément


XML Schema 参考手册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

<attribute
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 :

  • "qualified" - Indique que cet attribut doit être qualifié par un préfixe d'espace de noms et le nom sans deux-points (NCName) de l'attribut.
  • "unqualified" - Indique que cet attribut n'a pas besoin d'être qualifié par un préfixe d'espace de noms, et n'a pas besoin de correspondre au nom sans deux-points (NCName) de l'attribut, c'est-à-dire le nom local.
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 :

  • optional - L'attribut est facultatif et peut avoir n'importe quelle valeur (par défaut).
  • prohibited - L'attribut ne peut pas être utilisé.
  • required - L'attribut est requis.
attributs quelconques Facultatif. Spécifie tout autre attribut avec un espace de noms non-schema.

Exemple 1

<xs:attribute name="code">

<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:attribute name="code">
  <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" :

<xs:attribute name="lang" type="xs:string" default="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" :

<xs:attribute name="lang" type="xs:string" fixed="EN"/>

Exemple 4

Tous les attributs sont facultatifs par défaut. Pour spécifier explicitement qu'un attribut est facultatif, utilisez l'attribut "use" :

<xs:attribute name="lang" type="xs:string" use="optional"/>

Rendre un attribut obligatoire :

<xs:attribute name="lang" type="xs:string" use="required"/>


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