XML Schema elementElemento


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

Definición y uso

El elemento element define un elemento.

Información del elemento

  • Elemento padre: schema, choice, all, sequence, group

Sintaxis

<element
id=ID
name=NCName
ref=QName
type=QName
substitutionGroup=QName
default=string
fixed=string
form=qualified|unqualified
maxOccurs=nonNegativeInteger|unbounded
minOccurs=nonNegativeInteger
nillable=true|false
abstract=true|false
block=(#all|list of (extension|restriction))
final=(#all|list of (extension|restriction))
any attributes
>

annotation?,(simpleType|complexType)?,(unique|key|keyref)*

</element>

(El signo ? declara que el elemento puede aparecer cero o una vez dentro del elemento element, el signo * declara que el elemento puede aparecer cero o más veces).

Opcional. Indica si se puede asignar un valor cero explícito al elemento. Esto se aplica al contenido del elemento y no es un atributo del elemento. El valor predeterminado es false.

Si nillable es true, permitirá que una instancia del elemento pueda establecer el atributo nil en true. El atributo nil se define como parte del espacio de nombres de XML Schema para instancias.

Atributos Descripción
id Opcional. Especifica una ID única para el elemento.
name Opcional. Especifica el nombre del elemento. Este atributo es obligatorio si el elemento padre es el elemento schema.
ref Opcional. Una referencia a otro elemento. El atributo ref puede contener un prefijo de espacio de nombres. Este atributo no se utiliza si el elemento padre es el elemento schema.
type Opcional. Especifica el nombre de un tipo de datos integrado, o el nombre de un elemento simpleType o complexType.
substitutionGroup Opcional. Especifica el nombre de un elemento que se puede utilizar para reemplazar este elemento. Este elemento debe tener el mismo tipo o un tipo derivado del tipo de elemento especificado. Este atributo no se puede utilizar si el elemento padre no es el elemento schema.
default Opcional. Especifica un valor predeterminado para el elemento (solo se utiliza cuando el contenido del elemento es un tipo simple o textOnly).
fixed Opcional. Especifica un valor fijo para el elemento (solo se utiliza cuando el contenido del elemento es un tipo simple o textOnly).
form

Opcional. La forma del elemento. El valor predeterminado es el valor del atributo elementFormDefault del elemento schema que contiene este atributo. El valor debe ser una de las siguientes cadenas: "qualified" o "unqualified".

Este atributo no se puede utilizar si el elemento padre es el elemento schema.

  • Si el valor es "unqualified", el elemento no necesita ser calificado con un prefijo de espacio de nombres.
  • Si el valor es "qualified", el elemento debe ser calificado con un prefijo de espacio de nombres.
maxOccurs

Opcional. Especifica el número máximo de veces que el elemento element puede aparecer en el elemento padre. El valor puede ser un entero mayor o igual que cero. Para no establecer ningún límite en el número máximo, utilice la cadena "unbounded". El valor predeterminado es 1.

Este atributo no se puede utilizar si el elemento padre es el elemento schema.

minOccurs

Opcional. Especifica el número mínimo de veces que el elemento element puede aparecer en el elemento padre. El valor puede ser un entero mayor o igual que cero. El valor predeterminado es 1.

Este atributo no se puede utilizar si el elemento padre es el elemento schema.

nillable
abstract

Opcional. Indica si el elemento se puede utilizar en documentos de instancia. Si el valor es true, el elemento no puede aparecer en documentos de instancia. En su lugar, otro elemento cuyo atributo substitutionGroup contenga el nombre calificado (QName) de este elemento debe aparecer en su lugar. Múltiples elementos pueden hacer referencia a este elemento en su atributo substitutionGroup. El valor predeterminado es false.

block

Opcional. El tipo de derivación. El atributo block evita que elementos con el tipo de derivación especificado se utilicen para reemplazar este elemento. El valor puede contener #all o una lista que sea un subconjunto de extension, restriction o substitution:

  • extension - Evita que los elementos derivados por extensión se utilicen para reemplazar este elemento.
  • restriction - Evita que los elementos derivados por restricción se utilicen para reemplazar este elemento.
  • substitution - Evita que los elementos derivados por sustitución se utilicen para reemplazar este elemento.
  • #all - Evita que todos los elementos derivados se utilicen para reemplazar este elemento.
final

Opcional. Establece el valor predeterminado del atributo final en los elementos element. Este atributo no se puede utilizar si el elemento padre no es el elemento schema. El valor puede contener #all o una lista que sea un subconjunto de extension o restriction:

  • extension - Evita que los elementos derivados por extensión se utilicen para reemplazar este elemento
  • restriction - Evita que los elementos derivados por restricción se utilicen para reemplazar este elemento
  • #all - Evita que todos los elementos derivados se utilicen para reemplazar este elemento
any attributes

Opcional. Especifica cualquier otro atributo con un espacio de nombres que no sea de schema.

Ejemplo 1

El siguiente ejemplo es un schema con cuatro elementos simples: "fname", "lname", "age" y "dateborn", de tipos string, nonNegativeInteger y date:

<?xml version="1.0"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">

<xs:element name="fname" type="xs:string"/>
<xs:element name="lname" type="xs:string"/>
<xs:element name="age" type="xs:nonNegativeInteger"/>
<xs:element name="dateborn" type="xs:date"/>

</xs:schema>

Ejemplo 2

El siguiente ejemplo es un schema con un elemento "note" de tipo complejo. El elemento "note" contiene cuatro elementos simples: "to", "from", "heading" y "body":

<?xml version="1.0"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">

<xs:element name="note">
  <xs:complexType>
    <xs:sequence>
      <xs:element name="to" type="xs:string"/>
      <xs:element name="from" type="xs:string"/>
      <xs:element name="heading" type="xs:string"/>
      <xs:element name="body" type="xs:string"/>
    </xs:sequence>
  </xs:complexType>
</xs:element>

</xs:schema>

Ejemplo 3

Este ejemplo es el mismo que el ejemplo 2, pero en este caso elegimos usar el atributo ref para hacer referencia a los nombres de los elementos:

<?xml version="1.0"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">

<xs:element name="note">
  <xs:complexType>
    <xs:sequence>
    <xs:element ref="to"/>
    <xs:element ref="from"/>
    <xs:element ref="heading"/>
    <xs:element ref="body"/>
    </xs:sequence>
  </xs:complexType>
</xs:element>

<xs:element name="to" type="xs:string"/>
<xs:element name="from" type="xs:string"/>
<xs:element name="heading" type="xs:string"/>
<xs:element name="body" type="xs:string"/>

</xs:schema>


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