simplelist

simplelist — An undecorated list of single words or short phrases.

Synopsis

simplelist ::=

Attributes

Common attributes and common linking attributes.

Additional attributes:

  • columns (integer)
  • type (enumeration) [default=“vert”]
    • “horiz”
    • “vert”
    • “inline”

Additional Constraints

  • If this element is the root element, it must have a version attribute.

Description

A simplelist is a list of words or phrases. It offers a convenient alternative to the other list elements for inline content.

Processing expectations

Ironically, the processing expectations of a simplelist are quite complex. The value of the type attribute determines if the list is presented inline, or in a row- or column-major table. In the table cases, the columns attribute determines the number of columns in the table.

Attributes

Common attributes and common linking attributes.

columns

Specifies the number of columns for horizontal or vertical presentation

type

Specifies the type of list presentation.

Enumerated values:
“horiz”

A tabular presentation in row-major order.

“vert”

A tabular presentation in column-major order.

“inline”

An inline presentation, usually a comma-delimited list.

Children

The following elements occur in simplelist: member.

Examples

<article xmlns='http://docbook.org/ns/docbook'>
<title>Example simplelist</title>

<para>Here is a <tag>SimpleList</tag>, rendered inline: 
<simplelist type='inline'>
<member>A</member>
<member>B</member>
<member>C</member>
<member>D</member>
<member>E</member>
<member>F</member>
<member>G</member>
</simplelist>
</para>

</article>

Here is a SimpleList, rendered inline: A, B, C, D, E, F, G

<article xmlns='http://docbook.org/ns/docbook'>
<title>Example simplelist</title>

<para>Here is the same <tag>SimpleList</tag> rendered horizontally with 
three columns:
<simplelist type='horiz' columns='3'>
<member>A</member>
<member>B</member>
<member>C</member>
<member>D</member>
<member>E</member>
<member>F</member>
<member>G</member>
</simplelist>
</para>

</article>

Here is the same SimpleList rendered horizontally with three columns:

ABC
DEF
G  

<article xmlns='http://docbook.org/ns/docbook'>
<title>Example simplelist</title>

<para>Finally, here is the list rendered vertically:
<simplelist type='vert' columns='3'>
<member>A</member>
<member>B</member>
<member>C</member>
<member>D</member>
<member>E</member>
<member>F</member>
<member>G</member>
</simplelist>
</para>

</article>

Finally, here is the list rendered vertically:

ADG
BE 
CF 

Last revised by Norman Walsh on (git hash: a5bf9d0f457b11f1d181c442e7789af392c4e1b6 9ea0f4c253876426b585b1ed5a3a381a983013c5)