XML Schema attributeElemento


XML Schema 参考手册Manual de referencia completo de XML Schema

Definición y uso

El elemento attribute define un atributo.

Información del elemento

  • Elemento padre: attributeGroup, schema, complexType, restriction (both simpleContent and complexContent), extension (both simpleContent and complexContent)

Sintaxis

<attribute
default=string
fixed=string
form=qualified|unqualified
id=ID
name=NCName
ref=QName
type=QName
use=optional|prohibited|required
any attributes
>

(annotation?,(simpleType?))

</attribute>

(El símbolo ? declara que este elemento puede aparecer cero o una vez en el elemento attribute).

Atributos Descripción
default Opcional. Especifica el valor predeterminado del atributo. Los atributos default y fixed no pueden aparecer al mismo tiempo.
fixed Opcional. Especifica el valor fijo del atributo. Los atributos default y fixed no pueden aparecer al mismo tiempo.
form

Opcional. Especifica el formato del atributo. El valor predeterminado es el valor del atributo attributeFormDefault del elemento schema que contiene este atributo. Puede establecerse en los siguientes valores:

  • "qualified" - Indica que este atributo debe calificarse mediante el prefijo de espacio de nombres y el nombre sin dos puntos (NCName) del atributo.
  • "unqualified" - Indica que este atributo no necesita ser calificado por un prefijo de espacio de nombres ni coincidir con el nombre sin dos puntos (NCName), es decir, el nombre local.
id Opcional. Especifica el ID único de este elemento.
name Opcional. Especifica el nombre del atributo. Los atributos name y ref no pueden aparecer al mismo tiempo.
ref Opcional. Especifica una referencia a un atributo determinado. Los atributos name y ref no pueden aparecer al mismo tiempo. Si aparece ref, los elementos simpleType, form y type no pueden aparecer.
type Opcional. Especifica un tipo de datos integrado o un tipo simple. El atributo type solo puede aparecer cuando el contenido no incluye un elemento simpleType.
use

Opcional. Especifica cómo se utiliza este atributo. Pueden establecerse los siguientes valores:

  • optional - El atributo es opcional y puede tener cualquier valor (predeterminado).
  • prohibited - El atributo no puede utilizarse.
  • required - El atributo es obligatorio.
any attributes Opcional. Especifica cualquier otro atributo con un espacio de nombres que no sea de schema.

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

El ejemplo anterior indica que el atributo "code" tiene una restricción. Los únicos valores aceptables son dos letras de la A a la Z en mayúsculas.

Ejemplo 2

Para declarar un atributo utilizando una definición de atributo existente en un tipo complejo, use el atributo 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>

Ejemplo 3

Los atributos pueden tener un valor predeterminado o un valor fijo especificado. Cuando no se especifica ningún otro valor, el valor predeterminado se asigna automáticamente al atributo. En el siguiente ejemplo, el valor predeterminado es "EN":

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

Cuando no se especifica ningún otro valor, el valor fijo se asigna automáticamente al atributo. Sin embargo, a diferencia del valor predeterminado, si especifica un valor distinto del valor fijo para el atributo, el documento se validará como inválido. En el siguiente ejemplo, el valor fijo es "EN":

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

Ejemplo 4

Todos los atributos son opcionales por defecto. Para especificar explícitamente que un atributo es opcional, use el atributo "use":

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

Hacer que un atributo sea obligatorio:

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


XML Schema 参考手册Manual de referencia completo de XML Schema Otras extensiones