diff options
| author | Pedro Moreira da Silva <pedro@gitlab.com> | 2017-03-27 16:25:26 +0100 |
|---|---|---|
| committer | Pedro Moreira da Silva <pedro@gitlab.com> | 2017-03-27 16:25:26 +0100 |
| commit | 90c3981c1ae2ca434b923fac9a2f635505327c34 (patch) | |
| tree | bd67689d86205486361f728cacbc091be43356e8 /doc/development | |
| parent | a56f8fdd19a3455cb52150dd22632c006643564d (diff) | |
| download | gitlab-ce-90c3981c1ae2ca434b923fac9a2f635505327c34.tar.gz | |
Improve UX guide on tooltips
Diffstat (limited to 'doc/development')
| -rw-r--r-- | doc/development/ux_guide/components.md | 14 |
1 files changed, 12 insertions, 2 deletions
diff --git a/doc/development/ux_guide/components.md b/doc/development/ux_guide/components.md index 18d0647c798..ac7c1b6207d 100644 --- a/doc/development/ux_guide/components.md +++ b/doc/development/ux_guide/components.md @@ -19,14 +19,24 @@ --- ## Tooltips +Tooltips identify elements or provide additional, useful information about the referring elements. Tooltips are different from ALT-attributes, which are intended primarily for static images. Tooltips are summoned by: + +* Hovering over an element with a cursor +* Focusing on an element with a keyboard (usually the tab key) +* Upon touch ### Usage -A tooltip should only be added if additional information is required. +A tooltip should be used: +* When there isn’t enough space to show the information +* When it isn’t critical for the user to see the information +* For icons that don’t have a label + +Tooltips shouldn’t repeat information that is shown near the referring element. However, they can show the same data in a different format (e.g. date or timestamps).  ### Placement -By default, tooltips should be placed below the element that they refer to. However, if there is not enough space in the viewpoint, the tooltip should be moved to the side as needed. +By default, tooltips should be placed below the referring element. However, if there isn’t enough space in the viewport, the tooltip should be moved to the side as needed.  |