tooltip

A tooltip is a box of information that labels a UI element that is hovered over

May 07, 2018
A tooltip is a box of information that labels a UI element that is hovered over

react-tooltip

A tooltip is a box of information that labels a UI element that is hovered over.

  • Tooltips are used for UI elements such as icons and buttons.
  • Try to keep a tooltip within a few words.
  • A tooltip should appear in a box with an arrow pointing to the UI element that is being referred to.
  • Display tooltips in one of the four directions in relation to the indicated UI control: top, bottom, left, or right.

View demo Download Source

(adsbygoogle = window.adsbygoogle []).push({});

Installation

  1. Install the latest version of react and react-tooltip:
npm install --save react @trendmicro/react-tooltip
  1. At this point you can import @trendmicro/react-tooltip and its styles in your application as follows:
import { Tooltip, Infotip } from '@trendmicro/react-tooltip'; // Be sure to include styles at some point, probably during your bootstraping import '@trendmicro/react-tooltip/dist/react-tooltip.css';

Usage

// Right tooltip <Tooltip content="Config settings"> <button>Settings</button> </Tooltip> // Right tooltip with a function content <Tooltip content={() => { return (<span style={{ whiteSpace: 'nowrap' }}>{'Right tooltip'}</span>); }} > <sapn>Hover on me</span> </Tooltip> // Top tooltip <Tooltip placement="top" content="Top tooltip"><sapn>Hover on me</span></Tooltip>
// Infotip <Infotip content="This is a simple example for infotip."> <span className="icon icon-info-sign" /> </Infotip > <Infotip placement="rightTop" content="This is a simple example for infotip."> <span className="icon icon-info-sign" /> </Infotip > <Infotip tooltipStyle={{ wordWrap: 'break-word' }} content="Pneumonoultramicroscopicsilicovolcanoconiosis is the longest word. Start01234567890123456789012345678901234567890123456789012345678901234567890123456789End Start0123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789End" > <span>Hover on me (infotip with long article)</span> </Infotip>

API

Properties for Tooltip

NameTypeDefaultDescription
placementstring'right'One of: 'top', 'right', 'bottom' and 'left'.
Tooltip will display at placement if possible, otherwise tooltip adjust it's location automatically.
enterDelaynumber0The delay length (in ms) before the tooltip appears.
leaveDelaynumber100The delay length (in ms) before the tooltip disappears.
hideOnClickbooleanfalseHide tooltip when target been clicked.
disabledbooleanfalseDisable tooltip.
tooltipClassNamestringThe className apply to tooltip itself. You can use it to override style if need.
tooltipStyleobjectThe style apply to tooltip itself. You can use it to override style if need.
contentnode or functionThe tooltip content. Required.

Properties for Infotip

NameTypeDefaultDescription
placementstring'rightBottom'One of: 'rightTop', 'rightBottom', 'leftTop', and 'leftBottom'.
Tooltip will display at placement if possible, otherwise tooltip adjust it's location automatically.
enterDelaynumber0The delay length (in ms) before the infotip appears.
leaveDelaynumber100The delay length (in ms) before the infotip disappears.
hideOnClickbooleanfalseHide infotip when target been clicked.
disabledbooleanfalseDisable infotip.
tooltipClassNamestringThe className apply to infotip itself. You can use it to override style if need.
tooltipStyleobjectThe style apply to infotip itself. You can use it to override style if need.
contentnode or functionThe infotip content. Required.

GitHub

Recommended