z/OS ISPF Dialog Tag Language Guide and Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Unordered lists

z/OS ISPF Dialog Tag Language Guide and Reference
SC19-3620-00

Unordered lists are similar to simple lists, except each list item is preceded by symbol that is dependent on the nesting level of the list. You don't have to supply the symbols–the conversion utility does that for you.

Use an unordered list if the list items are long and you don't want to imply any particular sequence in the list.

Here is an unordered list:

Figure 1. Unordered list
                 Window Shopper

 With Window Shopper, you can order many
 wonderful things, such as:

 o   Raindrops on roses

 o   Whiskers on kittens

 o   Bright copper kettles

 o   Warm woolen mittens

 o   Brown paper packages tied up with string

 And many more of your favorite things!





 
Here is the markup for this unordered list:
<!doctype dm system>
<panel name=winshop width=48>Window Shopper
  <area>
    <info width=46>
      <p>With Window Shopper, you can order many wonderful things,
      such as:
      <ul>
        <li>Raindrops on roses
        <li>Whiskers on kittens
        <li>Bright copper kettles
        <li>Warm woolen mittens
        <li>Brown paper packages tied up with string
      </ul>
      <p>And many more of your favorite things!
    </info>
  </area>
</panel>

For our unordered list, we used the UL tag and its matching end tag. As you can see, even though we didn't code the bullet symbols (o) in the markup, they appear in front of each of the list items in the unordered list.

We could make this list compact like our simple list example because the COMPACT attribute is also valid for the UL tag. Likewise, we could use the SPACE attribute to control indentation of the list items for the UL tag.

You can also define levels of unordered lists; that is, you can nest unordered lists within other unordered lists. When you do this, the symbols preceding the list items in each level of the list vary, depending on the level of nesting. Specifically, the list items in the first (or only) level of unordered list are preceded by bullets (o), as shown in Figure 1. If you nest another unordered list within an unordered list,the list items in that list are preceded by hyphen symbols (-). A third-level unordered list has dashes (--) preceding the list items. The nested tag text is aligned according to the level of nesting.

To show how this works, we'll create a panel with three levels of unordered lists.
<!doctype dm system>
<panel name=ulists width=42>Nested Unordered Lists
  <area>
    <info width=40>
      <ul>
        <li>First level, first item
        <li>First level, second item
         <ul>
           <li>Second level, first item
           <li>Second level, second item
             <ul>
               <li>Third level, only item
             </ul>
         </ul>
        <li>Back to the first level
      </ul>
    </info>
  </area>
</panel>

Here is how this panel looks:

Figure 2. Nested unordered lists
          Nested Unordered Lists

 o   First level, first item

 o   First level, second item

     -   Second level, first item

     -   Second level, second item

         --  Third level, only item

 o   Back to the first level








 

If you nest more than three levels of unordered lists, the sequence of bullets, hyphens, and dashes repeats. For example, a fourth level would be preceded by bullets, a fifth level by hyphens, and so on.

Remember, all lists must be explicitly ended with the appropriate list end tag.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014