Klawiatura

Co oznacza to kryterium

Każdą funkcję musi dać się wykonać przez interfejs klawiatury, bez szybkiego powtarzania naciśnięć lub trzymania klawisza przez określony czas. Może to być inna kontrolka osiągająca ten sam cel. Wyjątek dotyczy funkcji zależnej od całego toru ruchu, np. swobodnego malowania; samo przeciąganie go nie tworzy.

To pomaga osobom z ograniczeniami ruchowymi, korzystającym z klawiatur alternatywnych lub przełączników dostarczających klawisze, a także osobom niewidomym i słabowidzącym, które nie śledzą wskaźnika. Nie każdy tryb Switch Control emuluje klawiaturę. Semantyka i obsługa czytnika wymagają osobnej oceny.

Przykłady błędów i poprawek

Adres punktu: Tab, przerwa i aktywacja

Własna „Pracownia” pokazuje syntetyczne zamówienie #1042 i adres ul. Przykładowa 10. Wszystkie warianty mają te same dane. Materiały pochodzą z Flutter/Cupertino na iPhone 17 Simulator, iOS 26.5, z 2026-10-02.

1. W good Tab przenosi fokus na „Pokaż adres”. Adres pozostaje ukryty.
2. Po 7 sekundach bez działania Space ujawnia adres. Obserwator potwierdził odebranie klawisza; nie wykonywał akcji.
3. Dalszy Tab prowadzi do czyszczenia wyniku, wyboru wariantu i resetu. Space wykonuje te działania, a Shift+Tab prowadzi wstecz.

Fokus i rola przycisku bez działania

Problem

Tab osiąga Pokaż adres, ale odebrany Space nie ujawnia adresu. Kontrolka korzysta tylko z GestureDetector.onTap.

Skutek

Osoba obsługująca ekran klawiaturą nie może wykonać funkcji; w tym wariancie nie ma innej drogi.

Poprawka

Użyj standardowego CupertinoButton z tą samą akcją albo zapewnij własnej kontrolce pełną nawigację i aktywację klawiaturową.

Bad ma Focus, nazwę i semantyczną rolę przycisku, lecz nie ma ActivateIntent ani semantycznej akcji tap. Ograniczona semantyka wpływa także na inne wymagania; przykład nie izoluje wszystkich kryteriów.

Równoważna funkcja jest dostępna inną drogą

Control zachowuje pierwszą niesprawną kontrolkę i dodaje standardowy „Pokaż adres ponownie”. Space na pierwszej nie działa. Następny Tab osiąga alternatywę, a Space ujawnia ten sam adres. Pierwsze niepowodzenie nie wystarcza więc do negatywnej oceny całej funkcji. To kontrola ryzyka fałszywego alarmu, bez rekomendacji dublowania wadliwych przycisków.

Kiedy obowiązuje i gdzie są wyjątki

Interfejs klawiatury i tempo

Zakres obejmuje menu, dialogi, formularze, zmianę kolejności, powiększenie, media i funkcje pojawiające się po interakcji. Liczy się możliwość osiągnięcia wyniku, a nie tylko fokus lub nazwa kontrolki.

Interfejs klawiatury może odbierać klawisze z urządzenia fizycznego, alternatywnego sprzętu lub emulacji. MouseKeys zamieniające klawisze w ruch wskaźnika nadal używają interfejsu wskaźnika. Tap XCTest i akcja czytnika też nie potwierdzają klawiatury. Własna klawiatura ekranowa sterowana dotykiem nie zastępuje niezależnej od urządzenia usługi platformy; nie trzeba tworzyć własnej, gdy system już ją zapewnia.

Nie uzależniaj akcji od dwóch naciśnięć w krótkim oknie ani od określonego przytrzymania. Zwykłe naciśnięcia mogą mieć dowolne przerwy; uwzględnij ustawienia takie jak Sticky Keys. Osobny limit czasu procesu wymaga odrębnej oceny. Siedmiosekundowa próba jest jedną obserwacją, nie dowodem wszystkich odstępów. Enter i Space są konwencjami przycisku; 2.1.1 nie wymaga obu jednocześnie.

Funkcja zależna od toru ruchu

Swobodne malowanie zachowuje przebieg pociągnięcia, więc może korzystać z wyjątku. Wybór narzędzia i zapis nadal wymagają klawiatury. Rozpoznawanie pisma jest techniką wprowadzania tekstu; jego cel nie korzysta z tego wyjątku.

Przeniesienie karty do kolumny, zmiana kolejności zdjęć, prosta linia lub regularny kształt zależą od obiektu, punktów i wyniku. Dodaj „Przenieś do…”, „Wyżej/Niżej” lub współrzędne z obsługą klawiatury. Alternatywa wyłącznie dotykowa nie wystarczy dla 2.1.1. Tych scenariuszy drag/drop i rysowania nie wykonywano w źródle.

Duplikat kontrolki nie musi przyjmować klawiszy, jeśli ta sama lub porównywalna funkcja jest w pełni dostępna inną drogą. Pomocnicze G202/G90/H91 opisują inwentaryzację, równoważne klawisze i standardowe kontrolki. F54/F42/F55 wskazują wzorce handlera tylko dla wskaźnika, emulowanego linku i usuwania fokusu; nie są danymi o częstości ani automatycznym werdyktem.

Platformy

Klasyfikacja AI pochodzi z 2026-10-02. Dla WWW podstawą jest WCAG 2.2 Recommendation 2024-12-12, dla pozostałych środowisk informacyjne WCAG2ICT Group Note 2025-12-11. Nie jest to ustalenie obowiązku prawnego.

W hybrydzie oceń część webową, natywną i przejście między nimi. Brak testu nie wyłącza zastosowania.

Rozwiązania w technologiach

Fragmenty wykonują tę samą akcję co dotyk. Przegląd dokumentacji w źródle: 2026-10-02. Build Fluttera nie potwierdza pozostałych implementacji.

import 'package:flutter/cupertino.dart';

// Wewnątrz build; showAddress wykonuje tę samą funkcję co dotyk.
CupertinoButton(
  onPressed: showAddress,
  child: const Text('Pokaż adres'),
)

import androidx.compose.material3.Button
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable

@Composable
fun AddressAction(showAddress: () -> Unit) {
    Button(onClick = showAddress) { Text("Pokaż adres") }
}

import SwiftUI

struct AddressAction: View {
    let showAddress: () -> Void
    var body: some View {
        Button("Pokaż adres (⌘⇧A)", action: showAddress)
            .keyboardShortcut("a", modifiers: [.command, .shift])
    }
}

import { Button } from 'react-native';

export function AddressAction({ showAddress }: { showAddress: () => void }) {
  return <Button title="Pokaż adres" onPress={showAddress} />;
}

<button type="button">Pokaż adres</button>

Jak sprawdzić

1. Spisz funkcje i ich cele, w tym stany pośrednie, podmenu, przewijanie i gesty. Dla wyjątku uzasadnij zależność od całej trajektorii.
2. Zapisz system, odbiornik, wejście, układ i ustawienia. Oddziel klawiaturę aplikacji, FKA, VoiceOver i emulację wskaźnika.
3. Bez dotyku nawiguj i aktywuj komendami platformy. Sprawdź wynik, zrób przerwę między klawiszami i zbadaj reguły czasu w handlerach.
4. Po nieskutecznej kontrolce sprawdź równoważne drogi. Zapisz wysłane/odebrane zdarzenia, fokus i wynik; brak odbioru jest ograniczeniem próby.
5. Sprawdź pozostałe funkcje i osiągnięte stany. Screenshot, callback, drzewo lub tap nie zastępują tej sekwencji.

Weryfikacja i ograniczenia

Historyczne wykonanie 2026-10-02 dotyczy wyłącznie opisanej trasy: ujawnienia adresu, czyszczenia, wyboru wariantu i resetu. XCTest wysyłał klawisze do uruchomionego Fluttera; HardwareKeyboard obserwował je, zwracając false.

Nie nagrywano filmu/audio. Fokus pochodzi z Fluttera, nie z FKA czy VoiceOver. Drzewo i nazwa nie ujawniają wszystkich alternatyw. Wynik dotyku nie rozstrzyga klawiatury, a skończone próbki odstępów nie potwierdzają wszystkich czasów. Niezależnego walidatora nie uruchomiono; metadane oczekiwań, warianty i węzeł obserwatora powinny pozostać poza jego wejściem. Brak znaleziska przy niepełnej inwentaryzacji nie oznacza spełnienia wymagania.

Jak sprawdza Clearship

Metoda z 2026-10-07 porównuje na Androidzie funkcje dostępne dotykiem ze stanami fokusu i aktywacją w przejściu klawiatury. Wskazuje kandydatów: cel nieosiągalny, brak skutku Space/Enter przy działającym tap lub instrukcję gestu bez drogi klawiaturowej. Pomiar kontrolny 16/18, bez fałszywych alarmów na 80 poprawnych ekranach, nie spełnił progu; wynik wymaga człowieka.

Fokus poza drzewem, możliwa równoważna droga i nieosiągnięty stan pozostają nierozstrzygnięte. Funkcje bez akcji i instrukcji w drzewie, tempo klawiszy, inne skróty i osobna treść webowa nie są oceniane. iOS nie ma tego przejścia klawiatury ani pomiaru. Researchowa próba iOS z tego artykułu nie jest wykonaniem analizatora produktu.

Powiązane kryteria

• 2.1.2
  Brak pułapki na klawiaturę

  Możliwość wyjścia z obszaru jest odrębna od aktywacji funkcji.

• 2.1.4
  Skróty klawiaturowe ze znaków

  Skróty ze znaków wymagają ochrony przed przypadkową aktywacją.

• 2.5.1
  Gesty wskazujące

  Alternatywa gestu musi mieć właściwe wejście; sam przycisk dotykowy nie potwierdza klawiatury.

• 2.5.7
  Przeciąganie

  Przeciąganie wymaga odrębnej oceny drogi bez przeciągania.