Angular 无障碍性
Angular 中的无障碍功能
Web 会被各种各样的人使用,包括有视觉或运动障碍的人。有多种辅助技术能使这些人更轻松地和基于 Web 的软件应用进行交互。另外,将应用设计得更易于访问通常也能改善所有用户的体验。
关于如何设计无障碍应用的问题和技术的深入介绍,参阅 Google 网络基础知识的无障碍功能部分。
本页讨论了设计 Angular 应用的最佳实践,这些实践对所有用户(包括依赖辅助技术的用户)都适用。
无障碍属性(Attribute)
建立无障碍的 Web 体验通常会涉及设置 ARIA 属性(Attribute) 以提供可能会丢失的语义。使用 Attribute 绑定模板语法来控制与无障碍性相关的属性(Attribute)值。
在 Angular 中绑定 ARIA 属性(Attribute)时,必须使用 attr.
前缀,因为 ARIA 规范针对的是 HTML 属性(Attribute),而不是 DOM 元素的属性(Property)。
<!-- Use attr. when binding to an ARIA attribute -->
<button [attr.aria-label]="myActionLabel">…</button>
注意
此语法仅对于属性(Attribute)绑定是必需的。静态 ARIA 属性(Attribute)不需要额外的语法。<!-- Static ARIA attributes require no extra syntax --> <button aria-label="Save document">…</button>
按照约定,HTML 属性(Attribute)使用小写名称(
tabindex
),而 Property 使用 camelCase 名称(tabIndex
)。
Angular UI 组件
由 Angular 团队维护的 Angular Material 库是旨在提供完全无障碍的一组可复用 UI 组件。组件开发工具包(CDK)中包括 a11y 软件包,该软件包提供了支持无障碍领域的各种工具。比如:
-
LiveAnnouncer
用于使用 aria-live
区域向屏幕阅读器用户朗读消息。关于 aria-live 领域的更多信息,参阅 W3C 文档。 -
cdkTrapFocus
指令能将 Tab 键焦点捕获在元素内。使用它可为必须限制焦点的模态对话框之类的组件创建无障碍体验。
关于这些工具和其它工具的完整详细信息,参阅 Angular CDK 无障碍功能概述。
增强原生元素
原生 HTML 元素捕获了许多对无障碍性很重要的标准交互模式。在制作 Angular 组件时,应尽可能直接复用这些原生元素,而不是重新实现已获良好支持的行为。
比如,你可以创建一个组件,它使用属性(Attribute)选择器指向原生 <button>
元素,而不是为各种新按钮创建自定义元素。通常这适用于 <button>
和 <a>
,但也可以用于许多其它类型的元素。
你可以在 Angular Material 中看到此模式的范例:MatButton,MatTabNav,MatTable。
将容器用于原生元素
有时要使用的原生元素需要一个容器元素。比如,原生 <input>
元素不能有子元素,因此任何自定义的文本输入组件都需要用其它元素来包装 <input>
。尽管你可能只在自定义组件的模板中包含 <input>
,但这将使该组件的用户无法为 input
元素设置任意 Property 和 Attribute。相反,你可以创建一个使用内容投影的容器组件,以将原生控件包含在组件的 API 中。
你可以把 MatFormField 作为该模式的例子。
案例研究:构建自定义进度条
以下范例显示如何通过使用宿主(host)绑定来控制与无障碍性相关的属性(Attribute),来把进度条无障碍化。
- 该组件使用标准的 HTML 属性(Attribute)
role
和 ARIA 属性(Attribute)来定义要启用无障碍支持的元素。ARIA 属性(Attribute)aria-valuenow
绑定到用户的输入。
import { Component, Input } from '@angular/core';
/**
* Example progressbar component.
*/
@Component({
selector: 'app-example-progressbar',
template: '<div class="bar" [style.width.%]="value"></div>',
styleUrls: ['./progress-bar.component.css'],
host: {
// Sets the role for this component to "progressbar"
role: 'progressbar',
// Sets the minimum and maximum values for the progressbar role.
'aria-valuemin': '0',
'aria-valuemax': '100',
// Binding that updates the current value of the progressbar.
'[attr.aria-valuenow]': 'value',
}
})
export class ExampleProgressbarComponent {
/** Current value of the progressbar. */
@Input() value = 0;
}
aria-label
属性(Attribute)可以确保屏幕阅读器能访问该控件。<label>
Enter an example progress value
<input type="number" min="0" max="100"
[value]="progress" (input)="setProgress($event)">
</label>
<!-- The user of the progressbar sets an aria-label to communicate what the progress means. -->
<app-example-progressbar [value]="progress" aria-label="Example of a progress bar">
</app-example-progressbar>
路由
导航后的焦点管理
在设计无障碍性时,在 UI 中跟踪和控制焦点是很重要的考虑因素。使用 Angular 路由时,你需要确定页面焦点在导航上的位置。
为了避免仅仅依靠视觉提示,你需要确保路由代码会在页面导航之后更新焦点。使用 Router
服务中的 NavigationEnd
事件可以知道何时该更新焦点。
以下范例显示了导航后如何在 DOM 中查找并把焦点移动到主体内容的头部。
router.events.pipe(filter(e => e instanceof NavigationEnd)).subscribe(() => {
const mainHeader = document.querySelector('#main-content-header')
if (mainHeader) {
mainHeader.focus();
}
});
在实际的应用程序中,哪些元素获得焦点将取决于该应用特有的结构和布局。获得焦点的元素应使用户能够立即移动到刚刚进入视野的主要内容。你应该避免当路由变化后焦点重新回到 body
元素的情况。
活动链接标识
用在活跃 RouterLink
元素上的 CSS 类(一般通过 RouterLinkActive
来指定)提供了有关哪个链接正处于活跃状态的视觉指示。此类指示不适用于盲人或视障用户,为了提供此类信息,还要将 aria-current
属性应用于此元素(有关更多信息,参阅MDN aria-current)。
RouterLinkActive
指令提供了 ariaCurrentWhenActive
输入属性,该输入属性会在链接变为活跃状态时将 aria-current
设置为指定的值。
以下示例展示了如何将 active-page
类应用于活跃链接,以及如何在它们处于活跃状态时将它们的 aria-current
属性设置为 "page"
:
<nav>
<a routerLink="home"
routerLinkActive="active-page"
ariaCurrentWhenActive="page">
Home
</a>
<a routerLink="about"
routerLinkActive="active-page"
ariaCurrentWhenActive="page">
About
</a>
<a routerLink="shop"
routerLinkActive="active-page"
ariaCurrentWhenActive="page">
Shop
</a>
</nav>