Accesible CSS Tooltip in Compass

Screen-reader, legacy, touch and keyboard friendly

Yes, yet again revisiting the ubiquitous tooltip snippet. This one works on IE7+ probably on IE6 too. Is accessible with the keyboard and touch devices, semantic, and screen reader can read it. It also comes with a bit of styling and animation.

Here we can see it working on Codepen with it’s two flavours:

Check out this Pen!


<a href="javascript:;" class="tooltip">?<span>Here lies more explanation to this rather ambiguous question mark</span></a>

An anchor with a span inside. The javascript:; inside the href is for avoiding the scroll jumping to the top when you click on the anchor.

The CSS Compass class

	/* this is for actual behaviour */
	position: relative;
	overflow: hidden;
	@include inline-block;//it could be display:block;
	/* this is for mere presentation */
	padding:0.125em 0.25em;
	text-decoration: none;
	border-radius: 3px;
	outline:none;//since it's obvious there's focus.
		/* this is for actual behaviour */
//NOTE: this block must positiones outside the parent's box to be hidden.
		position: absolute;
		left: 0;
		top: 2em;
		z-index: 99;
		width: 15em;
		/* this is for mere presentation */
		color: #444;
		border-radius: 4px;
		border: 1px solid #888;
		padding:0.5em 1em;
		@include single-box-shadow(rgba(0,0,0,0.4), 2px, 2px, 4px, 0);
		@include single-transition(opacity, 0.5s, ease-in-out);
	&:hover, &:active, &:focus{
		/* this is for actual behaviour */
		overflow: visible;
		/* this is for mere presentation */

The key for this piece of code lies in the overflow:hidden which visibly hides content, but it can be read by screen readers, this is based on the clip techniques recommended by the Yahoo Accessibility Lab

In the &:hover, &:active, &:focus bit is where the changes in visibility happen, not only on hover, but also on the focus an active states, which do exist on touch devices.

The other advantage of not using display:none is that it allows us to use css transitions.

This scss code comes with some basic presentation stiles besides the behavioural styles.

Published :

Last modified :


comments powered by Disqus