From b14c7f1e17ae520901e4ca6fa5c011ec804fcbc1 Mon Sep 17 00:00:00 2001 From: "Patrick H. Lauke" Date: Sat, 26 Dec 2015 20:12:51 +0000 Subject: [PATCH] Add accessibility callout for tooltips --- docs/components/tooltips.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/components/tooltips.md b/docs/components/tooltips.md index bba918d9dc..204c2ddaa0 100644 --- a/docs/components/tooltips.md +++ b/docs/components/tooltips.md @@ -117,6 +117,12 @@ $('#example').tooltip(options) The required markup for a tooltip is only a `data` attribute and `title` on the HTML element you wish to have a tooltip. The generated markup of a tooltip is rather simple, though it does require a position (by default, set to `top` by the plugin). +{% callout warning %} +#### Making tooltips work for keyboard and assistive technology users + +You should only add tooltips to HTML elements that are traditionally keyboard-focusable and interactive (such as links or form controls). Although arbitrary HTML elements (such as ``s) can be made focusable by adding the `tabindex="0"` attribute, this will add potentially annoying and confusing tab stops on non-interactive elements for keyboard users. In addition, most assistive technologies currently do not announce the tooltip in this situation. +{% endcallout %} + {% highlight html %} Hover over me