XML Schema attribute-elementti
Määrittely ja käyttö
attribute-elementti määrittää ominaisuuden.
Elementtiinfo
| Esiintymiskerrat | Määritellään kerran schema-elementissä. Viitataan monesti monimutkaisissa tyyppielementteissä tai ominaisuusryhmissä. |
| Isäelementti | attributeGroup、schema、complexType、restriction (simpleContent)、extension (simpleContent)、restriction (complexContent)、extension (complexContent) |
| Sisältö | annotation、simpleType |
Syntaksi
<attribute default=string fixed=string form=qualified|unqualified id=ID name=NCName ref=QName type=QName use=optional|prohibited|required muita ominaisuuksia > (annotation?,(simpleType?)) </attribute>
（?-merkki ilmoittaa, että tämä elementti voi esiintyä attribute-elementissä nollan tai yhden kerran。）
Ominaisuus
default
Valinnainen. Määrittää ominaisuuden oletusarvon. default- ja fixed-ominaisuudet eivät voi olla samanaikaisia.
fixed
Valinnainen. Määrittää ominaisuuden kiinteän arvon. default- ja fixed-ominaisuudet eivät voi olla samanaikaisia.
form
Valinnainen. Määrittää ominaisuuden muodon. Oletusarvo on schema-elementin attributeFormDefault-ominaisuuden arvo, joka sisältää kyseisen ominaisuuden. Voit asettaa seuraavat arvot:
- "qualified" - Indikoi, että tämän ominaisuuden täytyy olla määritelty nimenaluseriviin (NCName) ja nimen puuttuessa (ei-koloninen nimi).
- "unqualified" - viittaa siihen, että tämä ominaisuus ei vaadi nimenkerroksen etuliitettä ja ei vaadi tämän ominaisuuden ilman etuliitettä olevaa nimeä (NCName), eli paikallista nimeä.
id
Valinnainen. Määritä elementin ainutlaatuinen ID.
nimi
Valinnainen. Määritä ominaisuuden nimi. name- ja ref-ominaisuudet eivät voi ilmetä samanaikaisesti.
viittaus
Valinnainen. Määritä määritellyn ominaisuuden viittaus. name- ja ref-ominaisuudet eivät voi ilmetä samanaikaisesti. Jos ref ilmestyy, simpleType-elementti, form ja type eivät voi ilmetä.
tyyppi
Valinnainen. Määritä sisäänrakennettu tietotyyppi tai yksinkertainen tyyppi. type-ominaisuus voi ilmetä vain, jos sisällössä ei ole simpleType-elementtiä.
käyttö
Valinnainen. Määritä, miten tätä ominaisuutta käytetään. Voit asettaa seuraavat arvot:
- optional - ominaisuus on valinnainen ja voi saada minkä tahansa arvon (oletus).
- prohibited - ominaisuutta ei voida käyttää.
- required - ominaisuuden pakollinen.
muita ominaisuuksia
Valinnainen. Määritä muiden non-schema-nimistön määrittelyjen ominaisuudet.
Esimerkki
Esimerkki 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>
Yllä oleva esimerkki viittaa siihen, että "code"-ominaisuudella on rajoitus. Ainoa hyväksyttävä arvo on kaksi isoa kirjainta A-Z väliltä.
Esimerkki 2
Jos haluat käyttää olemassa olevaa ominaisuuden määritelmää julistamaan ominaisuuden, käytä ref-ominaisuutta:
<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>
Esimerkki 3
Ominaisuus voi olla sekä oletusarvo että määritelty vakioarvo. Ilman muita arvoja määritettyä, ominaisuudelle annetaan automaattisesti oletusarvo. Esimerkissä alla oletusarvo on "EN":
<xs:attribute name="lang" type="xs:string" default="EN"/>
Ilman muita arvoja määritettyä, ominaisuudelle annetaan automaattisesti vakioarvo. Mutta eriarvoisesti oletusarvoon, jos määrität ominaisuudelle vakioarvon ulkopuolelle sijoitetun arvon, dokumentti varmistaa sen epävirheelliseksi. Esimerkissä alla vakioarvo on "EN":
<xs:attribute name="lang" type="xs:string" fixed="EN"/>
Esimerkki 4
Kaikki attribuutit ovat oletusarvoisesti valinnaisia. Jos haluat määrittää attribuutin valinnaiseksi selkeästi, käytä "use"-attribuuttia:
<xs:attribute name="lang" type="xs:string" use="optional"/>
Tee attribuutista pakollinen:
<xs:attribute name="lang" type="xs:string" use="required"/>
