XML Schema list Element

Definition and Usage

The list element defines a simple type element as a list of values of a specified data type.

Element Information

Parent elements: simpleType

Syntax

<list
id=ID
itemType=QName
any attributes
>

(annotation?,(simpleType?))

</list>

(The ? sign declares that the element can occur zero or one time inside the list element)

Attribute	Description
id	Optional. Specifies a unique ID for the element
itemType	Specifies the name of a built-in data type or simpleType element defined in this or another schema. This attribute is not allowed if the content contains a simpleType element, otherwise it is required
any attributes	Optional. Specifies any other attributes with non-schema namespace

Example 1

The following example shows a simple type that is a list of integers:

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

<xs:element name="intvalues" type="valuelist"/>

<xs:simpleType name="valuelist">
<xs:list itemType="xs:integer"/>
</xs:simpleType>

</xs:schema>

The "intvalues" element in a document could look like this (notice that
the list will have five list items):

<intvalues>100 34 56 -23 1567</intvalues>

Note: White space is treated as the list item separator!

Example 2

The following example shows a simple type that is a list of strings:

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

<xs:element name="stringvalues" type="valuelist"/>

<xs:simpleType name="valuelist">
<xs:list itemType="xs:string"/>
</xs:simpleType>

</xs:schema>

The "stringvalues" element in a document could look like this (notice
that the list will have four list items):

<stringvalues>I love XML Schema</stringvalues>

❮ Complete XML Schema Reference