Skip to main content

<list>

Summary

Unnumbered list.

Use the <nlist> element for numbered lists.

Usage context

Element categoryblock
PSML levelportable
Permitted content<item> 
Permitted parent
HTML equivalent<ul> 
OpenXML equivalent

Attributes

This element includes the following attributes:

NameTypeRequiredDescription
typelist-typenoLabel for list items
rolerolenoCustom value that can be used for formatting

@type

The type of list defines the style of the bullet before each item.

@role

A role for the list which can be used for formatting.

Examples

Unstyled list

<list>
  <item>apples</item>
  <item>oranges</item>
​</list>

This would generally be transformed in HTML as:

<ul>
  <li>apples</li>
  <li>oranges</li>
</ul>

List with a predefined bullet style

<list type="square">
  <item>apples</item>
  <item>oranges</item>
​</list>

This would generally be transformed in HTML as:

<ul style="list-style-type: square">
  <li>apples</li>
  <li>oranges</li>
</ul>

List with a role

<list role="menu">
  <item>apples</item>
  <item>oranges</item>
​</list>

This would generally be transformed in HTML as:

<ul class="menu">
  <li>apples</li>
  <li>oranges</li>
</ul>

Schema

XML Schema

<xs:element name="list">
  <xs:complexType>
    <xs:sequence maxOccurs="unbounded">
      <xs:element ref="item"/>
    </xs:sequence>

    <xs:attribute name="type" use="optional">
      <xs:simpleType>
        <xs:restriction base="xs:string">
          <xs:enumeration value="none"/>
          <xs:enumeration value="disc"/>
          <xs:enumeration value="circle"/>
          <xs:enumeration value="square"/>
        </xs:restriction>
      </xs:simpleType>
    </xs:attribute>
    <xs:attribute name="role" type="role"/>
  </xs:complexType>
</xs:element>

Relax Schema

element list {
  attribute type { "none" | "disc" | "circle" | "square"},
  attribute role { role }?,
  element item+
}

Compatibility

This element was introduced in the first draft of PSML and is well-supported from PageSeeder 5.1.

Created on , last edited on