Hint.css [v1.3.5]
A tooltip library in CSS for your lovely websites
hint.css
is written as a pure CSS resource using which you can create cool tooltips for your web app. It does not rely on JavaScript and rather uses data-* attribute, pseudo elements, content property and CSS3 transitions to create the tooltips. Also it uses BEM naming convention particularly for the modifiers.
Try it out:
http://kushagragour.in/lab/hint/
If you find this useful and want to show some love & encouragement, I am on Gittip.
Get Started
Get the library using one of the following ways:
- Github
Full build - [unminified] : https://raw.github.com/chinchang/hint.css/master/hint.css - [minified] : https://raw.github.com/chinchang/hint.css/master/hint.min.css
Base build (Does not include color themes and fancy effects) - [unminified] : https://raw.github.com/chinchang/hint.css/master/hint.base.css - [minified] : https://raw.github.com/chinchang/hint.css/master/hint.base.min.css
- Bower
bower install hint.css
- npm
npm install --save hint.css
- CDN
http://www.jsdelivr.com/#!hint.css
Now include the library in the HEAD of your page:
1
|
|
or
1
|
|
Any element on your page which needs to have a tooltip has to be given at least one of the position classes: hint--top
, hint--bottom
, hint--left
, hint--right
to position the tooltip.
1
|
|
The tooltip text needs to be given using the data-hint
attribute on that element.
1
|
|
[ Note: The hint
class is no more required and is deprecated. Tooltip is shown on elements which have the data-hint
attribute instead.]
Use it with other available modifiers in various combinations. Available modifiers:
- hint--error
- hint--info
- hint--warning
- hint--success
- hint--always
- hint--rounded
- hint--no-animate
- hint--bounce
Changing the prefix for class names
Don’t like BEM naming (hint--
) or want to use your own prefix for the class names?
Simply update src/hint-variables.scss
and change the $prefix
variable.
To generate the css file, please read the contributing page.
Who’s Using This?
Are you using hint.css in your awesome project too? Let us know on the mailing list.
Browser Support
hint.css works on all latest browsers, though the transition effect is supported only on IE10+, Chrome 26+ and FF4+ at present.
- Chrome - basic + transition effects
- Firefox - basic + transition effects
- Opera - basic
- Safari - basic
- IE 10+ - basic + transition effects
- IE 8 & 9 - basic
Contributing
hint.css
is developed in SASS and the source files can be found in the src/
directory.
If you would like to create more types of tooltips/ fix bugs/ enhance the library etc. you are more than welcome to submit your pull requests.
Changelog
See the Changelog
To catch all updates and discussion, join the mailing list: hintcss@googlegroups.com.
To subscribe: hintcss+subscribe@googlegroups.com or visit here.
License
Copyright © 2013 Kushagra Gour Licensed under the MIT license.
Credits
This doesn’t make use of a lot of BEM methodology but big thanks to @csswizardry, @necolas for their awesome articles on BEM and to @joshnh through whose work I came to know about it :)