diff --git a/docs/_includes/getting-started/accessibility.html b/docs/_includes/getting-started/accessibility.html index cbb528dce2..d43695ad32 100644 --- a/docs/_includes/getting-started/accessibility.html +++ b/docs/_includes/getting-started/accessibility.html @@ -3,12 +3,17 @@

Bootstrap follows common web standards and—with minimal extra effort—can be used to create sites that are accessible to those using AT.

Skip navigation

-

If your navigation contains many links and comes before the main content in the DOM, add a Skip to main content link before the navigation (read why). Using the .sr-only class will visually hide the skip link, and the .sr-only-focusable class will ensure that the link becomes visible once focused (for sighted keyboard users).

+

If your navigation contains many links and comes before the main content in the DOM, add a Skip to main content link before the navigation (for a simple explanation, see this A11Y Project article on skip navigation links). Using the .sr-only class will visually hide the skip link, and the .sr-only-focusable class will ensure that the link becomes visible once focused (for sighted keyboard users).

+
+

Due to long-standing shortcomings/bugs in Chrome (see issue 262171 in the Chromium bug tracker) and Internet Explorer (see this article on in-page links and focus order), you will need to make sure that the target of your skip link is at least programmatically focusable by adding tabindex="-1".

+

In addition, you may want to explicitly suppress a visible focus indication on the target (particularly as Chrome currently also sets focus on elements with tabindex="-1" when they are clicked with the mouse) with #content:focus { outline: none; }.

+

Note that this bug will also affect any other in-page links your site may be using, rendering them useless for keyboard users. You may consider adding a similar stop-gap fix to all other named anchors / fragment identifiers that act as link targets.

+
{% highlight html %} Skip to main content ... -
+
diff --git a/docs/_layouts/default.html b/docs/_layouts/default.html index ea69962ee3..f090bb1001 100644 --- a/docs/_layouts/default.html +++ b/docs/_layouts/default.html @@ -11,7 +11,7 @@ {% include nav/main.html %} -
+

{{ page.title }}

{{ page.lead }}

diff --git a/docs/assets/css/src/docs.css b/docs/assets/css/src/docs.css index c129c965b1..3c88d4865f 100644 --- a/docs/assets/css/src/docs.css +++ b/docs/assets/css/src/docs.css @@ -93,6 +93,7 @@ body { * Fancy skip link * * Make it look a bit less "bare bones" + * Also includes focus suppression for the Chrome tabindex="-1" workaround */ #skippy { @@ -108,6 +109,10 @@ body { outline: 1px dotted; } +#content:focus { + outline: none; +} + /* * Main navigation diff --git a/docs/index.html b/docs/index.html index e2539a8d90..e2e91a79e1 100644 --- a/docs/index.html +++ b/docs/index.html @@ -4,7 +4,7 @@ title: Bootstrap · The world's most popular mobile-first and responsive f --- -
+
B

Bootstrap is the most popular HTML, CSS, and JS framework for developing responsive, mobile first projects on the web.