rc-tooltip v6.4.0
rc-tooltip
React Tooltip
Screenshot
Browsers support
IE / Edge | Firefox | Chrome | Safari | Opera |
---|---|---|---|---|
IE 8 + ✔ | Firefox 31.0+ ✔ | Chrome 31.0+ ✔ | Safari 7.0+ ✔ | Opera 30.0+ ✔ |
Install
Usage
var Tooltip = require('rc-tooltip');
var React = require('react');
var ReactDOM = require('react-dom');
// By default, the tooltip has no style.
// Consider importing the stylesheet it comes with:
// 'rc-tooltip/assets/bootstrap_white.css'
ReactDOM.render(
<Tooltip placement="left" trigger={['click']} overlay={<span>tooltip</span>}>
<a href="#">hover</a>
</Tooltip>,
container,
);
Examples
npm start
and then go to
http://localhost:8000/demo
Online demo: https://react-component.github.io/tooltip/demo
API
Props
name | type | default | description |
---|---|---|---|
trigger | string | string[] | 'hover' | which actions cause tooltip shown. enum of 'hover','click','focus' |
visible | boolean | false | whether tooltip is visible |
defaultVisible | boolean | false | whether tooltip is visible by default |
placement | string | 'right' | tooltip placement. enum of 'top','left','right','bottom', 'topLeft', 'topRight', 'bottomLeft', 'bottomRight', 'leftTop', 'leftBottom', 'rightTop', 'rightBottom' |
motion | object | Config popup motion. Please ref demo for example | |
onVisibleChange | (visible: boolean) => void; | Callback when visible change | |
afterVisibleChange | (visible: boolean) => void; | Callback after visible change | |
overlay | ReactNode | () => ReactNode | tooltip overlay content | |
overlayStyle | object | deprecated, Please use styles={{ root: {} }} | |
overlayClassName | string | deprecated, Please use classNames={{ root: {} }} | |
prefixCls | string | 'rc-tooltip' | prefix class name of tooltip |
mouseEnterDelay | number | 0 | delay time (in second) before tooltip shows when mouse enter |
mouseLeaveDelay | number | 0.1 | delay time (in second) before tooltip hides when mouse leave |
getTooltipContainer | (triggerNode: HTMLElement) => HTMLElement | () => document.body | get container of tooltip, default to body |
destroyTooltipOnHide | boolean | false | destroy tooltip when it is hidden |
align | object | align config of tooltip. Please ref demo for usage example | |
showArrow | boolean | object | false | whether to show arrow of tooltip |
zIndex | number | config popup tooltip zIndex | |
classNames | classNames?: { root?: string; body?: string;}; | Semantic DOM class | |
styles | styles?: {root?: React.CSSProperties;body?: React.CSSProperties;}; | Semantic DOM styles |
Important Note
Tooltip
requires a child node that accepts an onMouseEnter
, onMouseLeave
, onFocus
, onClick
event. This means the child node must be a built-in component like div
or span
, or a custom component that passes its props to its built-in component child.
Accessibility
For accessibility purpose you can use the id
prop to link your tooltip with another element. For example attaching it to an input element:
<Tooltip
...
id={this.props.name}>
<input type="text"
...
aria-describedby={this.props.name}/>
</Tooltip>
If you do it like this, a screenreader would read the content of your tooltip if you focus the input element.
NOTE: role="tooltip"
is also added to expose the purpose of the tooltip element to a screenreader.
Development
npm install
npm start
Test Case
npm test
npm run chrome-test
Coverage
npm run coverage
License
rc-tooltip
is released under the MIT license.
6 months ago
5 months ago
5 months ago
4 months ago
8 months ago
1 year ago
1 year ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
3 years ago
3 years ago
3 years ago
4 years ago
4 years ago
4 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
6 years ago
6 years ago
6 years ago
7 years ago
7 years ago
7 years ago
8 years ago
8 years ago
8 years ago
8 years ago
8 years ago
8 years ago
8 years ago
8 years ago
8 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago