微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

"[aria-hidden="true"] 元素包含可聚焦的后代";最好的方法来解决这个问题? 我正在使用动画/过渡,所以不能只隐藏所有内容

如何解决"[aria-hidden="true"] 元素包含可聚焦的后代";最好的方法来解决这个问题? 我正在使用动画/过渡,所以不能只隐藏所有内容

我有一个简单的手风琴:

<div>
  <button aria-expanded='false' aria-controls='content'>
    Open accordion
  </button>
  <div id='content' aria-hidden='true'>
    This the accordion's hidden content.
  </div>
</div>

我使用 Javascript 打开/关闭手风琴并设置 aria-* 标签

一切正常,但是当我在内容添加链接时:

<div>
  <button aria-expanded='false' aria-controls='content'>
    Open accordion
  </button>
  <div id='content' aria-hidden='true'>
    This is the accordion's hidden content.
    <a href='https://www.google.com'>Go to Google</a>
  </div>
</div>

Lighthouse 给了我这个:

[aria-hidden="true"] elements contain focusable descendents

在我看来,将 tabindex='-1' 添加a 标签可以解决这个问题:

<a tabindex='-1' href='https://www.google.com'>Go to Google</a>

然而,这使得元素“不可制表”,这对可访问性不利。

我可以使用 Javascript 手动查询手风琴内容中的所有 a 标签,但我什至不确定这是否真的解决了“问题”还是一种肮脏的解决方法?有没有更好的选择?

谢谢。

解决方法

简单的解决方案,使用 CSS display:none 属性将元素从可聚焦中移除:

#content[aria-hidden=true] {
   display:none;
}

这不仅有用而且非常必要,因为我们不希望屏幕阅读器宣布不可见的内容。

,

为什么会收到此警告?

此警告显示,尽管您使用了 aria-hidden="true",但如果子项可以获得焦点(以解决开发人员错误、JavaScript 未正确加载等),大多数屏幕阅读器将忽略父项上的 aria-hidden="true"。 ).

如何解决?

我假设您使用的是上滑动画或类似的东西,这就是为什么您不简单地在内容上使用 display: none

如果您不使用动画,那么在您应用 display: none 时只需 aria-hidden="true" 内容(@Adam 在他的回答中向您展示了执行此操作的完美方法)。

更好的是,您可以直接在 div 上使用 display: none,因为这会在屏幕阅读器中隐藏所有内容,因此您无需在那里使用 WAI-ARIA!

我正在使用动画/过渡,所以不能只隐藏所有内容。

如果您正在使用动画、不透明度变化等,这会阻止您简单地隐藏整个内容,那么您可以做的是隐藏内容 <div> 中的可聚焦内容。

当您应用 aria-hidden="true" 时,我们可以使用 CSS 完成此操作,然后在您更改或删除 aria-hidden="true" 时取消隐藏可聚焦元素。

当我们再次取消隐藏元素时,为了避免“布局卡顿”,我建议使用 visibility: hidden 而不是 display: none,因为这样会为隐藏的项目分配空间,并且仍然对屏幕阅读器等隐藏它们.

#content[aria-hidden=true] a[href],#content[aria-hidden=true] area[href],#content[aria-hidden=true] input:not([disabled]),#content[aria-hidden=true] select:not([disabled]),#content[aria-hidden=true] textarea:not([disabled]),#content[aria-hidden=true] button:not([disabled]),#content[aria-hidden=true] [tabindex]:not([disabled]),#content[aria-hidden=true] [contenteditable=true]:not([disabled]){
    visibility: hidden;
}

快速演示

了解我的意思的最简单方法是使用快速演示,按下“切换 aria-hidden on”按钮,它将隐藏 #content <div> 中的所有可聚焦元素。

var btn = document.querySelector('#toggle-aria');
var contentDiv = document.querySelector('#content');


btn.addEventListener('click',function(){
    var self = this;
    if(contentDiv.getAttribute('aria-hidden') == "false"){
      self.innerHTML = "Toggle aria-hidden off";
      contentDiv.setAttribute('aria-hidden',"true"); 
    }else{
      self.innerHTML = "Toggle aria-hidden on";
      contentDiv.setAttribute('aria-hidden',"false"); 
    }
});
#content{
padding: 20px;
border: 1px solid #333;
}

#content[aria-hidden=true] a[href],#content[aria-hidden=true] [contenteditable=true]:not([disabled]){
    visibility: hidden;
}
<br/><br/><button id="toggle-aria">Toggle aria-hidden on</button>

<p>When aria-hidden is set to true on the below div all focusable elements should disappear.</p>

<hr/>

<div id="content" aria-hidden="false">
    <a href="https://google.com">To Google</a><br/><br/>
    <label>An input
      <input />
    </label><br/><br/>
    <label>A Select 
      <select>
        <option>option 1</option>
        <option>option 2</option>
        <option>option 3</option>
      </select>
     </label><br/><br/>
     <label>A textarea
      <textarea></textarea>
    </label><br/><br/>
    <button>A button</button><br/><br/>
    <div tabindex="0">A fake button with tabindex</div><br/><br/>
    <div contenteditable="true">A div that is cotnent editable</div><br/><br/>
    <p>Only the labels and this paragraph should be the only things left showing when you toggle the aria-hidden to true</p>
    
</div>
<br/><br/>
<button>I am a button purely so you can see there is nothing focusable within the #content div if you "Tab"</button>

重要提示:在您按下“打开手风琴”按钮的那一刻,您应该删除 aria-hidden 任何动画等。这是因为屏幕阅读器用户会然后尝试 Tab(或通过屏幕阅读器快捷方式导航)进入内容。如果您删除 aria-hidden="true" 太晚,他们可能会跳过所有内容!

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。