Projects/Usability/HIG/Tooltip: Difference between revisions

From KDE TechBase
< Projects‎ | Usability‎ | HIG
No edit summary
(HIG moved to community)
 
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOTOC__
{{ Moved To Community | KDE_Visual_Design_Group/HIG/Tooltip }}
 
== Purpose ==
A ''tool-tip'' is a small pop-up window that labels the unlabeled control being pointed to, such as toolbar controls without caption or command buttons. Tool-tips may as well provide more descriptive text including formatting and icons. Tips are a form of progressive disclosure, eliminating the need always to have descriptive text on the screen. This time-delay mechanism makes tips very convenient, but it also reduces their discoverability. When tips are used consistently they support user’s expectation and foster predictability.
 
== Examples ==
 
== Guidelines ==
* Use tips to label unlabeled controls and to provide additional information.
* Don’t use tips for warnings.
* Keep tips brief, typically five words or less for tool-tips; whenever appropriate, provide keyboard short-cuts and default values.
* Format tool-tips to make their content easier to read and scan by grouping and aligning the content. The information should be:
** concise: large, unformatted blocks of text are difficult to read and overwhelming
** helpful: it shouldn't be obvious or just repeat what is already on the screen)
** supplemental: important information should be communicated using self-explanatory control labels or in-place supplemental text)
** (in discussion) <font color="blue">static: tips should not change from one instance to the next)</font>
* (in discussion) <font color="blue">If the control is disabled, add a short explanation about the reason to the tip. Do not add information beyond that.</font>
* Consider to add small info buttons for use tips with a touch screen.
(in discussion) <font color="blue">
* Do not use icons and formattings for tips of unlabeled controls.
* Use tool-tips with icons and formattings
** if tips describe comprehensive functions,
** when content is lengthy and formatting improves readability
** for tips that are implemented primarily for joy of use.
</font>
 
== Implementation ==
 
[http://qt-project.org/doc/qt-4.8/qtooltip.html QToolTip]

Latest revision as of 12:09, 4 August 2016

This page is now on the community wiki.