XML Schema attribute-element

XSD-element

Definition och användning

attribute-elementet definierar ett attribut.

Elementinformation

Antal förekomster Definieras en gång i schema-elementet. Citeras flera gånger i komplexa typer eller attributgrupper.
Föräldrelement attributeGroup、schema、complexType、restriction (simpleContent)、extension (simpleContent)、restriction (complexContent)、extension (complexContent)
Innehåll annotation、simpleType

Syntaks

<attribute
default=string
fixed=string
form=qualified|unqualified
id=ID
name=NCName
ref=QName
type=QName
use=optional|prohibited|required
alla attribut
>
(annotation?,(simpleType?))
</attribute>

（?-teckenet indikerar att detta element kan förekomma noll eller en gång i attribute-elementet。）

Attribut

default

Valfritt. Definition av attributets standardvärde. Default- och fixed-attributen får inte användas samtidigt.

fixed

Valfritt. Definition av attributets fastställda värde. Default- och fixed-attributen får inte användas samtidigt.

form

Valfritt. Definition av attributets format. Standardvärdet är värdet på attributeFormDefault-attributet i schema-elementet som innehåller attributet. Kan sättas till följande värden:

  • "qualified" - Angiver att detta attribut måste begränsas genom ett namnrymdsprefix och attributets namn utan kolon (NCName).
  • "unqualified" - Angiver att detta attribut inte behöver vara begränsat av ett namnrymdsprefix och inte behöver matcha attributets namn utan kolon (NCName), dvs. den lokala namnet.

id

Valfritt. Bestäm det unika ID för elementet.

namn

Valfritt. Bestäm attributets namn. name- och ref-attribut kan inte användas samtidigt.

ref

Valfritt. Bestäm referensen till det specifika attributet. name- och ref-attribut kan inte användas samtidigt. Om ref används, får inte simpleType-element, form och type visas.

typ

Valfritt. Bestäm den inbyggda datatypen eller den enkla typen. type-attributet kan endast visas när innehållet inte innehåller ett simpleType-element.

använd

Valfritt. Bestäm hur attributet ska användas. Följande värden kan ställas in:

  • Valfritt - Attribut är valfria och kan ha vilka värden som helst (standard).
  • Förbjuden - Attribut får inte användas.
  • Obligatorisk - Attribut är nödvändiga.

alla attribut

Valfritt. Bestäm vilka andra attribut som kan användas med non-schema-namnrymden.

Exempel

Exempel 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>

Ovanstående exempel indikerar att "code"-attributet har en begränsning. Endast de accepterade värdena är de två bokstäverna A till Z som är stora.

Exempel 2

För att använda en befintlig attributdefinition i en komplex typ, använd ref-attributet:

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

Exempel 3

Attribut kan ha både standardvärde och fastställt värde. Om inget annat värde anges tilldelas attributet automatiskt ett standardvärde. I följande exempel är standardvärdet "EN":

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

Om inget annat värde anges tilldelas attributet automatiskt ett fast värde. Men annorlunda än standardvärdet, om du anger ett annat värde än det fastställda värdet för attributet, kommer dokumentet att validera som ogiltigt. I följande exempel är det fastställda värdet "EN":

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

Exempel 4

Alla egenskaper är som standard valfria. Om du vill specificera att egenskapen är valfri, använd "use"-egenskapen:

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

Gör egenskapen obligatorisk:

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

XSD-element