本文介绍在不依赖 CSS :has() 的前提下，实现“仅当子 input 通过键盘（如 Tab）获得焦点时，才为父容器添加视觉焦点样式”的可靠方案，涵盖原生 JavaScript 实现缺陷分析、推荐的 React ARIA 方案及最佳实践。
本文介绍在不依赖 css `:has()` 的前提下，实现“仅当子 input 通过键盘（如 tab）获得焦点时，才为父容器添加视觉焦点样式”的可靠方案，涵盖原生 javascript 实现缺陷分析、推荐的 react aria 方案及最佳实践。
在构建可访问的自定义表单组件（如封装后的 radio 或 checkbox）时，一个常见但关键的需求是：视觉焦点环（focus ring）应仅出现在键盘导航场景中，而非鼠标点击后意外激活。例如，用户用 Tab 键移动到某个 时，希望其外层
直接使用 :focus-within 是直观的尝试，但它无法区分聚焦来源（键盘 vs 鼠标），导致 onClick 后父容器仍保留 :focus-within 状态，视觉干扰明显。CSS :has(:focus) 虽能精准匹配，但截至 2024 年，其浏览器兼容性（尤其 Safari
❌ 原生 JS 方案的问题（不推荐）
早期实践中，有人尝试监听 keyup 检测 Tab 键并手动添加 .is-focused 类：
const wrapper = document.getElementById(`${id}--wrapper`);
wrapper?.addEventListener('keyup', (e) => {
if (e.key === 'Tab') {
wrapper.classList.add('is-focused');
}
});
// 全局监听其他元素聚焦，移除当前焦点态
document.addEventListener('focusin', (e) => {
const target = e.target as HTMLElement;
if (target.parentElement?.id !== `${id}--wrapper`) {
wrapper?.classList.remove('is-focused');
}
});该方案存在严重缺陷：
- 无法捕获 Shift+Tab 反向导航；
- keypress 事件不触发于所有聚焦方式（如 Ctrl+Tab、屏幕阅读器快捷键）；
- 全局事件监听耦合度高，难以单元测试（Jest 覆盖率极低）；
- 未处理 blur 边界情况，易造成状态残留。
✅ 推荐方案：使用 @react-aria/focus（生产就绪）
Adobe 开源的 React ARIA 提供了经过无障碍验证的 useFocusRing Hook，它通过底层检测 focus-visible 伪类行为与键盘操作历史，精准判断当前焦点是否“对用户可见且由键盘触发”。
使用示例（React + TypeScript）
import React, { useState } from 'react';
import { useFocusRing } from '@react-aria/focus';
import classNames from 'classnames';
interface RadioOptionProps {
id: string;
label: string;
checked: boolean;
onChange: (checked: boolean) => void;
}
export function RadioOption({ id, label, checked, onChange }: RadioOptionProps) {
const { isFocusVisible, focusProps } = useFocusRing();
return (
<label
className={classNames('radio-wrapper', {
'is-focused': isFocusVisible,
})}
onClick={() => onChange(true)}
>
<input
{...focusProps} // ✅ 自动处理 tabIndex、onKeyDown 等
type="radio"
id={id}
name={id}
checked={checked}
onChange={(e) => onChange(e.target.checked)}
/>
<span className="radio-label">{label}</span>
</label>
);
}样式建议（CSS）
.radio-wrapper {
padding: 8px 12px;
border-radius: 6px;
transition: outline 0.2s ease;
}
.radio-wrapper.is-focused {
outline: 2px solid #007aff;
outline-offset: 2px;
}
/* 确保鼠标点击时不显示 outline */
.radio-wrapper:focus-within:not(.is-focused) {
outline: none;
}✅ 关键优势总结
| 特性 | 说明 |
|---|---|
| 无障碍合规 | 完全遵循 WAI-ARIA Authoring Practices，支持屏幕阅读器、开关控制、语音命令等 |
| 精准检测 | 内部维护键盘操作状态栈，准确识别 Tab, Shift+Tab, Enter, Space 等触发的焦点 |
| 零配置开箱即用 | focusProps 自动注入 tabIndex={0}、onKeyDown 防止默认行为干扰，并处理 blur 清理 |
| 可测试性强 | Hook 行为确定，支持 Jest + React Testing Library 模拟键盘事件（如 fireEvent.keyDown(input, { key: 'Tab' })） |
| 跨框架适配 | 同样提供 Vue、Solid 等版本（@aria/focus），非 React 项目亦可集成 |
? 额外提示：若项目暂无法引入第三方库，可降级采用 :focus-visible + :focus-within 组合方案（需配合 @supports (focus-visible: auto)），但务必进行多浏览器实机测试——Safari 对 :focus-visible 的支持仍存在细微差异。
最终，聚焦样式的语义化控制不是样式问题，而是可访问性基础设施。选择经过实战检验的工具链（如 React ARIA），比自行实现状态机更高效、更可靠，也更符合现代前端工程的最佳实践。
