XML Schema attributeЭлемент


XML Schema 参考手册Полное справочное руководство по XML Schema

Определение и использование

Элемент attribute определяет атрибут.

Информация об элементе

  • Родительские элементы: attributeGroup, schema, complexType, restriction (как simpleContent, так и complexContent), extension (как simpleContent и complexContent)

Синтаксис

<attribute
default=string
fixed=string
form=qualified|unqualified
id=ID
name=NCName
ref=QName
type=QName
use=optional|prohibited|required
любые атрибуты
>

(annotation?,(simpleType?))

</attribute>

(Знак ? означает, что элемент может встречаться ноль или один раз внутри элемента attribute.)

Атрибуты Описание
default Необязательно. Задает значение атрибута по умолчанию. Атрибуты default и fixed не могут присутствовать одновременно.
fixed Необязательно. Задает фиксированное значение атрибута. Атрибуты default и fixed не могут присутствовать одновременно.
форма

Необязательно. Задает формат атрибута. Значением по умолчанию является значение атрибута attributeFormDefault элемента schema, содержащего этот атрибут. Может принимать следующие значения:

  • "qualified" — указывает, что этот атрибут должен быть квалифицирован префиксом пространства имен и именем атрибута без двоеточия (NCName).
  • "unqualified" — указывает, что этот атрибут не нужно квалифицировать префиксом пространства имен и не нужно, чтобы он совпадал с именем атрибута без двоеточия (NCName), т. е. с локальным именем.
id Необязательно. Задает уникальный ID для элемента.
name Необязательно. Задает имя атрибута. Атрибуты name и ref не могут присутствовать одновременно.
ref Необязательно. Задает ссылку на указанный атрибут. Атрибуты name и ref не могут присутствовать одновременно. Если присутствует ref, элемент simpleType, form и type не могут присутствовать.
type Необязательно. Задаёт встроенный тип данных или простой тип. Атрибут type может появляться только тогда, когда содержимое не содержит элемент simpleType.
использовать

Необязательно. Указывает, как используется атрибут. Может принимать следующие значения:

  • optional — Атрибут необязателен и может иметь любое значение (по умолчанию).
  • prohibited — Атрибут не может использоваться.
  • required — Атрибут обязателен.
любые атрибуты Необязательно. Задаёт любой другой атрибут с пространством имён, не относящимся к схеме.

Пример 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"/>

Пример 4

По умолчанию все атрибуты необязательны. Чтобы явно указать атрибут как необязательный, используйте атрибут "use":

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

Как сделать атрибут обязательным:

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


XML Schema 参考手册Полное справочное руководство по XML Schema Другие расширения