react-toolbox/components/tooltip
Javi Velasco 390e7694db Fix #787 2016-09-27 00:00:20 +02:00
..
Tooltip.js Fix #787 2016-09-27 00:00:20 +02:00
_config.scss New approach for Tooltips 2015-11-29 12:39:55 +01:00
index.d.ts Import React namespace, fix problem with @types 2016-09-02 09:18:33 +02:00
index.js Better tooltips 2016-08-07 18:55:31 +02:00
readme.md Fixes #586 2016-08-07 20:51:31 +02:00
theme.scss Fix linter warnings 2016-08-07 21:23:14 +02:00

readme.md

Tooltip

A Tooltip is useful to show information on hover in any kind of component. We have a component that can be used as a decorator for any kind of component. Also, it's factory function is exposed so you can create your own decorator with specific properties.

import Button from 'react-toolbox/lib/button';
import Tooltip from 'react-toolbox/lib/tooltip';
import Link from 'react-toolbox/lib/link';

const TooltipButton = Tooltip(Button);
const TooltipInput = Tooltip(Input);
const TooltipLink = Tooltip(Link);

const TooltipTest = () => (
  <div>
    <TooltipButton label='Bookmark' icon='bookmark' raised primary tooltip='Bookmark Tooltip' tooltipDelay={1000} />
    <TooltipButton icon='add' floating accent tooltip='Floating Tooltip' />
    <TooltipLink count={42} href="#" label="The answer is" icon='speaker_notes' tooltip='Question - universe?'/>
    <TooltipInput tooltip='lorem ipsum...' />
  </div>
);

This component can be styled by context providing a theme with the key RTTooltip through the theme provider.

Properties

In any component you decorate with the Tooltip you'd get some additional props:

Name Type Default Description
className String '' Sets a class to give customized styles to the tooltip.
onClick Function Callback to be invoked when Component is clicked.
onMouseEnter Function Callback called when the mouse enters the Component.
onMouseLeave Function Callback called when the mouse leaves the Component.
tooltip String The text string to use for the tooltip.
tooltipDelay Number Amount of time in miliseconds spent before the tooltip is visible.
tooltipHideOnClick Boolean true If true, the Tooltip hides after a click in the host component.
tooltipPosition String vertical Determines the position of the tooltip. It can be automatic with vertical and horizontal values or forced with bottom, top, left or right.

Theming

Name Description
tooltip Added to the tooltip element wrapper.
tooltipActive Added to the root when the tooltip is active.
tooltipBottom Added to the root in case the tooltip is being positioned at bottom.
tooltipInner Added to the inner element which sets the background, font and rounded borders.
tooltipLeft Added to the root in case the tooltip is being positioned at left.
tooltipRight Added to the root in case the tooltip is being positioned at right.
tooltipTop Added to the root in case the tooltip is being positioned at top.