What is the Difference Between :focus, :focus-visible, and :focus-within in CSS?

Table of contents

• The :focus pseudo-class
• The problem with :focus
• Interactions using the keyboard
• The :focus-visible pseudo-class
• What about :focus-within?
  • Practical use case for :focus-within
• Further reading

---

As you may know, there are three similar sounding pseudo-classes in CSS, namely :focus, :focus-visible, and :focus-within.

At the first glance, one might get confused about the difference between these and when to use which one. The good news is: these three pseudo-classes are extremely simple to understand and distinguish from one another.

In this article, we shall understand what exactly is :focus, :focus-visible, and :focus-within, and when and how to use each one of these pseudo-classes.

Further reading:
If you need a refresher on pseudo-classes, hop over to the chapter CSS Pseudo Classes, in our CSS course.

---

The :focus pseudo-class

First things first, the :focus pseudo-class applies to an element when it's focused.

This focus can be made using the mouse (when we click on the element), the keyboard (when we navigate to it by pressing Tab), or the underlying program (when we use JavaScript).

Further reading:
You can explore the :focus pseudo-class in detail in CSS Pseudo Classes: :focus.

Furthermore, only focusable elements are allowed to receive focus and, therefore, be the subject of :focus. These are typically interactive elements in HTML — the likes of , , <button>, and so on.</button>

? Notice: Non-interactive elements such as

,

,

, , etc., aren't focusable and therefore can't be the subject of :focus. It's only if we explicitly make them focusable, by setting the tabindex attribute on them, that we can expect :focus to apply to them. <p>Coming back to :focus, this pseudo-class is used to select and, thereafter, apply styles to elements when they are in the focused state.</p> <p>Perhaps, the most naive example of doing so would be to consider an input field as demonstrated below:<br> </p> <pre class="brush:php;toolbar:false">&lt;label&gt; &lt;span&gt;Name&lt;/span&gt; &lt;input type=&quot;text&quot; name=&quot;name&quot;&gt; &lt;/label&gt; </pre> <p>Live Example</p> <p>The moment we click on the input field, it receives focus and, consequently, the browser applies a black outline to it, as illustrated below:</p> <p><img src="/static/imghwm/default1.png" data-src="https://img.php.cn/upload/article/000/000/000/173805157333247.png?x-oss-process=image/resize,p_40" class="lazy" alt="The input field focused" loading="lazy" style="max-width:90%" style="max-width:90%"></p> <p>This helps us immediately see which input are we currently in within a form of many input fields.</p> <p>To better appreciate the benefit of this, imagine the opposite. Suppose we click on an input field and have no special styling applied to the field as we do so.</p> <p><em>What do you think, would it be possible for us to determine which input are we currently in?</em> Well, it clearly won't be impossible to do so but NOT that quick either.</p> <p>The ideal thing in designing user interfaces of any kind is to <em>'make everything as easy as possible.'</em> And in this case, this ideal world can very easily be achieved just by employing the :focus pseudo-class.</p> <p>In essence:</p> <p>The :focus pseudo-class (even the other two focus pseudo-classes) helps us <strong>improve the accessibility</strong> of a webpage.</p> <p>By clearly communicating to the user visually as to where he currently is on the webpage, we make it easy enough for him to interact with the webpage and get his work done without any confusion.</p> <p>In other words, :focus is more important of a pseudo-class than we might think it is.</p> <p>But it's not the only important focus-based pseudo-class; we have <strong>:focus-visible</strong> as well.</p> <hr> <h2> The problem with :focus </h2> <p>In the example above for :focus, we considered a basic, text input field. Let's now shift to a button in order to see a shortcoming of :focus.</p> <p>Consider the following button, with the added :focus rule for it:<br> </p> <pre class="brush:php;toolbar:false">&lt;label&gt; &lt;span&gt;Name&lt;/span&gt; &lt;input type=&quot;text&quot; name=&quot;name&quot;&gt; &lt;/label&gt; </pre> <pre class="brush:php;toolbar:false">&lt;button&gt;A button&lt;/button&gt; </pre> <p>Live Example</p> <p>The moment we click on the button, we get the desired blue outline, as illustrated below:</p> <p><img src="/static/imghwm/default1.png" data-src="https://img.php.cn/upload/article/000/000/000/173805157468987.png?x-oss-process=image/resize,p_40" class="lazy" alt="The button focused" loading="lazy" style="max-width:90%" style="max-width:90%"></p> <p><em>But wait a second? Is this desire of us desirable?</em></p> <p>Said another way: <em>Is it a wise decision to showcase the outline when we click on the button using the mouse?</em> As it turns out, NO, it's not!</p> <p>Let's understand why...</p> <p>When we click on a button — or any interactive element, in general, that is meant to <strong>perform an action</strong>, for e.g. a link — we already know where we are on the webpage. Obviously, because we click consciously on the button, we certainly can't be confused about which element on the webpage currently has focus — we clearly know that it's the button we just clicked that has the focus currently.</p> <p>In this respect, it does NOT make much sense, if at all, to visually emphasize the button to be the currently focused element.</p> <p><em>But why does this make sense for input fields?</em></p> <p>Good question. You're right in your observation that :focus works absolutely fine when we use it on input fields and there's a simple reason for it. When we click on an input field using the mouse, our <strong>job doesn't finish</strong>; we still have to enter data into the field.</p> <p>And because our work isn't done yet, we quickly and clearly need to know which input is currently active.</p> <p>Most importantly notice the important, yet subtle, distinction between input fields and buttons (and other suchlike interactive elements):</p> <ul> <li>An input field doesn't accomplish a task <em>immediately</em> and therefore requires focus to be visualized even when we use the mouse to interact with it.</li> <li>A button accomplishes a task immediately (for e.g. adds an item to a cart) and therefore doesn't pose the need to visually showcase it in its focused state when we interact with it using the mouse.</li> </ul> <p>So, at this point, we know that input fields gel nicely with the :focus pseudo-class but that's not the case with buttons.</p> <p>But keep in mind that this reasoning only applies to when we interact with these elements using the mouse. <em>What happens when we shift to a keyboard?</em></p> <p>Let's find out...</p> <hr> <h2> Interactions using the keyboard </h2> <p>As you may know, it isn't only possible to navigate around a webpage using the mouse; we can use the keyboard for this as well, and <em>equally well</em>.</p> <p>In fact, if a webpage is built this way to only entertain mouse interactions, it's extremely inaccessible.</p> <p>Imagine someone broke their mouse device and now wants to prepare for their exam, and that there's no way to order another one at the moment. The worst case would be if that person wanted to prepare from a website built only around mouse interactions.</p> <p>As CSS developers, we must acknowledge this fact and design websites to be as accessible without a mouse as with it. In this respect, we must make sure to provide necessary visual emphasis on interactive elements when they receive focus.</p> <p><strong>And this now includes buttons as well.</strong></p> <p>Let's state this again.</p> <p>When we're using the mouse to interact with a webpage, creating visual emphasis for buttons (and similar elements) in their focused state isn't necessary; in fact, it's undesirable as we saw above. This is because the user already knows that after clicking on the button, it is the one that comes in focus.</p> <p>But when we're using the keyboard instead, <strong>creating visual emphasis is utmost necessary</strong>. This is because, now, the user isn't aware of which interactive element is in focus. We <em>need</em> to visually showcase this.</p> <p>The problem is that we can't use :focus for this styling concern because... <em>well</em>... it applies to button even when we interact with them using the mouse.</p> <p><em>Now what?</em></p> <p>No need to worry, for we have <strong>:focus-visible</strong> to the rescue!</p> <hr> <h2> The :focus-visible pseudo-class </h2> <p>I stress a lot on the fact that before getting to learn anything in programming, first gaze over its nomenclature (a fancy word for <em>'naming'</em>). Chances are high that the meaning lies in the name itself.</p> <p>Following this, if we analyze the name :focus-visible, it clearly has something to do with <em>'focus'</em> but also something to do with <em>'visible'</em>.</p> <p><em>Can you figure out just by the name what this pseudo-class means?</em></p> <p>Well, :focus-visible applies to an element that is in focus <em>and</em> whose focus needs to be made visible (ideally). Compactly, we could also say that :focus-visible applies to an element that ought to have its <em>focus visible</em>.</p> <p>:focus-visible only shows up when we bring an element in focus using the keyboard, or some other non-mouse interaction (for e.g. using JavaScript).</p> <p>Most importantly — and this is really really important — <strong>:focus-visible does NOT apply to buttons (and suchlike elements) when they receive focus by virtue of mouse interactions</strong>.</p> <p>With this, let's go back to our <button> example above and replace the :focus rule with :focus-visible so that the outline is only presented when the button receives focus via the keyboard:<br> </button></p> <pre class="brush:php;toolbar:false">&lt;label&gt; &lt;span&gt;Name&lt;/span&gt; &lt;input type=&quot;text&quot; name=&quot;name&quot;&gt; &lt;/label&gt; </pre> <p>Live Example</p> <p>Here's what we get when we click on the button (using the mouse):</p> <p><img src="/static/imghwm/default1.png" data-src="https://img.php.cn/upload/article/000/000/000/173805157579222.png?x-oss-process=image/resize,p_40" class="lazy" alt="The button (with a :focus-visible style) focused again" loading="lazy" style="max-width:90%" style="max-width:90%"></p> <p>Nothing.</p> <p>But when we press the Tab key in order to navigate to the button and bring it in focus, we get the same outline as before:</p> <p><img src="/static/imghwm/default1.png" data-src="https://img.php.cn/upload/article/000/000/000/173805157664076.png?x-oss-process=image/resize,p_40" class="lazy" alt="The button focused via the keyboard" loading="lazy" style="max-width:90%" style="max-width:90%"></p> <p>This brings us right at the ultimate conclusion that when styling buttons (or other suchlike elements, for e.g. <a>), we must preferably use :focus-visible instead of :focus (for reasons we saw above).</a></p> <p>:focus-visible is basically a win-win situation in that (a) we don't apply styles when buttons are clicked, and therefore focused, using the mouse and (b) we do make sure that our webpage remains accessible when using the keyboard with necessary focus styles on buttons.</p> <p><em>:focus-visible is a hero! (But I don't know the movie's name!)</em></p> <hr> <h2> What about :focus-within? </h2> <p>Obviously, we couldn't end this article without going over the less useful <strong>:focus-within</strong> pseudo-class. Let's do that now.</p> <p>:focus-within, as the name suggests (<em>remember to read names carefully</em>), applies to an element that has <em>focus within it</em>.</p> <p>In other words, any element that contains a descendant element that matches :focus, or itself matches :focus, is a candidate for :focus-within.</p> <p>Following is an example:<br> </p> <pre class="brush:php;toolbar:false">&lt;button&gt;A button&lt;/button&gt; </pre> <p>We have a button contained inside a </p> <div>. Our goal is to style the <div> specially when its button is in focus. The following CSS accomplishes this:<br> <pre class="brush:php;toolbar:false">button:focus { outline: 3px solid blue; } </pre> <p>Live Example</p> <p>The moment the button receives focus, the </p> <div> gets a pink background color.<p><em>Pretty basic.</em></p> <p><strong>? Notice</strong>: Keep in mind that :focus-within behaves exactly like :focus in that it also shows up on mouse interactions on buttons, for example. It does NOT exhibit a behavior similar to :focus-visible.</p> <p>Now you might be looking for a more practical example of :focus-within and that's precisely what I have up next for you.</p> <p>As stated earlier, :focus-within isn't that commonly used in CSS but some cases are such that they can be solved pretty elegantly using :focus-within. Read on to learn about such a case.</p> <h3> Practical use case for :focus-within </h3> <p>Suppose we have an accessibility bar on a website that only shows up when using keyboard navigation. Initially, it's hidden but only visually; that is, it's possible to tab to either of the buttons inside this bar.</p> <p><strong>? Notice</strong>: <em>'Hidden only visually'</em> means that the element doesn't have display: none or visibility: hidden set on it to otherwise actually hide it. For instance, opacity: 0 hides an element only visually.</p> <p>Now, the moment any of the buttons in this accessibility bar comes into focus, it's required to showcase this bar to the user.</p> <p><em>But how to select the accessibility bar when either of its buttons has focus?</em> Well, supposing that the bar can be selected by the class selector .a11y-bar (<em>'a11y'</em> is a short form for <em>'accessibility'</em>), the desired selector would be .a11y-bar:focus-within.</p> <p>.a11y-bar:focus-within selects the .a11y-bar whenever focus resides within it, which is exactly what we need.</p> <p><em>Good job!</em></p> <p>The link below demonstrates this example:</p> <p>Live Example</p> <hr> <h2> Further reading </h2> <p>Despite the fact that we've covered almost everything that we need to know about :focus, :focus-visible, and :focus-within, there still is value in reading further from some resources as mentioned below:</p> <ul> <li>Using CSS :focus-visible to provide keyboard focus indication — WCAG 2.1 Techniques</li> <li>Understanding Success Criterion 2.4.7: Focus Visible | WAI | W3C</li> <li>9.3. The Input Focus Pseudo-class: :focus — Selectors Level 4 | W3C</li> <li>9.4. The Focus-Indicated Pseudo-class:: :focus-visible — Selectors Level 4 | W3C</li> <li>9.5. The Focus Container Pseudo-class: :focus-within — Selectors Level 4 | W3C</li> </ul> <hr> <h2> Learn CSS today </h2> <p>If you're a newbie in CSS and want to learn the basics well, consider the CSS course on Codeguage.</p> </div> </div> </div>

The above is the detailed content of What is the Difference Between :focus, :focus-visible, and :focus-within in CSS?. For more information, please follow other related articles on the PHP Chinese website!