修复卡片焦点问题需分三步:一是设role="region"并配aria-labelledby确保屏幕阅读器识别卡片;二是末尾加tabindex="-1"出口锚点,js监听tab键跳转;三是用roving tabindex+aria-grabbed等实现分层交互与拖拽可访问性。

卡片内焦点顺序被Tab键跳过,怎么修?
根本原因不是“没加tabindex”,而是卡片容器本身阻断了焦点流——比如用了div包裹却没设role="region"或aria-labelledby,导致屏幕阅读器直接跳过整块区域。
实操建议:
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图,自动匹配视觉风格。触发场景:文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
- 给卡片最外层容器加
role="region",并配aria-labelledby指向内部标题(如<h3 id="card-title">订单详情</h3>) - 避免对卡片整体设
tabindex="0"——这会让整个卡片变成一个“单焦点入口”,用户无法用Tab逐个操作内部按钮、链接、开关 - 内部可交互元素(
button、a、input等)保持默认可聚焦性,不额外加tabindex;只有非原生控件(如div模拟的开关)才需tabindex="0"+role="switch"+aria-checked - 若卡片支持展开/折叠,触发按钮必须带
aria-expanded="false",且JS同步更新该值
键盘用户卡在卡片里出不来,怎么放行?
常见于模态式卡片或带滚动容器的卡片:用户按Tab到最后一项后,焦点没回到下一个逻辑区块,而是循环回卡片开头,或干脆消失。
实操建议:
- 不要依赖
tabindex="0"强行拉入焦点——它只解决“进得来”,不解决“出得去” - 卡片末尾必须放一个不可见但可聚焦的“出口锚点”,例如:
<div tabindex="-1" id="card-exit"></div>,并在JS中监听keydown事件,当焦点在最后一项且按Tab(无Shift)时,调用cardExit.focus() - 若卡片内容动态加载(如点击“查看更多”后插入新按钮),不能用
innerHTML =替换整个DOM——这会清空焦点状态;改用appendChild或insertAdjacentElement,并手动将焦点移到新增项 - 滚动容器(
overflow: auto)要加tabindex="-1",否则键盘焦点可能卡在容器边界无法穿透
卡片内有多个操作区(如主操作+快捷操作+设置),焦点怎么分层?
用户需要区分“核心操作”和“辅助操作”,但原生Tab顺序是扁平的,容易误触。
实操建议:
- 用
roving tabindex模式管理子区域:每个功能区(如“操作栏”“快捷工具栏”)设一个“入口焦点项”,其余项初始tabindex="-1";用户进入该区后,用方向键切换,Tab键直接跳到下一功能区 - 每个功能区加
role="toolbar"或role="group",并用aria-label说明用途(如aria-label="主操作工具栏") - 禁止给同一卡片内多个
button设相同aria-label——哪怕视觉文案一样,也要加上下文,例如“删除订单#12345” vs “删除订单#67890” - 如果某操作区仅对特定用户可见(如管理员按钮),别用
display: none隐藏——这会让焦点路径断裂;改用aria-hidden="true"+inert(现代浏览器)或tabindex="-1"+ 视觉隐藏
卡片支持键盘拖拽排序,怎么让读屏器知道状态?
拖拽过程中的“已选中”“可放置”“已放下”全是视觉反馈,键盘用户完全感知不到。
实操建议:
- 拖拽起始元素必须有
aria-grabbed="false",按下空格/Enter后改为"true",并用aria-live="polite"区域播报“已选中‘待发货订单’,等待放置” - 放置目标区域需带
aria-dropeffect="move"(或"copy"),且aria-disabled="false"时才接受焦点 - 拖拽过程中,用
aria-activedescendant指向当前高亮的目标项ID,而不是靠CSS伪类;方向键移动时同步更新该属性 - 拖拽结束必须重置所有
aria-grabbed和aria-dropeffect,否则后续操作会继承错误状态
tabindex解决,得靠事件总线或状态驱动的焦点策略。前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










