Kurs Angular · Moduł 12: Bezpieczeństwo i wydajność
Accessibility (a11y)
W tej lekcji5
Dostępność to jak budowanie zamku z bramami dla wszystkich gości:
Podstawy Dostępności
@Component({
template: `
<!-- Semantyczny HTML -->
<nav aria-label="Główna nawigacja">
<ul>
@for (link of navLinks; track link.path) {
<li>
<a [routerLink]="link.path"
[attr.aria-current]="isActive(link.path) ? 'page' : null">
{{ link.label }}
</a>
</li>
}
</ul>
</nav>
<!-- Formularze dostępne -->
<form>
<label for="samuraiName">Imię samuraja</label>
<input
id="samuraiName"
type="text"
[attr.aria-invalid]="nameControl.invalid"
[attr.aria-describedby]="nameControl.invalid ? 'nameError' : null"
>
@if (nameControl.invalid) {
<span id="nameError" role="alert">
Imię jest wymagane
</span>
}
</form>
<!-- Przyciski z opisem -->
<button
(click)="deleteSamurai()"
[attr.aria-label]="'Usuń samuraja ' + samurai.name">
<mat-icon>delete</mat-icon>
</button>
<!-- Live regions dla dynamicznych treści -->
<div aria-live="polite" class="sr-only">
{{ statusMessage() }}
</div>
`
})
export class AccessibleComponent {
// Screen reader only class
// .sr-only { position: absolute; width: 1px; height: 1px; ... }
}Focus Management
@Component({
template: `
<dialog #dialog>
<h2>Tytuł dialogu</h2>
<button #closeBtn (click)="close()">Zamknij</button>
</dialog>
`
})
export class DialogComponent implements AfterViewInit {
@ViewChild('dialog') dialog!: ElementRef<HTMLDialogElement>;
@ViewChild('closeBtn') closeBtn!: ElementRef<HTMLButtonElement>;
private previousFocus: Element | null = null;
open(): void {
this.previousFocus = document.activeElement;
this.dialog.nativeElement.showModal();
this.closeBtn.nativeElement.focus();
}
close(): void {
this.dialog.nativeElement.close();
(this.previousFocus as HTMLElement)?.focus();
}
}Pułapka fokusu w modalu: cdkTrapFocus
Gdy otwarty jest modal zbudowany ze zwykłych elementów <div>, klawisz Tab potrafi wyprowadzić fokus poza okno, na elementy strony, których użytkownik w tej chwili nie widzi. Pakiet @angular/cdk ma na to gotową dyrektywę cdkTrapFocus z modułu A11yModule (@angular/cdk/a11y): wystarczy dodać ją jako atrybut elementu okna, a Tab i Shift+Tab będą krążyć tylko po elementach wewnątrz niego. Razem z role="dialog", aria-modal="true" i etykietą aria-label czytnik ekranu wie, że ma do czynienia z oknem dialogowym i jak się ono nazywa.
import { Component } from '@angular/core';
import { A11yModule } from '@angular/cdk/a11y';
@Component({
selector: 'app-confirm-dialog',
standalone: true,
imports: [A11yModule],
template: `
<div role="dialog" aria-modal="true" aria-label="Potwierdzenie" cdkTrapFocus cdkTrapFocusAutoCapture>
<p>Czy na pewno opuścić dojo?</p>
<button (click)="confirm()">Tak</button>
<button (click)="cancel()">Nie</button>
</div>
`
})
export class ConfirmDialogComponent {
confirm(): void {}
cancel(): void {}
}cdkTrapFocusAutoCapture przenosi fokus do okna od razu po jego otwarciu, a po zamknięciu oddaje go elementowi, który był aktywny wcześniej.
Keyboard Navigation
@Directive({
selector: '[appKeyboardNav]',
standalone: true
})
export class KeyboardNavDirective {
@HostListener('keydown', ['$event'])
onKeyDown(event: KeyboardEvent): void {
const items = this.getNavigableItems();
const currentIndex = items.indexOf(document.activeElement as HTMLElement);
switch (event.key) {
case 'ArrowDown':
event.preventDefault();
items[(currentIndex + 1) % items.length]?.focus();
break;
case 'ArrowUp':
event.preventDefault();
items[(currentIndex - 1 + items.length) % items.length]?.focus();
break;
case 'Home':
event.preventDefault();
items[0]?.focus();
break;
case 'End':
event.preventDefault();
items[items.length - 1]?.focus();
break;
}
}
private getNavigableItems(): HTMLElement[] {
return Array.from(
this.el.nativeElement.querySelectorAll('[tabindex="0"], button, a')
);
}
}Testowanie Dostępności
# Lighthouse audit
npm install -g lighthouse
lighthouse http://localhost:4200 --only-categories=accessibility
# axe-core w testach
npm install axe-core @axe-core/playwrightHasła z dokumentacji w tej lekcji
Widzisz błąd w tej lekcji?
Sprawdź się
Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.
1. Do czego służy atrybut aria-live="polite"?
2. Po co dodajemy aria-label do przycisku zawierającego tylko ikonę (np. <mat-icon>delete</mat-icon>)?
To 2 z 4 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Edytor kodu
Uzupełnij dostępny modal z właściwymi atrybutami ARIA.
- Układanie w poziomie
Ułóż otwierający znacznik nawigacji z etykietą dla czytnika ekranu (od lewej):
- Układanie w pionie
Uporządkuj kroki metody open() zarządzającej focusem w dialogu (kolejność od góry):
- Klikanie w kolejności
Zbuduj atrybut określający semantykę okna dialogowego (klikaj w kolejności):