2016-09-09 06:48:17 +02:00
---
layout: docs
title: Screenreaders
2017-08-15 03:09:16 +02:00
description: Use screenreader utilities to hide elements on all devices except screen readers.
2016-09-09 06:48:17 +02:00
group: utilities
2017-05-28 20:25:59 +02:00
toc: true
2016-09-09 06:48:17 +02:00
---
Hide an element to all devices **except screen readers** with `.sr-only` . Combine `.sr-only` with `.sr-only-focusable` to show the element again when it's focused (e.g. by a keyboard-only user). Can also be used as mixins.
2017-10-22 13:53:06 +02:00
{%- comment -%}
2017-05-29 20:38:06 +02:00
Necessary for following [accessibility best practices ]({{ site.baseurl }}/docs/{{ site.docs_version }}/getting-started/#accessibility ).
2017-10-22 13:53:06 +02:00
{%- endcomment -%}
2016-09-09 06:48:17 +02:00
2018-03-14 16:44:38 +01:00
{% capture example %}
2016-09-09 06:48:17 +02:00
< a class = "sr-only sr-only-focusable" href = "#content" > Skip to main content< / a >
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
2016-09-09 06:48:17 +02:00
{% highlight scss %}
// Usage as a mixin
.skip-navigation {
@include sr-only;
@include sr-only-focusable;
}
{% endhighlight %}