<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"Eclipse Public License v1.0" which accompanies this distribution, 

and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

<!-- Initial Contributors:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE concept

  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

<concept id="GUID-1B64E1D9-33AB-4C28-A471-22D4C51FEC43" xml:lang="en"><title>Tooltips</title><prolog><metadata><keywords/></metadata></prolog><conbody>

<p>Tooltip is used for providing brief hint about an item, to explain the

user’s tasks for the item selected by the user.</p>

<p>An <xref href="GUID-8EAF5A96-EB48-4A58-82D7-0583A22A51D0.dita">information pop-up</xref> is

used to display the tooltip.</p>

<p>Information pop-up notes are used to provide additional information to

the user, most typically regarding a focused item. Although the Information

pop-up can be used in various applications and components, it should not be

used too frequently as constantly appearing and disappearing notes may disturb

smooth user experience.</p>

<p>The Information pop-up does not have focus, its content cannot be scrolled,

and the control always remains in the main pane. The maximum number of rows

in the Information pop-up is four. In a typical case, the pop-up emerges one

second after the user has taken the focus on an item but has not made any

further actions. The pop-up is timed so that it (typically) remains visible

for ten seconds or until some event interrupts it. Time-outs are application-specific

and variation is possible.</p>

<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>

<fig id="GUID-F7BBCA95-5754-44C1-9CCF-3A5B837E98B5">

<title>Example of tooltip</title>

<image href="GUID-1D399C05-6CC0-4781-A6E1-1C94CFF8995B_d0e63101_href.png" placement="inline"/>

</fig>

<p><b>Design recommendation</b>: Tooltips must not be used for items that

might open a stylus pop-up menu with touch down and hold. </p>

<p><note>It is an application's responsibility to design all required texts

for their tooltips.</note></p>

<p>Tooltip appears when the user touches down and holds on an item, that has

a tooltip designed, for at least 0.3 seconds. It also appears from a dimmed

icon, as it would be displayed in “normal” situation. Tooltip disappears with

touch release, when the focus is moved to another item or when the user touches

down some other item that does not have a tooltip.</p>

<p> There is no touch interaction with the tooltip item.</p>

</conbody></concept>