List Plugin

Overview

The list feature allows a user to either insert a list or convert one or more existing contiguous paragraphs to a list. Conversely, it allows a user to convert an existing list to a sequence of plain paragraphs. It also provides help documentation on working with lists.

Accessibility Requirement

Lists should convey iterative structures in the document. List items may be indented, but indentation levels should be consistent throughout a given list. Namely, the first item (or set of items) in a list may not be indented, whereas subsequent items may be, but only by one indentation level relative to the preceding list item.

User Interface Components

1. Menu Button

Appearance

• Label: List
• To the right of the label: a down arrow to indicate that the button displays a menu when activated

Behavior

When the menu button is activated it displays a menu

2. Menu

Menu items

• Numbered list
• Bulleted list
• Increase indentation
• Decrease indentation

• ---

• Remove format

• ---

• Help

Behavior

When the menu button is activated, the menu displays the items enumerated above, but only those that are valid in the current context (determined by cursor location) are enabled.

Example 1

User positions cursor on a blank line and then activates the List menu button. The menu displays all items listed above, but items Increase indentation and Decrease indentation are disabled, since there are no list items in the current context, and Remove format is also disabled, since the cursor context is a blank line, and not a list.

Example 2

User positions cursor on the first list item of a bulleted list and then activates the List menu button. The menu displays all items listed above, but the items Bulleted list, Increase indentation and Decrease indentation are disabled.

Task Descriptions

Task 1 — Insert list

User Actions

• Position cursor on a blank line within the document.
• Select List menu button: menu is displayed (see Menu — Behavior)
• Select desired list style from menu.

Result

An indented (at the top level) bullet or number is created, and the cursor is positioned at the beginning of the new list item.

Task 2 — Convert an existing text block to a list

User Actions

• Position cursor at the beginning or end of, or within, a block of text.
• Select List menu button: menu is displayed (see Menu — Behavior)
• Select desired list style from menu

Result

The block of text defined by the cursor location is converted to a list item of the selected style.

Task 3 — Convert a series of contiguous paragraphs to a list

Task 4 — Remove list format from existing list

User Actions

• Position cursor at the beginning or end of, or within, a list item.
• Select List menu button: menu is displayed (see Menu — Behavior)
• Select Remove format from menu

Result

The block of text defined by the cursor location is converted from a list item to a plain paragraph.

NOTE: Describe behavior as it acts upon a set of list items.

Task 5 — Get help on adding lists to a document

User Actions

• Select List menu button: menu is displayed
• Select Help from menu

Result

A dialog box is displayed that contains help documentation for the List feature.