LI (List Item)

The LI tag defines a list item within a note list, ordered list, unordered list, or simple list.

Syntax


>>-<LI--+----------------+--+--------+-->--+-----------+-------->
        |        .-NO--. |  '-NOSKIP-'     '-item-text-'   
        '-SPACE=-+-YES-+-'                                 

>--+-------+---------------------------------------------------><
   '-</LI>-'

Parameters

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 enclosing list tag is used to set the indentation space for the 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.

NOSKIP

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

item-text

This is the text of the list item.

Comments

The LI tag defines a list item within a note list, ordered list, unordered list, or simple list.

The formatting of the LI tag is dependent on the type of list you use it within and the level of nesting.

List: Formatting
Note: Formats with a 3-space or 4-space indentation (depending on the SPACE attribute) and is preceded by sequential numbers.
Ordered: Formats with a 3-space or 4-space indentation (depending on the SPACE attribute) within the level of the list in which it is defined and is preceded by sequential numbers or letters.
Simple: Formats with a 3-space or 4-space indentation (depending on the SPACE attribute) within the level of the list it is defined within.
Unordered: Formats with a 3-space or 4-space indentation (depending on the SPACE attribute) within the level of the list in which it is defined and is preceded by bullets or dashes.

The next list item implicitly ends the previous list item as do the NOTEL, OL, SL, and UL end tags.

If you do not specify text for a list item, a blank line is displayed for that item.

Restrictions

You must code the LI tag within a NOTEL, OL, SL, or UL definition. See NOTEL (Note List), OL (Ordered List), SL (Simple List), and UL (Unordered List) for descriptions of these tags.

Processing

Table 1. The tags you can code within an LI definition
Tag	Reference	Usage	Required
ATTENTION	ATTENTION (Attention)	Single	No
CAUTION	CAUTION (Caution)	Single	No
DL	DL (Definition List)	Multiple	No
FIG	FIG (Figure)	Multiple	No
HP	HP (Highlighted Phrase)	Multiple	No
LINES	LINES (Lines)	Multiple	No
NOTE	NOTE (Note)	Multiple	No
NOTEL	NOTEL (Note List)	Multiple	No
NT	NT (Note)	Multiple	No
OL	OL (Ordered List)	Multiple	No
P	P (Paragraph)	Multiple	No
PARML	PARML (Parameter List)	Multiple	No
PS	PS (Point-and-Shoot)	Multiple	No
RP	RP (Reference Phrase)	Multiple	No
SL	SL (Simple List)	Multiple	No
UL	UL (Unordered List)	Multiple	No
WARNING	WARNING (Warning)	Single	No
XMP	XMP (Example)	Multiple	No

Examples

Here is help panel markup that contains an unordered list with three list items. The last list item contains an additional paragraph of text. Figure 1 shows the formatted result.

<!DOCTYPE DM SYSTEM>

<HELP NAME=li DEPTH=20>ShelfBrowse Help
<AREA>
<INFO>
  <P>When ShelfBrowse finds your book,
  it displays this information:
  <UL>
    <LI>Reference information about the book.
    <LI>The location of the book.
    <LI>If the book is in stock.
      <P>If the book is not in stock, see the librarian.
  </UL>
  <P>Thank you for using ShelfBrowse.
</INFO>
</AREA>
</HELP>

Figure 1. List items

                 ShelfBrowse Help

 When ShelfBrowse finds your book, it displays
 this information:

 o   Reference information about the book.

 o   The location of the book.

 o   If the book is in stock.

     If the book is not in stock, see the
     librarian.

 Thank you for using ShelfBrowse.


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