Kurs Angular · Moduł 12: Bezpieczeństwo i wydajność

Accessibility (a11y)

3 min czytania ·
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/playwright

Hasł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. 1. Do czego służy atrybut aria-live="polite"?

  2. 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):

  1. PytanieARIA
  2. PytanieAtrybut aria-label
  3. PytanieRola role="alert"
  4. Zadanie z kodemPraktyka: Dostępność
  5. Ułóż w kolejnościDostępna nawigacja
  6. Ułóż w kolejnościOtwieranie dostępnego modala
  7. Kliknij w kolejnościBudowa role dialogu
  8. PytanieTestowanie dostępności
  9. WideoPodsumowanie modułu

Przydatne artykuły