12 <concept id="GUID-1B64E1D9-33AB-4C28-A471-22D4C51FEC43" xml:lang="en"><title>Tooltips</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
12 <concept id="GUID-1B64E1D9-33AB-4C28-A471-22D4C51FEC43" xml:lang="en"><title>Tooltips</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
13 <p>Tooltip is used for providing brief hint about an item, to explain the |
13 <p>Tooltip is used for providing brief hint about an item, to explain the |
14 user’s tasks for the item selected by the user.</p> |
14 user’s tasks for the item selected by the user.</p> |
15 <p>An <xref href="GUID-8EAF5A96-EB48-4A58-82D7-0583A22A51D0.dita">information pop-up</xref> is |
15 <p>An <xref href="GUID-8EAF5A96-EB48-4A58-82D7-0583A22A51D0.dita">information pop-up</xref> is |
16 used to display the tooltip.</p> |
16 used to display the tooltip.</p> |
|
17 <p>Information pop-up notes are used to provide additional information to |
|
18 the user, most typically regarding a focused item. Although the Information |
|
19 pop-up can be used in various applications and components, it should not be |
|
20 used too frequently as constantly appearing and disappearing notes may disturb |
|
21 smooth user experience.</p> |
|
22 <p>The Information pop-up does not have focus, its content cannot be scrolled, |
|
23 and the control always remains in the main pane. The maximum number of rows |
|
24 in the Information pop-up is four. In a typical case, the pop-up emerges one |
|
25 second after the user has taken the focus on an item but has not made any |
|
26 further actions. The pop-up is timed so that it (typically) remains visible |
|
27 for ten seconds or until some event interrupts it. Time-outs are application-specific |
|
28 and variation is possible.</p> |
|
29 <p>The API to use for the information pop-up is the <xref format="html" href="specs/guides/Information_Preview_Popup_API_Specification/Information_Preview_Popup_API_Specification.html" scope="peer">Info pop-up API</xref>.</p> |
|
30 <fig id="GUID-F7BBCA95-5754-44C1-9CCF-3A5B837E98B5"> |
|
31 <title>Example of tooltip</title> |
|
32 <image href="GUID-1D399C05-6CC0-4781-A6E1-1C94CFF8995B_d0e63101_href.png" placement="inline"/> |
|
33 </fig> |
17 <p><b>Design recommendation</b>: Tooltips must not be used for items that |
34 <p><b>Design recommendation</b>: Tooltips must not be used for items that |
18 might open a stylus pop-up menu with touch down and hold. </p> |
35 might open a stylus pop-up menu with touch down and hold. </p> |
19 <p><note>It is an application's responsibility to design all required texts |
36 <p><note>It is an application's responsibility to design all required texts |
20 for their tooltips.</note></p> |
37 for their tooltips.</note></p> |
21 <fig id="GUID-E707CA70-836D-41AA-A753-3E4E8319C55C"> |
|
22 <title>Example tooltip</title> |
|
23 <image href="GUID-5D408616-8A7A-4882-A64F-4BF6EC3FD6AA_d0e67451_href.png" placement="inline"/> |
|
24 </fig> |
|
25 <p>Tooltip appears when the user touches down and holds on an item, that has |
38 <p>Tooltip appears when the user touches down and holds on an item, that has |
26 a tooltip designed, for at least 0.3 seconds. It also appears from a dimmed |
39 a tooltip designed, for at least 0.3 seconds. It also appears from a dimmed |
27 icon, as it would be displayed in “normal” situation. Tooltip disappears with |
40 icon, as it would be displayed in “normal” situation. Tooltip disappears with |
28 touch release, when the focus is moved to another item or when the user touches |
41 touch release, when the focus is moved to another item or when the user touches |
29 down some other item that does not have a tooltip.</p> |
42 down some other item that does not have a tooltip.</p> |