Nazwa, rola, wartość

Co oznacza to kryterium

Kontrolka powinna przekazywać oprogramowaniu, czym jest, do czego służy oraz jaki ma bieżący stan lub wartość. Użytkownik czytnika musi móc rozpoznać przełącznik, dowiedzieć się, czy jest włączony, i go zmienić. Pole udostępnia wpisaną wartość oddzielnie od swojej nazwy. Zmiany muszą być dostępne dla odbiorców, w tym technologii asystujących.

To pomaga osobom niewidomym korzystającym z czytnika lub brajla, osobom z ograniczeniami ruchowymi używającym sterowania głosem lub przełączników oraz osobom słabowidzącym, których oprogramowanie śledzi fokus. Sam dotyk, narysowany obrys lub tekst na ekranie nie potwierdzają tych sposobów obsługi.

Przykłady błędów i poprawek

Jeden wybór, trzy odmienne usterki

Własna „Pracownia” pokazuje ustawienia powiadomień dla syntetycznego zamówienia P-104. Użytkownik włącza „Powiadomienia o odbiorze” i wpisuje kod P-104. Początkowo wybór jest wyłączony, a pole puste. Przykład niczego nie wysyła ani nie utrwala.

WWW good/name/role/bad zachowują identyczne dane, wygląd i wejście. Zmienia się wybrana część semantyki. Poniższa tabela podaje odczyty rzeczywistego drzewa AX i DOM w przeglądarce na macOS z 2026-10-04, bez przypisywania im odczytu przez czytnik.

Nieaktualny stan

Aktualny stan

Surowe JPEG z Codex IAB/macOS, 2026-10-04. Odczyty i obrazy są sekwencyjne. Różny obrys fokusu wynika z wejścia wskaźnikiem lub klawiaturą i nie jest badaną usterką. Semantyki nie można wywnioskować z samych pikseli.

Problem

Widoczna etykieta, reagowanie na Space i zmiana koloru nie zapewniają nazwy, roli ani aktualnego stanu.

Skutek

Użytkownik może nie wiedzieć, czego dotyczy wybór, albo otrzymać informację Wyłączone po jego włączeniu.

Poprawka

Powiąż nazwę, zastosuj właściwą rolę oraz aktualizuj stan przez usługi dostępności wraz z modelem. Sprawdź też dostępną akcję i odbiór zmian przez docelową technologię asystującą.

Pole i standardowa kontrolka

WWW good i control udostępniały text field „Kod odbioru”, właściwość settable oraz wartość P-104 po wpisaniu. W ponowieniu iOS każdy wariant miał TextField z tą nazwą i wartością po typeText. Puste native value wynosiło dokładnie pusty tekst; placeholder „Np. P-104” występował w label. Nie należy utożsamiać placeholdera, nazwy i wartości.

Kontrolą Fluttera był CupertinoSwitch z nazwą ze scalonego wiersza. Brak własnego identyfikatora testowego nie był brakiem nazwy. Osobny wariant bez roli pokazano tylko na WWW: flaga toggled Fluttera wiąże stan binarny z semantyką przełącznika.

Kiedy obowiązuje i gdzie są wyjątki

Co ma przekazywać kontrolka

Wymaganie dotyczy wszystkich komponentów interfejsu, również standardowych i tworzonych skryptem. Jedna postrzegana kontrolka realizuje odrębną funkcję; liczba elementów DOM lub widżetów nie określa liczby kontrolek. Odrębne części wielopolowego wejścia potrzebują własnej identyfikacji.

Programowe ustawienie nie wymaga publicznego endpointu ani nieograniczonego zapisu każdej właściwości. Wymagane właściwości zależą od funkcji: nie każda kontrolka ma wartość liczbową, zaznaczenie lub możliwość edycji.

Standardowe komponenty i relacje z innymi wymaganiami

4.1.2 nie zawiera listy wyjątków dla własnych kontrolek. Standardowy komponent może realizować wymaganie, gdy użyto go zgodnie ze specyfikacją i nie uszkodzono semantyki. Statyczny akapit i dekoracja nie są kontrolkami; ukrycie działającego przycisku przed AT nie czyni go dekoracją.

Nazwa może być niewidoczna — 4.1.2 samo nie wymaga widocznej etykiety. Niepusta nazwa o błędnym znaczeniu albo rola przycisku dla suwaka nie wystarczą. Identyczne nazwy kilku elementów nie są automatycznie błędem: oceń funkcję i kontekst. Fokus klawiatury, fokus AT i wizualne zaznaczenie mogą się różnić.

Nie trzeba dodawać aria-live ani ręcznie odczytywać każdego przełączenia. Dublowanie standardowych komunikatów może przeszkadzać. Zewnętrzny komunikat „Zapisano” należy też do 4.1.3 i nie zastępuje checked kontrolki. ARIA nie dodaje obsługi klawiatury ani akcji. Przy złożonym comboboxie zbadaj także relacje, rozwinięcie, zaznaczenie i aktywnego potomka; sama nazwa nie pokrywa wszystkiego.

Platformy

Interpretacja AI z 2026-10-04: WCAG 2.2 dla WWW, informacyjna WCAG2ICT 2.2, Group Note 2025-12-11, dla dokumentów i oprogramowania. Zastosowanie nie jest potwierdzonym wykonaniem ani oceną obowiązku prawnego.

Statyczny akapit nie spełnia warunku, ale nie wyłącza platformy. W hybrydzie rozdziel WWW i część natywną.

Rozwiązania w technologiach

Preferuj standardową kontrolkę z nazwą i wspólnym bieżącym stanem. Dokumentację poniższych API przejrzano w źródle 2026-10-04; fragmenty nie tworzą osobnych aplikacji.

import 'package:flutter/cupertino.dart';
// W State: bool enabled = false;
MergeSemantics(
  child: Row(children: [
    const Expanded(child: Text('Powiadomienia o odbiorze')),
    CupertinoSwitch(
      value: enabled,
      onChanged: (value) => setState(() => enabled = value),
    ),
  ]),
)

import SwiftUI

struct PickupNotifications: View {
    @State private var enabled = false
    var body: some View {
        Toggle(isOn: $enabled) {
            Text("Powiadomienia o odbiorze")
        }
    }
}

import androidx.compose.material3.Switch
import androidx.compose.runtime.*
import androidx.compose.ui.Modifier
import androidx.compose.ui.semantics.contentDescription
import androidx.compose.ui.semantics.semantics

@Composable
fun PickupNotifications() {
    var enabled by remember { mutableStateOf(false) }
    Switch(
        checked = enabled,
        onCheckedChange = { enabled = it },
        modifier = Modifier.semantics {
            contentDescription = "Powiadomienia o odbiorze"
        }
    )
}

import React, { useState } from 'react';
import { Switch } from 'react-native';

export function PickupNotifications() {
  const [enabled, setEnabled] = useState(false);
  return (
    <Switch
      accessibilityLabel="Powiadomienia o odbiorze"
      value={enabled}
      onValueChange={setEnabled}
    />
  );
}

<label>
  <input type="checkbox" />
  Powiadomienia o odbiorze
</label>
<label for="pickup-code">Kod odbioru</label>
<input id="pickup-code" type="text" />

Jak sprawdzić

1. Dla każdej postrzeganej kontrolki ustal funkcję, nazwę, rolę, wymagane stany/wartości oraz właściwą akcję.
2. Odczytaj rzeczywiście udostępnioną semantykę przed wejściem; pobliski tekst i ID testowy nie zastępują dostępnej nazwy.
3. Aktywuj tę samą kontrolkę, edytuj pole i porównaj aktualną informację z UI. Zbadaj kolejne cykle i reset; dobry stan off nie ujawnia stale false po włączeniu.
4. Osobno wykonaj dostępną akcję przez docelową AT i sprawdź odbiór informacji o zmianie. Monitor zdarzeń jest potrzebny, gdy oceniasz ich emisję niezależnie od mowy.
5. Zachowaj zakres, metodę, stany i niewykonane próby. Uwzględnij czas mostu, animację, ukryte elementy i wirtualizację.

Weryfikacja i ograniczenia

Pierwsza próba ponowienia iOS miała błąd sterownika: tap w środek scalonego wiersza nie trafił w wizualny switch control. Po zmianie punktu sterownika końcowe próby przeszły; nie była to naprawa stanu produktu. Przyczyna wcześniejszego zawieszenia buildu pozostała nieustalona. To historia istotna dla interpretacji wyniku, bez powielania surowych logów.

Drzewo przed/po potwierdza zawartość semantyki, bez dowodu emisji zdarzenia, odbioru czytnikiem lub obsługi głosem. Nie ma filmu ani audio czytnika. Screenshot nie zawiera niewidocznej semantyki. AI może oceniać zgodność nazwy z funkcją, ale to interpretacja. Standardowe API również wymaga kontroli rzeczywistego mostu. Checker znanych wariantów bada integralność i oczekiwania demonstracji, bez pomiaru skuteczności walidatora.

Jak sprawdza Clearship

Katalog z 2026-10-07 określa ocenę częściową. Reguły drzewa wskazują m.in. kontrolkę bez nazwy lub wymaganej informacji o stanie; Android może też wskazać akcję dotyku bez roli. Porównanie dotkniętej kontrolki przed/po szuka zmiany wyglądu bez zmiany semantyki, z ograniczonymi danymi zdarzeń Androida. Pomiar na fixture Androida nie jest pomiarem iOS.

Audyty platformowe i wskazówki AI dostarczają innych kandydatów. Żadna z tych metod nie potwierdza programowego ustawienia przez AT ani odbioru powiadomień. Niedotknięte kontrolki, nieobserwowalne dane i iOS bez zdarzeń wymagają dalszej oceny. Wynik nie potwierdza pełnego 4.1.2; niewykonane próby pozostają jawne.

Powiązane kryteria

• 1.1.1
  Treści nietekstowe

  Nazwa akcji jest częścią alternatywy jej ikony.

• 1.3.1
  Informacje i relacje

  Relacje etykiet i struktury mogą mieć wspólną usterkę.

• 2.1.1
  Klawiatura

  Nazwa i rola same nie dodają obsługi klawiaturą.

• 2.5.3
  Etykieta w nazwie

  Widoczna etykieta musi znaleźć się w nazwie.

• 3.3.2
  Etykiety lub instrukcje

  Instrukcja przed wpisaniem danych jest odrębna od programowej nazwy.

• 4.1.3
  Komunikaty o stanie

  Komunikat o stanie poza kontrolką ma odrębny warunek.