原文: http://www.zcfy.cc/article/320
这篇文章的审校工作是由Mallory van Achterberg完成的。谢谢所有SitePointer的审校者,因为你们,SitePointer才能提供如此优质的内容。
在 上一篇文章 中,我演示了如何创建一个有多选功能的Web组件。读者在评论区域提到了Web组件无障碍这个重要的话题。毋庸置疑地,如今Web无障碍非常重要。所以,让我们来看看无障碍的含义,以及如何提高Web组件的可访问性(通过一个真实的例子)。
本文中的代码示例将基于上一篇文章中的代码。你可以从 GitHub仓库 复制一份,也可以查看本文结尾的 例子 。
组件的可访问性通常涉及以下方面:
让我们更深入地了解各个方面。
你应该听说过屏幕阅读器。屏幕阅读器通过大声播放屏幕上展示的内容,帮助盲人或弱视群体使用应用。现在有很多屏幕阅读器,例如Windows的 NVDA 和 JAWS ,Chrome的 ChromeVox ,以及OS X的 VoiceOver 。
当元素获得焦点时,屏幕阅读器会将该元素的相关信息朗读给用户听。因此,当浏览器的焦点落到 时,用户能通过视频阅读器了解到他们正在应对一个文本输入框(可以输入内容的东东)。但如果焦点落到了一个空的
为了解决这个问题,我们可以参考 WAI-ARIA (Web无障碍标准计划 - 无障碍富互联网应用),通过添加特殊的ARIA属性提高组件标签的语义化。这些额外语法能帮助阅读器分辨界面上的属性、关系和状态。ARIA的详细使用说明可以在 WAI-ARIA开发实践 找到。
我们对键盘支持的目标是可以完全通过键盘使用组件。WAI-ARIA为 许多UI控件 定义了行为和键盘交互方式。如果想知道组件应支持什么按键,可在文档中寻找并参考类似组件。例如,多选组件与 组合框 类似。
除了支持键盘操作,我们还应主动提示用户如何使用按键操作组件(例如,在应用中提供指引)。
这里会介绍组件的视觉无障碍问题。请保证你能对以下问题回答“是”:
记住,并不是所有有视力障碍的用户都 完全看不见 。有相当一部分用户是弱视或色盲。
现在,我们将通过前面提到的方法,提高多选组件的可访问性。以下是具体的步骤:
别忘了,你可以在文章的底部查看组件示例,或者通过 GitHub仓库 下载代码。
经验表明,我们最好优先使用原生HTML元素,而不是自定义组件。如果你可以使用内置无障碍功能的原生HTML控件,那么就尽量使用它。万不得已时,再自定义组件并使用ARIA属性。 在HTML页面中使用WAI-AIRA避免冗余 中有更详细的说明。
在这个例子中,多选组件是一个自定义组件,因此,我们需要使用ARIA属性。首先,让我们在 ARIA文档 中找到类似的组件。貌似多选组件与复合框组件比较相似。那么,根据 复合框描述 ,看看我们需要添加哪些ARIA属性。
根据指引,我们需要添加以下角色:
需要添加的ARIA状态属性:
我们可以直接将 combobox 和 listbox 角色添加到组件的标签中:
<div class="multiselect" role="combobox"> <div class="multiselect-field"></div> <div class="multiselect-popup"> <ul class="multiselect-list" role="listbox"> <content select="li"></content> </ul> </div></div>
为了给每个选项添加 option 角色,我们需要在 refreshItems 方法中遍历选项。当组件被创建时,这个方法会被调用。
multiselectPrototype.render = function() { this.attachHandlers(); this.refreshField(); this.refreshItems();};multiselectPrototype.refreshItems = function() { var itemElements = this.itemElements(); for(var i = 0; i < itemElements.length; i++) { var itemElement = itemElements[i]; // set role and aria-selected property of an item itemElement.setAttribute("role", "option"); itemElement.setAttribute("aria-selected", itemElement.hasAttribute("selected")); }};multiselectPrototype.itemElements = function() { return this.querySelectorAll("li");};
我们可以在 togglePopup 方法中为控件添加 aria-expanded 属性。该属性决定了显示还是隐藏该列表。
multiselectPrototype.togglePopup = function(show) { this._isOpened = show; this._popup.style.display = show ? "block" : "none"; // set aria-expanded property this._control.setAttribute("aria-expanded", show);};
我们还要根据每个选项的 selected 属性初始化它们的 aria-selected 属性。 aria-selected 属性用于表示选项的选中状态。我们可以通过 selectItem 方法和 unselectItem 方法更新该状态。
multiselectPrototype.selectItem = function(item) { if(!item.hasAttribute("selected")) { // set aria-selected property of selected item item.setAttribute("aria-selected", true); item.setAttribute("selected", "selected"); this.fireChangeEvent(); this.refreshField(); } this.close();};multiselectPrototype.unselectItem = function(item) { // set aria-selected property of unselected item item.setAttribute("aria-selected", false); item.removeAttribute("selected"); this.fireChangeEvent(); this.refreshField();};
ARIA属性添加好了。下一步是支持键盘操作。
打开 标准文档 ,阅读 Keyboard Interaction 部分,看看我们需要支持哪些操作。
以下是使用键盘操作多选框需要的基本按键:
Alt + Up/Down ArrowEscUp/Down ArrowEnterBackspace
支持键盘操作第一步是支持聚焦到组件。我们需要设置 tabindex 属性来完成这一步,该属性的行为依赖于它的值:
自定义组件的 tabindex 应该为 -1 或 0 ,因为我们无法知道元素在页面上的获得焦点的顺序。因此,我们将多选组件的 tabindex 设为了 0 。
<div class="multiselect-field" tabindex="0" aria-readonly="true"></div>
下一步是处理 keydown 事件:
multiselectPrototype.attachHandlers = function() { this._control.addEventListener("keydown", this.keyDownHandler.bind(this)); ...};
keyDownHandler 根据 event.which ,调用特定的按键处理函数。
multiselectPrototype.keyDownHandler = function(event) { switch(event.which) { case 8: // Backspace this.handleBackspaceKey(); break; case 13: // Enter this.handleEnterKey(); break; case 27: // Escape this.handleEscapeKey(); break; case 38: // Up Arrow event.altKey ? this.handleAltArrowUpKey() : this.handleArrowUpKey(); break; case 40: // Down Arrow event.altKey ? this.handleAltArrowDownKey() : this.handleArrowDownKey(); break; default: return; } // prevent native browser key handling event.preventDefault();};
一旦用户按下按键,我们便通过 event.preventDefault() 阻止默认行为。
用户可通过 Alt + Down Arrow 组合按键打开多选框,通过 Alt + Up Arrow 和 Esc 关闭多选框:
multiselectPrototype.handleAltArrowDownKey = function() { this.open();};multiselectPrototype.handleAltArrowUpKey = function() { this.close();};multiselectPrototype.handleEscapeKey = function() { this.close();};
open 和 close 方法会调用 togglePopup :
multiselectPrototype.open = function() { this.togglePopup(true);};multiselectPrototype.close = function() { this.togglePopup(false);};
首先,将每个选项的 tabindex 都设为 -1 ,这样我们便可以聚焦到它们。
multiselectPrototype.refreshItems = function() { var itemElements = this.itemElements(); for(var i = 0; i < itemElements.length; i++) { var itemElement = itemElements[i]; ... // 设置选项的tabindex属性 itemElement.setAttribute("tabindex", -1); } // 初始化聚焦选项的索引 this._focusedItemIndex = 0;};
_focusedItemIndex 属性保存了聚焦的选项的索引。
用户可通过 Up Arrow 和 Down Arrow 浏览选项。代码可通过刷新当前聚焦选项索引来实现浏览功能。
multiselectPrototype.handleArrowDownKey = function() { this._focusedItemIndex = (this._focusedItemIndex < this.itemElements().length - 1) ? this._focusedItemIndex + 1 // go to the next item : 0; // go to the first item this.refreshFocusedItem();};
当用户在列表底部按下 Down Arrow 时,阅读器会聚焦到第一个选项。
当用户在列表顶部按下 Up Arrow 时,阅读器会聚焦到最后一个选项。
multiselectPrototype.handleArrowUpKey = function() { this._focusedItemIndex = (this._focusedItemIndex > 0) ? this._focusedItemIndex - 1 // go to the previous item : this.itemElements().length - 1; // go to the last item this.refreshFocusedItem();};
refreshFocusedItem 方法会聚焦到索引为 _focusedItemIndex 的选项:
multiselectPrototype.refreshFocusedItem = function() { this.itemElements()[this._focusedItemIndex].focus();};
最后,我们需要修改 open 和 close 方法。使得当多选框被打开时,阅读器会自动聚焦到 _focusedItemIndex 对应的选项,当多选框被关闭时,阅读器会聚焦到多选框容器。
multiselectPrototype.open = function() { this.togglePopup(true); this.refreshFocusedItem();};multiselectPrototype.close = function() { this.togglePopup(false); this._field.focus();};
现在我们可通过添加CSS,使得聚焦的选项看起来更突出:
::content li:focus { outline: dotted 1px #333; background: #efefef;}
用户可通过 Enter 按键选中当前聚焦的选项。如果多选框为打开状态,我们可以获得聚焦的选项,并通过 selectItem 方法选中它。
multiselectPrototype.handleEnterKey = function() { if(this._isOpened) { var focusedItem = this.itemElements()[this._focusedItemIndex]; this.selectItem(focusedItem); }};
用户可通过 Esc 取消最近一次的选择。如果当前有被选中的选项,我们可以通过 unselectItem 方法取消最近一次的选择。
multiselectPrototype.handleBackspaceKey = function() { var selectedItemElements = this.querySelectorAll("li[selected]"); if(selectedItemElements.length) { this.unselectItem(selectedItemElements[selectedItemElements.length - 1]); }};
现在我们支持了所有必要的键盘操作,因此用户可完全通过键盘操作组件。
多选框使用了相对单位 em ,它的大小依赖于容器的字体大小。因此,组件的字体大小是灵活的,如果有必要,我们可以轻松的增大字体。
弱视或有其它视觉障碍的用户有时会使用高对比度模式。OSX系统的用户可在设置中启用高对比度模式,Windows系统也提供了 高对比度主题 。除此之外,Chrome的扩展 High Contrast 也支持用户在浏览器中使用高对比度颜色。
一起来看看组件在高对比度模式的样子:
它看着还行,但是有一个问题:被选中的选项与其它选项看着区别不大。因此,我们可以稍微调整被选中的选项的颜色,来解决这个问题。
颜色无障碍是视觉无障碍的一个重要方面。互联网圈子中有许多用户是色盲。因此,我们不应完全依赖于颜色来传达重要信息。我们可以在灰度模式中检查组件(通常操作系统或某些软件都会提供这个功能)。由于多选组件本身就是灰色的,因此我们可以跳过这一步。
经过以上的优化,这里是最终的代码:
Multiselect Web Component by SitePoint ( @SitePoint ) on CodePen .
为了提高组件的可访问性,我们应该确保一下几点:
标签语义化,这样屏幕阅读器等辅助工具才能帮助用户使用组件。尽量使用原生的HTML控件,如果必须自定义控件,请添加有意义的ARIA属性。
可以完全通过键盘操作组件。通过 tabindex 使组件可被聚焦。参考ARIA实践指南实现键盘交互。
组件在高对比度模式和无色模式下也要能正常显示。
感谢你的阅读。欢迎大家评论,分享在web组件可访问性方面的经验。
标签: accessibility , keyboard accessibility , multiselect component , polymer , web components , X-Tag
英文原文: https://www.sitepoint.com/accessible-web-components/?utm_source=html5weekly&utm_medium=email