This one is for Aron Stansvik
[Update 1, fixed typo about Quit and ellipsis]
[Update 2, clarified my decision about Report Bug and use of ellipsis with non-required input]
Discussion:
The Ellipsis (…) is used in a menu item or button label to tell the user they must provide information before completing their task. In a way, it tells the user they have a chance to customize their request before something happens. For example, File -> Print… includes an ellipsis because it allows the user to customize the request before actually printing. Other examples of this include dialogs which require user input before further action. The most common examples of this can be found in a typical application menu, such as File -> Open… , or File -> Save As…
Here are some examples of an ellipsis being used in different contexts:

(Example of a button with an ellipsis)

(Example of a menu with an ellipsis)

(Example of a context menu with an ellipsis)
For the most part, Gnome, KDE, Apple, and Microsoft all agree on the basic use of ellipsis that I have illustrated above. However.. that is where the similarity ends between the different environments. Figuring out where to use an ellipsis for other types of controls which may require user input is a little more difficult.
In the case of configuration dialogs such as Preferences, KDE and Apple both include ellipsis in the labels to these items whereas Gnome and Microsoft do not. Gnome and KDE do not document why they chose their respective styles in their guidelines. Apple explains that configuration dialogs are a place where users can set their own information and the absence of an ellipsis implies an immediate action. However, Microsoft’s position is that setting preferences in configuration dialogs are an activity in themselves, and opening a preference dialog is an action in itself. Even so, Microsoft is not very consistent in the way they adhere to this rule — their display of Properties does not include an ellipsis, but Options… does.
I tend to agree with parts of Microsoft’s decision (which is a bit sensitive, considering KDE currently sides with Apple). The labels used to describe configuration dialogs are often explicit in the type of activity that menu item provides. For the example of configuring Konqueror, the menu item Settings -> Configure Konqueror is an explicit action, and adding an ellipsis to an explicit action which already implies user input seems a bit redundant. This is still a bit sticky and completely dependent on the label, not necessarily what results in selecting that item.

(Example of Configure… menu items)
In the end, I beleive the ellipsis should be used to indicate to the user they can make changes, only if the label does not imply it first. For example, Choose Details does not need an ellipsis because it is an explicit action which implies user input. Another example, Details… does need an ellipsis to indicate the user can provide input because the label does not imply the user will be able to make modifications. Confirmation or alerts do not count as “user input”, so a confirmation before Quit does not mean Quit should include an ellipsis after it.
Now it is a matter of standardizing a set of menu items so we dont have both Choose Details and Details… in the environment. (Another example is using Properties only for non-editable information and Options… or Preferences… for editable information)
Ellipsis Guidelines:
An ellipsis is used to inform the user their input is necessary, or that they are able to provide their input, to complete an action. An ellipsis is not used when the label already implies action of user input, such as with the term “Configure”, or when after invoking the item does not result in the ability for the user to edit anything.
An ellipsis is used to inform the user their input is required in order to complete an activity.
An ellipsis is not used when the label implies and action and user input is not required to complete the activity. Configuration dialogs are a good example of this, the label already implies action and making changes is not necessary to complete an activity such as checking a setting.
An ellipsis is placed after a label on menu items (application or context menu) and buttons.
- Use an ellipsis for buttons or menu items which require user’s input before completing their action.
- For example, use an ellipsis for the following menu items:
- Find…
- Open…
- Options…
- Preferences…
- Print…
- Save As…
- Send…
- Do not use an ellipsis for items which result in actions or do not require user input.
- Do not use an ellipsis for an action which may require confirmation before it is completed.
- For example, do not use an ellipsis for items which call the following activities and dialogs:
- About
- Check Spelling
- Close or Quit
- Configure [something]
- Delete
- Help
- Print Preview
- Properties (non-editable information)
- Toolboxes
Working Example:
As an example, let us take a look at the Security option in the Konqueror menu (View -> Security…) and discuss it’s use of an ellipsis:

(Security option in Konqueror)

(Security dialog in Konqueror)
Right away, we can see that the use of an ellipsis in Security… is a pretty clear violation of our new guidelines. When invoking Security… from the menu, the user only gets information, they can not make changes in that dialog. This is similar to Properties only providing non-editable information (which therefore, should not have an ellipsis either). The menu item label Security… should be changed to Security.
Further discussion will lead us to the actual dialog. Its use of an ellipsis in the button for Cryptography Configuration… is correct in the sense that it refers to an object which can be edited by the user. Conversely, if the button label were Configure Cryptography, an ellipsis would not be needed because the action of configure is already implied.
Now for an edge case: Report Bug…
This one is a bit more tricky. If you compare it to the previous example, it would be easy to conclude this is similar to the Security… case and the ellipsis should be removed. However, if you notice at the top of the dialog, the user can select which part of the application the bug occurs before opening the bug wizard. At the same time, the label includes an action (Report), so maybe an ellipsis isn’t necessary after all? I think this is a very atypical case, and removing the ellipsis is recommended mostly because Report already implies action.
User input in this dialog is not required in order to complete a bug report, and that is why the ellipsis is not necessary
I don’t think case like this will show up very often, and if it does, be sure to run through the guidelines and these examples to help make your decision.
—
To think, I picked this one to do first because I thought it would be easy. It is interesting to see how much thought and debate could go in to a simple interface element such as an ellipsis. Now what would be great is someone familiar with docbook to help me put this stuff in to something more official than the OpenUsability development wiki and get it committed.
KDE4 HIG Request #2 should be around in a few days!
seele :: Dec.20.2006 ::
Design, General, KDE/Kubuntu ::
20 Comments »