Skip to content

Latest commit

 

History

History
89 lines (60 loc) · 3.53 KB

README.md

File metadata and controls

89 lines (60 loc) · 3.53 KB
Raw

Hint.css [v1.2.1]

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.

Read more about it.

Note: CSS3 Transitions on pseudo elements is currently available on Firefox & IE10 only. On rest of the browsers it degrades gracefully without any transition. Though the good news is that it will be coming soon on webkit also (landed in Chrome 26 beta).

###Try it out: http://kushagragour.in/lab/hint/

Get Started

Download one of the 2 library version:

And include it in the HEAD of your page:

<link rel="stylesheet" href="hint.css"></link>

or

<link rel="stylesheet" href="hint.min.css"></link>

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.

Hello Sir, <span class="hint--bottom">hover me.</span>

The tooltip text needs to be given using the data-hint attribute on that element.

Hello Sir, <span class="hint--bottom" data-hint="Thank you!">hover me.</span>

[ 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

Check out some examples at http://kushagragour.in/lab/hint/

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.

Read more on contributing.

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 (c) 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 :)