焦点与焦点可见变体
为键盘导航应用 focus:* 样式，并使用 focus-visible:* 仅为键盘用户显示焦点环，而不是响应鼠标点击。
焦点与焦点可见变体 是 CoddyKit 上的免费 Tailwind CSS Academy 课时。 这是第 2 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Tailwind CSS Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Tailwind CSS Academy 课程共包含 4 节课。
本课时的部分内容尚未翻译，以英文显示。
The Importance of Focus Styles
Keyboard navigation is used by people with motor disabilities, power users, and anyone filling out a long form. When an element is focused via keyboard, the browser highlights it with a focus indicator. CSS's :focus pseudo-class triggers on any focus event, while :focus-visible triggers only when the browser determines a visible focus indicator is helpful — typically keyboard navigation. Tailwind provides both as focus: and focus-visible: variant prefixes.
<!-- focus-visible is the accessible modern choice -->
<div class="flex gap-4">
<button class="bg-blue-500 text-white px-4 py-2 rounded focus:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:ring-offset-2">
Tab to me
</button>
</div>focus: Variant Basics
The focus: variant applies a style whenever the element receives focus, regardless of how — mouse click, touch, or keyboard. The most common use is removing the browser's default focus outline and replacing it with a custom ring: focus:outline-none focus:ring-2 focus:ring-blue-500. While convenient, this pattern has a downside: mouse users see the ring on click too, which some designers consider visually intrusive.
<!-- focus: fires on both mouse click and keyboard tab -->
<div class="space-y-3 max-w-sm">
<input
type="text"
placeholder="Click or tab to focus"
class="w-full border border-gray-300 rounded-lg px-4 py-2 focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-blue-500"
/>
<button class="w-full bg-gray-200 py-2 rounded-lg focus:outline-none focus:ring-2 focus:ring-gray-500">
Focus-on-click-too button
</button>
</div>focus-visible: The Modern Approach
focus-visible: maps to the CSS :focus-visible pseudo-class. Browsers apply this only when they determine that showing a focus indicator is appropriate — which means keyboard navigation but typically not mouse clicks on buttons. This gives you the best of both worlds: mouse users do not see the ring, but keyboard users always get clear feedback. This is the recommended approach in all modern Tailwind projects.
<!-- focus-visible: only shows ring for keyboard, not mouse -->
<div class="space-y-3 max-w-sm">
<!-- Try: click with mouse (no ring) vs Tab key (ring appears) -->
<button class="w-full bg-blue-500 text-white py-2 rounded-lg focus:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:ring-offset-2">
Smart focus (use Tab key)
</button>
<input
type="text"
placeholder="Input: ring on keyboard focus"
class="w-full border border-gray-300 rounded-lg px-4 py-2 focus:outline-none focus-visible:ring-2 focus-visible:ring-indigo-500"
/>
</div>Custom Focus Color Conventions
Choose focus ring colors that contrast with both the element and the page background. Brand color rings work well: focus-visible:ring-indigo-500 for an indigo-branded product. Error state focus can use focus:ring-red-500 on invalid inputs. Dark mode requires considering whether your ring color has enough contrast against dark backgrounds — light rings (ring-white or ring-blue-300) work better on dark surfaces.
<!-- Focus colors for different contexts -->
<div class="space-y-4 max-w-sm">
<!-- Normal: brand color ring -->
<input class="w-full border rounded px-3 py-2 focus:outline-none focus:ring-2 focus:ring-indigo-500" placeholder="Brand focus" />
<!-- Success: green ring -->
<input class="w-full border border-green-300 rounded px-3 py-2 focus:outline-none focus:ring-2 focus:ring-green-500 bg-green-50" placeholder="Valid input" />
<!-- Error: red ring -->
<input class="w-full border border-red-300 rounded px-3 py-2 focus:outline-none focus:ring-2 focus:ring-red-500 bg-red-50" placeholder="Invalid input" />
</div>Focus Styles for Links
Links are among the most important keyboard-navigable elements. By default, browsers apply a focus outline to links, but you may want to customize it to match your design. The pattern focus:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:rounded creates a clean ring that fits snugly around inline text links, making them clearly identifiable during keyboard navigation.
<!-- Accessible link focus styles -->
<p class="text-gray-700 leading-relaxed max-w-prose">
Visit our
<a href="#" class="text-blue-600 underline focus:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:rounded">
documentation
</a>
to learn more about
<a href="#" class="text-blue-600 underline focus:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:rounded">
getting started
</a>
with our product.
</p>Focus Within — Parent Reacting to Child Focus
focus-within: applies to a parent when any of its descendants are focused. This is useful for highlighting an entire form field container (label + input + helper text) when the input inside receives focus, not just the input itself. The visual group expands to indicate which form field group is active, making complex forms easier to navigate.
<!-- Entire form group highlights when input is focused -->
<div class="space-y-3 max-w-sm">
<!-- Container gets ring when child input is focused -->
<div class="border border-gray-200 rounded-xl p-3 focus-within:border-blue-500 focus-within:ring-2 focus-within:ring-blue-500/20 transition-all">
<label class="block text-xs font-medium text-gray-500 mb-1">Email Address</label>
<input
type="email"
class="w-full focus:outline-none text-gray-800"
placeholder="you@example.com"
/>
</div>
<div class="border border-gray-200 rounded-xl p-3 focus-within:border-blue-500 focus-within:ring-2 focus-within:ring-blue-500/20 transition-all">
<label class="block text-xs font-medium text-gray-500 mb-1">Password</label>
<input
type="password"
class="w-full focus:outline-none text-gray-800"
placeholder="••••••••"
/>
</div>
</div>Focus and Transition for Smooth Rings
Ring and border changes on focus can be animated with Tailwind's transition utilities. transition-shadow animates shadow (which rings use internally), and transition-colors animates border color changes. Setting duration-150 for a quick 150ms transition gives focus styles that feel instant and responsive without being jarring — the right balance for interactive form elements.
<!-- Smoothly animated focus rings -->
<div class="space-y-4 max-w-sm p-4">
<input
type="text"
placeholder="Focus with smooth transition"
class="w-full border border-gray-300 rounded-lg px-4 py-2 focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-blue-500 transition-all duration-150"
/>
<textarea
placeholder="Textarea with focus transition"
rows="3"
class="w-full border border-gray-300 rounded-lg px-4 py-2 focus:outline-none focus:ring-2 focus:ring-purple-500 focus:border-purple-500 transition-all duration-150 resize-none"
></textarea>
</div>Disabling Focus Styles Responsibly
You may encounter design requests to remove focus outlines entirely — resist this unless you provide an alternative. focus:outline-none alone violates WCAG 2.1 Success Criterion 2.4.7 (Focus Visible). Always pair it with a custom ring, border change, background change, or some other visible indicator. The pattern focus:outline-none focus-visible:ring-2 is the responsible way to remove the default outline while maintaining accessibility.
<!-- ❌ Bad: removes focus with no replacement -->
<button class="bg-blue-500 text-white px-4 py-2 rounded focus:outline-none">
Inaccessible (no focus indicator)
</button>
<!-- ✅ Good: replaces with custom ring -->
<button class="bg-blue-500 text-white px-4 py-2 rounded focus:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:ring-offset-2">
Accessible (custom ring)
</button>Focus in Select and Checkbox Elements
Native form controls like select, checkbox, and radio also respond to focus variants. For selects, the pattern is the same as inputs: focus:outline-none focus:ring-2 focus:ring-blue-500. For checkboxes, the ring wraps the checkbox square, and for radios it wraps the circle. The @tailwindcss/forms plugin provides better defaults for these elements across browsers.
<!-- Focus styles on different form controls -->
<div class="space-y-4 max-w-sm">
<!-- Select -->
<select class="w-full border border-gray-300 rounded-lg px-4 py-2 focus:outline-none focus:ring-2 focus:ring-blue-500">
<option>Option 1</option>
<option>Option 2</option>
<option>Option 3</option>
</select>
<!-- Checkboxes -->
<label class="flex items-center gap-3 cursor-pointer">
<input type="checkbox" class="w-4 h-4 rounded border-gray-300 text-blue-600 focus:ring-2 focus:ring-blue-500" />
<span>Agree to terms</span>
</label>
<!-- Radio -->
<label class="flex items-center gap-3 cursor-pointer">
<input type="radio" name="plan" class="w-4 h-4 border-gray-300 text-blue-600 focus:ring-2 focus:ring-blue-500" />
<span>Monthly plan</span>
</label>
</div>Skip Navigation Links
Skip navigation links are the first focusable element on a page, allowing keyboard users to jump directly to the main content and bypass the navigation. They are visually hidden by default but become visible on focus. The pattern uses sr-only combined with focus:not-sr-only focus:absolute to bring the link into view only when a keyboard user tabs to it. This is a WCAG 2.4.1 compliance requirement.
<!-- Skip navigation link: visible only on keyboard focus -->
<a
href="#main-content"
class="sr-only focus:not-sr-only focus:absolute focus:top-2 focus:left-2 bg-blue-500 text-white px-4 py-2 rounded font-medium z-50"
>
Skip to main content
</a>
<nav class="bg-gray-800 text-white px-6 py-4">
<!-- Navigation items -->
</nav>
<main id="main-content" class="p-6">
Main content here
</main>Focus Styles in Dark Mode
Focus rings designed for light mode may disappear or lose contrast in dark mode. Use Tailwind's dark: variant to switch ring colors: focus-visible:ring-blue-500 dark:focus-visible:ring-blue-400 uses a slightly lighter blue in dark mode for better contrast against dark backgrounds. Alternatively, use white rings on dark surfaces: dark:focus-visible:ring-white.
<!-- Focus rings for both light and dark mode -->
<div class="p-6 bg-white dark:bg-gray-900 space-y-3">
<input
type="text"
placeholder="Adaptive focus ring"
class="w-full bg-white dark:bg-gray-800 border border-gray-300 dark:border-gray-600 text-gray-900 dark:text-white rounded-lg px-4 py-2 focus:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 dark:focus-visible:ring-blue-400 focus-visible:border-blue-500 max-w-sm"
/>
</div>Quick Check
Test your understanding of Tailwind CSS Mastery concepts from this lesson.
Lesson Recap
In this lesson you learned: focus: fires on any focus event while focus-visible: fires only for keyboard navigation, focus-within: highlights a parent when any child is focused — great for form field groups, and always pair focus:outline-none with a custom ring to maintain WCAG accessibility. Next up we explore disabled and placeholder variants for form element styling.
常见问题解答
「焦点与焦点可见变体」课时是免费的吗？
是的 — 「焦点与焦点可见变体」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Tailwind CSS Academy 课程的其余内容，请升级到 CoddyKit PRO。 Tailwind CSS Academy 课程共包含 4 节课。
「焦点与焦点可见变体」这节课中我会学到什么？
为键盘导航应用 focus:* 样式，并使用 focus-visible:* 仅为键盘用户显示焦点环，而不是响应鼠标点击。 你通过在浏览器中直接运行的动手代码来练习 Tailwind CSS Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Tailwind CSS Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Tailwind CSS Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 2 节课，共 4 节。
「焦点与焦点可见变体」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Tailwind CSS Academy 课中编写并运行代码吗？
能。每节 Tailwind CSS Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。