XML Schema attribute element

Return to XML Schema Reference Manual

Definition and Usage

Attribute element ya bayyana attribute.

Element Information

Occurrence Yana daidai kwananin kan schema element. An samar da manyan kwananin a cikin complex type ko group na attribute.
Parent Element attributeGroup、schema、complexType、restriction (simpleContent)、extension (simpleContent)、restriction (complexContent)、extension (complexContent)
Content annotation、simpleType

Yanar Grammar

<attribute
default=string
fixed=string
form=qualified|unqualified
id=ID
name=NCName
ref=QName
type=QName
use=optional|prohibited|required
ویژگی‌های هر
>
(annotation?,(simpleType?))
</attribute>

（? sunan ya bayyana cewa kwananin ya iya da kwananin ko kwananin kan elementin na attribute.）

Attribute

default

A dace. Yantaa kiyaciya na default. Kiyaciya na default da fixed yana iya samun kiyaciya dama.

fixed

A dace. Yantaa kiyaciya na halittu. Kiyaciya na default da fixed yana iya samun kiyaciya dama.

form

A dace. Yantaa farin ciki na属性. Kiyaciya ce na dukkanin schema elementin da ya ɗauki a cikin attributeFormDefault.

  • "qualified" - nuna ceceka taɗa ce a hukuma nasi ceeniyen da naɗin shi, wanda ya fi daidai da kiyayawa, kuma ya kamata a kira a cikin rubutu na bai tsammani (NCName).
  • "unqualified" - نشان می‌دهد که این ویژگی نیازی به پیشوند نام فضای نام ندارد و نیازی به تطابق نام بدون پیشوند (NCName)، یعنی نام محلی ندارد.

id

اختیاری. ID منحصر به فرد این عنصر را تعیین کنید.

نام

اختیاری. نام ویژگی را تعیین کنید. ویژگی‌های name و ref نمی‌توانند همزمان استفاده شوند.

ارجاع

اختیاری. ارجاع به ویژگی مشخص شده را تعیین کنید. ویژگی‌های name و ref نمی‌توانند همزمان استفاده شوند. اگر ref وجود دارد، element simpleType، form و type نمی‌توانند ظاهر شوند.

نوع

اختیاری. نوع داده داخلی یا نوع ساده را تعیین کنید. ویژگی type فقط در صورتی که محتوای simpleType وجود ندارد، ظاهر می‌شود.

استفاده

اختیاری. روش استفاده از این ویژگی را تعیین کنید. می‌توانید از ارزش‌های زیر استفاده کنید:

  • اختیاری - ویژگی‌ها قابل انتخاب هستند و می‌توانند هر ارزشی داشته باشند (پیش‌فرض).
  • ممنوع - نمی‌توان از ویژگی استفاده کرد.
  • ضروری - ویژگی‌های ضروری.

ویژگی‌های هر

اختیاری. ویژگی‌های دیگری که با نام فضای نام non-schema دارند را تعیین کنید.

مثال

مثال 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>

مثال بالا نشان می‌دهد که ویژگی "code" یک محدودیت دارد. تنها ارزش‌های قابل پذیرش دو حرف اولیه بزرگ حروف الفبا A تا Z هستند.

مثال 2

برای استفاده از تعریف ویژگی موجود در نوع پیچیده برای تعریف یک ویژگی، از ویژگی 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>

مثال 3

ویژگی می‌تواند ارزش پیش‌فرض داشته باشد و همچنین می‌تواند ارزش ثابت تعیین شده‌ای داشته باشد. اگر هیچ ارزش دیگری به عنوان ارزش تعیین نشده باشد، به طور خودکار ارزش پیش‌فرض به ویژگی تخصیص داده می‌شود. در مثال زیر، ارزش پیش‌فرض "EN" است:

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

بغیر از هدایتی دیگری به عنوان ارزش تعیین نشده باشد، به طور خودکار به ویژگی ارزش ثابت تخصیص داده می‌شود. اما با ارزش پیش‌فرض متفاوت است، اگر شما برای ویژگی ارزش ثابت غیر از ارزش‌های دیگر تعیین کنید، مستند به عنوان غیرمجاز تأیید می‌شود. در مثال زیر، ارزش ثابت "EN" است:

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

Example 4

All attributes are optional by default. To explicitly specify an attribute as optional, use the "use" attribute:

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

Make the attribute mandatory:

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

Return to XML Schema Reference Manual