讲师中心 微信公众号
AI工具推荐 视频效率加速

html制作aria-selected选中状态_html aria-selected选中状态无障碍标注

浅伟吖_2726

浅伟吖_2726

发布时间:2026-05-31 15:31:59

|

186人浏览过

|

来源于php中文网

原创

aria-selected="true"仅在role="tablist"/"grid"/"tree"等复合角色上下文中有效,需JS同步更新属性与样式,并显式设置所有非选中项为aria-selected="false"。

html制作aria-selected选中状态_html aria-selected选中状态无障碍标注

aria-selected="true" 必须配合 role="tablist" / "grid" / "tree" 等复合角色使用

单独给任意元素加 aria-selected="true" 不会触发屏幕阅读器播报“已选中”,也不会被 AT(辅助技术)识别为有效状态。它只在特定 WAI-ARIA 复合组件上下文中才有语义意义。

常见误用:给普通 <div> 或 <code><button></button> 直接加 aria-selected,却不设 role —— 这属于无效标注,AT 会忽略该属性。

  • role="tablist" + aria-selected 用于标签页(tabs),每个 tab 应有 role="tab"
  • role="grid" + aria-selected 用于可选中表格(如数据表格行选中),子项需为 role="row" 和 role="gridcell"
  • role="tree" + aria-selected 用于树形控件,节点需为 role="treeitem"

选中态必须由 JS 动态控制,不能仅靠 CSS 类切换

无障碍要求的是状态同步:视觉变化(如高亮)和 ARIA 状态必须严格一致。仅切换 .is-selected 类但不更新 aria-selected,会导致屏幕阅读器读取错误状态。

正确做法是用 JS 同时操作 DOM 属性和样式:

立即学习“前端免费学习笔记(深入)”;

使用华数设计生成高保真HTML原型、演示文稿、动画和设计评审
使用华数设计生成高保真HTML原型、演示文稿、动画和设计评审

使用经过文档化的设计技能,从真实的品牌或项目背景中生成HTML原生原型、幻灯片、动态演示、可视化图表和评审流程。

下载
tabEl.setAttribute('aria-selected', 'true');
tabEl.classList.add('tab--selected');

// 切换前务必清除旧选中项
oldTabEl.setAttribute('aria-selected', 'false');
oldTabEl.classList.remove('tab--selected');
  • 不要用 aria-selected 做纯样式钩子(例如 CSS 中写 [aria-selected="true"] { background: #007bff; } 是 OK 的,但前提是 JS 确实同步设置了该属性)
  • 避免用 aria-selected 替代原生 checked 或 selected —— 单选/复选框、<select></select> 应优先用原生语义

键盘焦点与 aria-selected 必须分离管理

aria-selected="true" 描述的是“逻辑选中”,不是“当前聚焦”。用户用 Tab 键移动焦点时,焦点可能落在未选中的项上;按方向键切换选中项时,焦点也未必跟随移动 —— 这两者是正交的。

  • 焦点(tabindex、focus())决定键盘操作目标
  • aria-selected 决定“哪个项被用户视为当前激活/选定”
  • 典型场景:在 role="tablist" 中,应保持一个 tab 永远有焦点(用 tabindex="0"),而 aria-selected="true" 只出现在当前激活的 tab 上,二者可不同步(例如按 ←→ 切换选中态但不移焦)

React/Vue 中容易漏掉 aria-selected 的条件重置

框架组件化渲染时,常因条件渲染或 key 变化导致 aria-selected 属性残留或丢失。比如用 v-for 或 {items.map()} 渲染 tab 列表,但没在每次 render 时显式设置所有项的 aria-selected 值。

错误写法(只设选中项,未设其他项为 false):

{tabs.map(tab => (
  <button 
    role="tab" 
    {...tab.id === activeId ? {'aria-selected': 'true'} : {}}
  >
    {tab.label}
  </button>
))}

正确写法(显式控制每个项):

{tabs.map(tab => (
  <button 
    role="tab" 
    aria-selected={tab.id === activeId ? 'true' : 'false'}
    tabIndex={tab.id === activeId ? 0 : -1}
  >
    {tab.label}
  </button>
))}
  • 服务端渲染(SSR)或静态生成时,初始 HTML 中的 aria-selected 也必须准确,不能依赖 JS 注入后才补全
  • 测试时可用 Chrome DevTools 的 Accessibility 面板直接查看 aria-selected 是否实时存在且值正确
实际项目中最容易被跳过的,是「所有非选中项都必须明确设为 aria-selected="false"」—— 很多人只记得设 true,却让其他项留空,而空值 ≠ false,AT 会将其视为“未定义状态”。

热门AI工具

更多
UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
C语言变量命名
C语言变量命名

c语言变量名规则是:1、变量名以英文字母开头;2、变量名中的字母是区分大小写的;3、变量名不能是关键字;4、变量名中不能包含空格、标点符号和类型说明符。php中文网还提供c语言变量的相关下载、相关课程等内容,供大家免费下载使用。

3729

2023.06.20

c语言入门自学零基础
c语言入门自学零基础

C语言是当代人学习及生活中的必备基础知识,应用十分广泛,本专题为大家c语言入门自学零基础的相关文章,以及相关课程,感兴趣的朋友千万不要错过了。

2468

2023.07.25

c语言运算符的优先级顺序
c语言运算符的优先级顺序

c语言运算符的优先级顺序是括号运算符 > 一元运算符 > 算术运算符 > 移位运算符 > 关系运算符 > 位运算符 > 逻辑运算符 > 赋值运算符 > 逗号运算符。本专题为大家提供c语言运算符相关的各种文章、以及下载和课程。

1420

2023.08.02

c语言数据结构
c语言数据结构

数据结构是指将数据按照一定的方式组织和存储的方法。它是计算机科学中的重要概念,用来描述和解决实际问题中的数据组织和处理问题。数据结构可以分为线性结构和非线性结构。线性结构包括数组、链表、堆栈和队列等,而非线性结构包括树和图等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1358

2023.08.09

c语言random函数用法
c语言random函数用法

c语言random函数用法:1、random.random,随机生成(0,1)之间的浮点数;2、random.randint,随机生成在范围之内的整数,两个参数分别表示上限和下限;3、random.randrange,在指定范围内,按指定基数递增的集合中获得一个随机数;4、random.choice,从序列中随机抽选一个数;5、random.shuffle,随机排序。

1436

2023.09.05

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

2398

2023.09.20

c语言get函数的用法
c语言get函数的用法

get函数是一个用于从输入流中获取字符的函数。可以从键盘、文件或其他输入设备中读取字符,并将其存储在指定的变量中。本文介绍了get函数的用法以及一些相关的注意事项。希望这篇文章能够帮助你更好地理解和使用get函数 。

3980

2023.09.20

c数组初始化的方法
c数组初始化的方法

c语言数组初始化的方法有直接赋值法、不完全初始化法、省略数组长度法和二维数组初始化法。详细介绍:1、直接赋值法,这种方法可以直接将数组的值进行初始化;2、不完全初始化法,。这种方法可以在一定程度上节省内存空间;3、省略数组长度法,这种方法可以让编译器自动计算数组的长度;4、二维数组初始化法等等。

18935

2023.09.22

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

0

2026.11.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习

Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 237人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn