Lists in Pilot

Make lists using one of the list icons on the HTML editor’s toolbar.

Why List Structure Matters

A list is a great way to provide concise information that’s easy to skim and understand. When a screen reader encounters a list, it can announce the presence of a list and tell the user how many items are in the list. As with headings, you want to make real lists, not just groups of paragraphs that look like lists. Properly made lists will maintain their structure if you paste them into a Word document. Likewise, lists made properly in Word maintain their structure if you paste them into Pilot’s HTML editor.

General Tips for Using Lists

  1. When practical, precede a list with a heading that describes the list.
  2. Avoid nested lists when you can.
  3. If you must create lists within lists, try not to exceed three levels.
  4. As with all text, if you find yourself making an entire list item bold because it introduces a section of content, that block of text should probably be a heading, not a list item.

Ordered (Numbered) and Unordered (Bullet) Lists

Pilot’s HTML editor creates two kinds of lists. There’s a button on the toolbar for unordered lists, also known as bullet lists:

The unordered list button creates a list with bullets before each item.

The button to create ordered lists, also called numbered lists, is hidden in the menu that pops out when you click the arrow to the right of the unordered list button:

Two Ways to Make Lists in Pilot’s HTML Editor

  1. Type each list item on a separate line, creating a series of paragraphs.
  2. Highlight all the paragraphs and click one of the list icons on the toolbar.

Or…

  1. Click one of the list icons on the toolbar.
  2. Type the first list item.
  3. Press “Enter” or “Return” to start the next item.
  4. After the last item, press “Enter” twice to end the list and start a new paragraph.

You can use the indent icon to create sub-levels within a list.

Change a List’s Numbering Style to Letters, Roman Numerals, etc.

Suppose you want use Pilot’s HTML editor to change an ordered list from the default, which has numbers, to another scheme, such as letters. You can use an “Insert Attributes” feature on the HTML editor’s toolbar. Or you can bravely dive into the HTML and insert the attribute by hand. A third option would be to use an external editor to create you list, then paste the list into the page in Pilot.

Change a List Style with “Insert Attributes

  1. Make an ordered list using one of the methods above.
  2. Drag your cursor across two or three list items to highlight them.
  3. Click the downward-pointing arrow just to the left of the “Insert Quicklink” button and choose “Insert Attributes.”
  4. In the “Style” box in the “Attributes” window, type “list-style-type: upper-alpha” without the quotes and click “Create.”

Now you list’s numbers should be replaced by capital letters: A, B, C, etc. For other ordering schemes, such as lowercase letters and roman numerals, replace “upper-alpha” with a different value. See below.

Change a List Style by Editing the HTML

  1. Make an ordered list using one of the methods above.
  2. Click the “HTML Source Editor” icon in the lower right of editor’s window. It looks like a slash between a less-than sign and a greater-than sign: </>
  3. Find your list in the HTML, then find the ordered list tag at the beginning of the list. It looks like <ol>.
  4. Add a list style attribute to the tag so it looks like this: <ol style=”list-style-type: upper-alpha”>
  5. Click “Save.”

Other List Style Types

To Get This Insert This List Style Type Value
Numbers Beginning with 1 Default for ordered lists. You don’t need to insert anything
Uppercase Letters upper-alpha
Lowercase Letters lower-alpha
Uppercase Roman Numerals upper-roman
Lowercase Roman Numerals lower-roman