<list>
Summary
Unnumbered list.
Use the <nlist> element for numbered lists.
Usage context
| Element category | block |
|---|---|
| PSML level | portable |
| Permitted content | <item> |
| Permitted parent | |
| HTML equivalent | <ul> |
| OpenXML equivalent |
Attributes
This element includes the following attributes:
| Name | Type | Required | Description |
|---|---|---|---|
| type | list-type | no | Label for list items |
| role | role | no | Custom 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.