Projects/Usability/HIG
Introduction
Human interface guidelines (HIG) are software development documents that offer application developers a set of recommendations. Their aim is to improve the experience for users by making application interfaces more consistent and hence more intuitive and learnable.
Learn more about the philosophy behind the KDE HIG
Structure
Behaviour
- Dialogs
- Accordion
- Tabs and Pages in Dialogs
- Toolbar
- Status bar
- Paging
Access functions
Grouping
- Use a Group box to arrange associated controls,
- Use a Projects/Usability/HIG/Panel for arrangement of controls without a caption.
- Allow users to resize aligned groups by placing Splitters between the groups.
Complex views
- Use a List View to show some items out of one category.
- Use a Tree View to show items with a single, natural, hierarchical categorization.
- Grids
- If you really need to create your own widget follow the guidelines for custom controls.
Editing and Manipulation
Selection
- Use radio buttons for 1 selection out of a few items.
- Use one or more check boxes for clear options or to select items out of a small number of options.
- Use a drop-down list for selection of 1 out of a small number of items.
- Use a combo box to select 1 out of a small number of items where users should be able to add items.
- Use a list view to select 1 singular item out of a potentially big list.
- Apply the dual list pattern for several selections out of a large number of (multiple) items.
Unconstrained input
- Provide a line edit to enter one line of text.
- Provide a text edit to enter multiple lines of texts.
- Consider to provide inline editing with complex views.
Constrained input
- Use a Spin Box for numerical input within a range and with fix steps.
- Use a Slider for arbitrary changes within a defined range.
- Apply the slider and spin box pattern for numeric input with both large changes and precise control.
- Use Date and Time Pickers for formatted input of datum, time of day, or periods etc.
User Assistance
User-driven information
- Provide tool-tips for user driven information.
System triggered notification
- Provide a message panel to inform users about non-critical problems.
- Use a notification as system-triggered message to acknowledge about events out of the current context.
- Show a progress indicator for lengthy actions.
Disruptive messages
- Show a modal message dialog if the processing has reached an unexpected condition that needs interaction.
Help system
- Support the user by an elaborated interface or per help system.
Presentation
Layout
- Resizing
- Default and minimal size
- Spacing
- Carefully place control according the KDE alignment style.
- Do not use color as primary method of communication.
- Icons
Style
Text
- Language localizations
- Static text
- Control Labels
- Wording
- Ellipsis
- Capitalization
- Contractions (don't, there's, etc.)
- Exclamation Points
See also:
Contributing
Didn't find what you were looking for?
A guide to the guide can be found at the about page.
Our Human Interface Guidelines are a work in progress and we need your help. Visit the Contributing page to report problems or get involved.
Index
B
C
D
E
F
K
L
M
R
S
T
W