UL (Unordered List)

The UL tag defines an unordered list of items within an information region.

Syntax


>>-<UL--+---------+--+--------+--+----------------+------------->
        '-COMPACT-'  '-NOSKIP-'  |        .-NO--. |   
                                 '-SPACE=-+-YES-+-'   

>--+----------+--+----------------------+-->--</UL>------------><
   '-INDENT=n-'  '-TEXT=UL-heading-text-'

Parameters

COMPACT

This attribute causes the list to be formatted without a blank line between the list items.

NOSKIP

This attribute causes the list to format without creating a blank line before the first line of the list.

SPACE=NO | YES

The SPACE attribute controls the indentation space for the list item. When the SPACE attribute is not specified on the LI tag, the SPACE attribute from the UL tag is used to set the indentation space for the nested LI tag item-text.

When SPACE=YES, the indentation is set to 3 spaces. When SPACE=NO (or SPACE is not specified), the indentation is set to 4 spaces.

The SPACE attribute can be used to control the alignment of list items when the first word of some list items is a DBCS word preceded by a shift-out character and the first word of other list items is a SBCS word.

INDENT=n

This attribute specifies that the list be indented from the current left margin.

TEXT=UL-heading-text

This attribute causes the list to format with a heading line containing the UL-heading-text.

Comments

The UL tag defines an unordered list of items within an information region. Unordered lists format as indented lists, with the list item identifier at the left margin. Nested lists indent four spaces to the right of the left margin of the list that contains them.

Note: The SPACE attribute does not affect the indentation of nested lists.

The conversion utility adds a blank line before the first item in the list. There are three levels of item identifiers: bullets (o), hyphens (-), and dashes (--). Each level is used successively when you nest unordered lists.

Panels formatted with the DBCS option use an uppercase ‘O’ as the bullet character.

Use the LI tag to denote each list item. See LI (List Item) for more information on the LI tag.

Restrictions

The UL tag requires an end tag.
You must code the UL tag within an INFO definition. See INFO (Information Region) for a complete description of this tag.

Processing

Table 1. Tags you can code within a UL definition
Tag	Reference	Usage	Required
LI	LI (List Item)	Multiple	No
LP	LP (List Part)	Multiple	No

Examples

Here is help panel markup that contains two unordered lists. The second unordered list is nested within the second list item of the first unordered list. Figure 1 shows the formatted result.

<!DOCTYPE DM SYSTEM>

<HELP NAME=ul DEPTH=22>Help for Reference Section
<AREA>
<INFO>
  <P>Learn everything about anything,
  and more, in our Reference section.
  Our Reference section includes:
  <UL>
    <LI>Atlases
    <LI>Dictionaries
      <UL COMPACT>
        <LI>English
        <LI>Other languages
      </UL>
    <LI>Encyclopedias
    <LI>How-to books
    <LI>Magazines and periodicals
  </UL>
</INFO>
</AREA>
</HELP>

Figure 1. Unordered list

            Help for Reference Section

 Learn everything about anything, and more, in
 our Reference section. Our Reference section
 includes:

 o   Atlases

 o   Dictionaries

     -   English
     -   Other languages

 o   Encyclopedias

 o   How-to books

 o   Magazines and periodicals

  F1=Help         F3=Exit         F5=Exhelp
  F6=Keyshelp     F7=PrvTopic     F8=NxtTopic
 F10=PrvPage     F11=NxtPage     F12=Cancel