(→Subsection 1: Remove aspects which are already done by default.) |
(Moved TODO items to Contributing) |
||
| Line 3: | Line 3: | ||
== Purpose == | == Purpose == | ||
A list view is basically used to show some items. It offers orientation thereby and allows navigation without the need of other controls. Additionally, a list view may be used for single selection (users select one item from a list of mutually exclusive values) or multiple selection (selections in combination with the Shift key or Control key). However, because there is no common visual clue whether a list box’ mode is single or multiple and since other controls are more efficient for single selection, a list box should be used for single selection only. | A list view is basically used to show some items. It offers orientation thereby and allows navigation without the need of other controls. Additionally, a list view may be used for single selection (users select one item from a list of mutually exclusive values) or multiple selection (selections in combination with the Shift key or Control key). However, because there is no common visual clue whether a list box’ mode is single or multiple and since other controls are more efficient for single selection, a list box should be used for single selection only. | ||
| − | |||
== Guidelines == | == Guidelines == | ||
| − | |||
=== Subsection 1 === | === Subsection 1 === | ||
* Prefer a list view to show items that belong together and in case of sufficient space. | * Prefer a list view to show items that belong together and in case of sufficient space. | ||
| Line 19: | Line 17: | ||
=== Selection === | === Selection === | ||
| − | |||
* Use the list view for selection if it is easy for users to know which items are checked at any given time, for one or more of these reasons: | * Use the list view for selection if it is easy for users to know which items are checked at any given time, for one or more of these reasons: | ||
** There are no more than twice the number of options then are visible at a time | ** There are no more than twice the number of options then are visible at a time | ||
** The options are well-known (for example months of a year or days of a week) | ** The options are well-known (for example months of a year or days of a week) | ||
** Usually the selected options are close to each other in the list | ** Usually the selected options are close to each other in the list | ||
| − | |||
| − | |||
| − | |||
| − | |||
* Provide extended multiple selection with Shift+Click or Ctrl+Click to select groups of contiguous or non-adjacent values, respectively. | * Provide extended multiple selection with Shift+Click or Ctrl+Click to select groups of contiguous or non-adjacent values, respectively. | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
== Code snippets == | == Code snippets == | ||
A list view is basically used to show some items. It offers orientation thereby and allows navigation without the need of other controls. Additionally, a list view may be used for single selection (users select one item from a list of mutually exclusive values) or multiple selection (selections in combination with the Shift key or Control key). However, because there is no common visual clue whether a list box’ mode is single or multiple and since other controls are more efficient for single selection, a list box should be used for single selection only.
KDE TechBase 