@jablonski/react-tooltip
v5.1.1
Published
react tooltip component
Downloads
1
Maintainers
Readme
react-tooltip
Demo
Documentation for V4 - Github Page.
Documentation for V5 - ReactTooltip.
Installation
npm install react-tooltip
or
yarn add react-tooltip
Usage
Using NPM
1 . Require react-tooltip after installation
import { Tooltip } from 'react-tooltip'
or if you want to still use the name ReactTooltip as V4:
import { Tooltip as ReactTooltip } from 'react-tooltip'
2 . Add data-tooltip-content = "your placeholder" to your element
<p id="my-element" data-tooltip-content="hello world">
Tooltip
</p>
3 . Include react-tooltip component
<ReactTooltip anchorId="my-element" />
Standalone
You can import node_modules/react-tooltip/dist/react-tooltip.[mode].js
into your page. Please make sure that you have already imported react
and react-dom
into your page.
mode: esm
cjs
umd
If you want to use default ReactTooltip styles, don't forget to import the styles: node_modules/react-tooltip/dist/react-tooltip.css
PS: all the files has a minified version and a not minified version.
Options
For all available options, please check React Tooltip Options
Security Note
The html
option allows a tooltip to directly display raw HTML. This is a security risk if any of that content is supplied by the user. Any user-supplied content must be sanitized, using a package like sanitize-html. We chose not to include sanitization after discovering it increased our package size too much - we don't want to penalize people who don't use the html
option.
JSX Note
You can use React's renderToStaticMarkup
-function to use JSX instead of HTML.
Example:
import ReactDOMServer from 'react-dom/server';
[...]
<p id="my-element" data-tooltip-html={ReactDOMServer.renderToString(<div>I am <b>JSX</b> content</div>)}>
Hover me
</p>
Note
- id is necessary, because
<ReactTooltip anchorId="my-element" />
finds the tooltip via this attribute
Article
How I insert sass into react component
Maintainers
danielbarion Maintainer - Creator of React Tooltip >= V5.
aronhelser Passive maintainer - accepting PRs and doing minor testing, but not fixing issues or doing active development.
alexgurr (inactive).
pdeszynski (inactive).
roggervalf (inactive).
huumanoid (inactive)
wwayne (inactive) - Creator of the original React Tooltip (V1.x ~ V4.x.)
We would gladly accept a new maintainer to help out!
Contributing
We welcome your contribution! Fork the repo, make some changes, submit a pull-request! Our contributing doc has some details.
License
MIT