Saltar al contenido principal

element

El elemento element se utiliza para declarar un elemento específico en un documento XML.

En su versión básica permite definir elementos simples, pero también permite definir elementos complejos mediante la combinación de element con otros elementos XSD.

La información que permite definir es:

  • El nombre del elemento.
  • Su tipo de dato.
  • El valor por defecto.
  • Si tiene un valor fijo y cuál es.

Supongamos un documento XML con el siguiente elemento:

<divisa>Euro</divisa>

El documento XSD que permite validar el código anterior es el siguiente:

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="divisa" type="xs:string" default="Euro" />
</xs:schema>
Documento XSD

Recordemos que todo XSD tiene como elemento raíz schema y que este elemento contiene todos los demás elementos XSD. En este caso, contiene un único elemento: element.

Los atributos que se pueden definir en element son:

AtributoDescripción
nameNombre del elemento en el documento XML.
typeTipo de dato permitido en <divisa>. En este caso se define string, es decir, cualquier cadena de caracteres. En otro apartado se verán todos los tipos de datos aceptados. De momento, se utilizará siempre string para los ejemplos.
defaultValor predeterminado del elemento.
fixedPermite asignar un valor fijo al contenido del elemento.

Otras opciones que podemos definir (haciendo uso de otros elementos XSD) son:

  • Si es obligatorio u opcional.
  • Su cardinalidad, es decir, si puede aparecer una o varias veces en el documento.
  • Restricciones adicionales en los valores del elemento. Por ejemplo, un rango de números válidos, un patrón de caracteres, etc.