You need to enable JavaScript to run this app. 如何编写JS函数为空标题元素设置值为presentation的role属性
优惠活动
大模型
产品
解决方案
定价
更多

如何编写JS函数为空标题元素设置值为presentation的role属性

解决方案

可直接使用的JS函数

function addPresentationRoleToEmptyHeadings() {
  // 选中所有h1~h6层级的标题元素
  const headings = document.querySelectorAll('h1, h2, h3, h4, h5, h6');
  
  headings.forEach(heading => {
    // trim处理空白字符,将仅含空格/换行/制表符的标题判定为空标题
    const headingText = heading.textContent.trim();
    if (headingText === '') {
      heading.setAttribute('role', 'presentation');
    }
  });
}

// 页面DOM加载完成后自动执行
document.addEventListener('DOMContentLoaded', addPresentationRoleToEmptyHeadings);

无障碍适配说明

  • 该逻辑匹配屏幕阅读器的内容识别规则,不会误判带有效文本的标题
  • role="presentation"会告知辅助技术忽略该元素的语义角色,避免空标题被误识别为页面结构节点,干扰视障用户的页面导航流程
  • 注意:如果后续业务逻辑会给原本为空的标题填充有效文本内容,需要同步移除role="presentation"属性,否则标题的层级语义不会被辅助技术识别
  • 如果项目中存在动态生成的标题内容,可在动态内容渲染完成后再次调用addPresentationRoleToEmptyHeadings()函数更新属性

边界场景拓展

如果需要把内部仅包含空标签(比如空的span、i标签)的标题也判定为空,可调整判断逻辑如下:

// 替换原函数内的判断逻辑即可
if (headingText === '' && heading.children.length === 0) {
  heading.setAttribute('role', 'presentation');
}

内容的提问来源于stack exchange,提问作者JuniorDev

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.09 17:54:00