react-tooltip

Installation

npm install react-tooltip

Usage

Using NPM

1 . Require react-tooltip after installation

import ReactTooltip from 'react-tooltip'

2 . Add data-tip = "your placeholder" to your element

<p data-tip="hello world">Tooltip</p>

3 . Including react-tooltip component

<ReactTooltip />

Standalone

You can import node_modules/react-tooltip/standalone/react-tooltip.min.js into your page, please make sure that you have already imported react and react-dom into your page.

Options

Notes:

• The tooltip is using type: dark place: top effect: float as default attribute, you don't have to add these options if you don't want to change default
• The option you set on <ReactTooltip /> component will be implemented on every tooltip in a same page: <ReactTooltip effect="solid" />
• The option you set on specific element, for example: <a data-type="warning"></a> will only make effect on this specific tooltip

Check example: React-tooltip Test

Global	Specific	Type	Values	Description
place	data-place	String	top, right, bottom, left	placement
type	data-type	String	success, warning, error, info, light	theme
effect	data-effect	String	float, solid	behaviour of tooltip
event	data-event	String	e.g. click	custom event to trigger tooltip
eventOff	data-event-off	String	e.g. click	custom event to hide tooltip (only makes effect after setting event attribute)
globalEventOff		String	e.g. click	global event to hide tooltip (global only)
isCapture	data-iscapture	Bool	true, false	when set to true, custom event's propagation mode will be capture
offset	data-offset	Object	top, right, bottom, left	data-offset="{'top': 10, 'left': 10}" for specific and offset={{top: 10, left: 10}} for global
multiline	data-multiline	Bool	true, false	support <br>, <br /> to make multiline
class	data-class	String		extra custom class, can use !important to overwrite react-tooltip's default class
html	data-html	Bool	true, false	<p data-tip="<p>HTML tooltip</p>" data-html={true}></p> or <ReactTooltip html={true} />
delayHide	data-delay-hide	Number		<p data-tip="tooltip" data-delay-hide='1000'></p> or <ReactTooltip delayHide={1000} />
delayShow	data-delay-show	Number		<p data-tip="tooltip" data-delay-show='1000'></p> or <ReactTooltip delayShow={1000} />
border	data-border	Bool	true, false	Add one pixel white border
getContent	null	Func or Array	() => {}, [() => {}, Interval]	Generate the tip content dynamically
countTransform	data-count-transform	Bool	True, False	Tell tooltip if it needs to count parents' transform into position calculation, the default is true, but it should be set to false when using with react-list
afterShow	null	Func	() => {}	Function that will be called after tooltip show
afterHide	null	Func	() => {}	Function that will be called after tooltip hide
disable	data-tip-disable	Bool	true, false	Disable the tooltip behaviour, default is false

Using react component as tooltip

Check the example React-tooltip Test

Note:

1. data-tip is necessary, because <ReactTooltip /> find tooltip via this attribute
2. data-for correspond to the id of <ReactTooltip />
3. When using react component as tooltip, you can have many <ReactTooltip /> in a page but they should have different id

Static Methods

ReactTooltip.hide(): Hide the tooltip manually

ReactTooltip.rebuild(): Rebinding tooltip to the corresponding elements

ReactTooltip.show(target): Show specific tooltip manually, for example:

import {findDOMNode} from 'react-dom'
import ReactTooltip from 'react-tooltip'

<p ref='foo' data-tip='tooltip'></p>
<button onClick={() => { ReactTooltip.show(findDOMNode(this.refs.foo)) }}></button>
<ReactTooltip />

Trouble Shooting

Using tooltip within the modal (e.g. react-modal)

The component was designed to set a <Reactooltip /> one place then use tooltip everywhere, but a lot of people stuck in using this component with modal, you can check the discussion here, the summarization of solving the problem is as following:

1. Put <ReactTooltip /> out of the <Modal>
2. Use React.rebuild() when opening the modal
3. If your modal's z-index happens to higher than the tooltip, use the attribute class to custom your tooltip's z-index

I suggest always put <ReactTooltip /> in the Highest level or smart component of Redux, so you might need these static method to control tooltip's behaviour in some situations

Article

How I insert sass into react component

License

MIT