XML Schema attributeЭлемент
Полное справочное руководство по XML Schema
Определение и использование
Элемент attribute определяет атрибут.
Информация об элементе
- Родительские элементы: attributeGroup, schema, complexType, restriction (как simpleContent, так и complexContent), extension (как simpleContent и complexContent)
Синтаксис
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, содержащего этот атрибут. Может принимать следующие значения:
|
| id | Необязательно. Задает уникальный ID для элемента. |
| name | Необязательно. Задает имя атрибута. Атрибуты name и ref не могут присутствовать одновременно. |
| ref | Необязательно. Задает ссылку на указанный атрибут. Атрибуты name и ref не могут присутствовать одновременно. Если присутствует ref, элемент simpleType, form и type не могут присутствовать. |
| type | Необязательно. Задаёт встроенный тип данных или простой тип. Атрибут type может появляться только тогда, когда содержимое не содержит элемент simpleType. |
| использовать | Необязательно. Указывает, как используется атрибут. Может принимать следующие значения:
|
| любые атрибуты | Необязательно. Задаёт любой другой атрибут с пространством имён, не относящимся к схеме. |
Пример 1
<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: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":
Если не указано другое значение, атрибуту автоматически присваивается фиксированное значение. Однако, в отличие от значения по умолчанию, если вы укажете для атрибута значение, отличное от фиксированного, документ будет признан недействительным. В приведённом ниже примере фиксированное значение — "EN":
Пример 4
По умолчанию все атрибуты необязательны. Чтобы явно указать атрибут как необязательный, используйте атрибут "use":
Как сделать атрибут обязательным:
Полное справочное руководство по XML Schema Другие расширения