2.5.3 Etykieta w nazwie (ang.) Label in Name
Spis treści
Istota i cel kryterium
Kryterium dotyczy komponentów interfejsu, które mają widoczną etykietę w postaci tekstu lub obrazu tekstu. Ich nazwa dostępna (programistyczna) musi zawierać tekst prezentowany wizualnie. Nazwa może zawierać dodatkowe słowa (np. link „Więcej” z nazwą dostępną „Więcej informacji o usługach”), ale nie może pomijać ani zastępować widocznego tekstu. Najlepiej, gdy nazwa i etykieta są takie same, a jeśli nazwa jest dłuższa, widoczny tekst powinien znaleźć się na jej początku.
Dzięki temu osoby korzystające z oprogramowania do rozpoznawania mowy mogą aktywować element, wypowiadając tekst, który widzą na ekranie. Użytkownicy czytników ekranu słyszą natomiast to samo, co widzą.
Definicja w j. angielskim
Definicja dostępna pod adresem:
https://www.w3.org/WAI/WCAG22/quickref/#label-in-name
Definicja w j. polskim
Definicja dostępna pod adresem:
https://www.w3.org/Translations/WCAG21-pl/#etykieta-w-nazwie
Słownik pojęć
- Nazwa dostępna (ang.) accessible name
-
–
tekst, po którym technologie wspomagające rozpoznają i ogłaszają element interfejsu, np. „Szukaj” dla przycisku wyszukiwania. Przeglądarka ustala go na podstawie treści elementu, powiązanej etykiety (
<label>), atrybutualtalbo atrybutów ARIA (aria-label,aria-labelledby). Nazwa dostępna może być ukryta i przekazywana tylko technologiom wspomagającym, a etykietę widzą wszyscy użytkownicy. Często, choć nie zawsze, są takie same.
- Obrazy tekstu
-
–
grafiki, w których tekst zamiast w kodzie strony zapisano jako obraz (JPEG, PNG, BMP, GIF, TIFF itp.), zwykle po to, by uzyskać określony wygląd. Takiego tekstu nie da się powiększyć bez utraty jakości ani zmienić mu czcionki czy kolorów.
Za obraz tekstu nie uważa się napisu, który jest tylko jednym z elementów zdjęcia lub ilustracji, np. tabliczki z nazwą ulicy na fotografii miasta.
Wpływ na dostępność (Kogo wspierasz?)
- Użytkownicy oprogramowania do rozpoznawania mowy: Osoby sterujące komputerem za pomocą komend głosowych wypowiadają słowa widoczne na ekranie (np. „Kliknij Wyślij”). Jeśli nazwa dostępna różni się od widocznego napisu, oprogramowanie całkowicie zignoruje komendę, co wywołuje u użytkownika ogromną frustrację.
- Użytkownicy czytników ekranu: Osoby słabowidzące, łączące wzrokowe skanowanie strony z syntezą mowy, napotykają barierę, gdy czytnik anonsuje zupełnie inne słowa niż te obecne na ekranie. Zgodność eliminuje dezorientację i brak pewności, czy interakcja nastąpi z właściwym elementem.
- Użytkownicy z niepełnosprawnością poznawczą lub dysleksją: Niespójne komunikaty znacząco zwiększają obciążenie poznawcze. Przewidywalność i spójność interfejsu drastycznie zmniejsza zmęczenie psychiczne i eliminuje niepotrzebną frustrację.
- Użytkownicy z ograniczeniami sprawności manualnej (ruchowej): Osoby te bardzo często łączą korzystanie z oprogramowania do rozpoznawania mowy z fizycznymi urządzeniami wskazującymi (np. specjalnymi myszami, przełącznikami czy emulatorami klawiatury). Głosowe wywoływanie elementów interfejsu chroni ich przed fizycznym zmęczeniem i bólem, które wywołuje długotrwałe, precyzyjne celowanie kursorem w małe obiekty na ekranie. Gdy widoczny tekst pozwala im natychmiast aktywować przycisk głosem, drastycznie zmniejsza to liczbę wymaganych operacji manualnych.
- Użytkownicy powiększenia ekranu: Osoby korzystające z dużego powiększenia widzą jedynie mały wycinek interfejsu. Pełne dopasowanie etykiety wizualnej do nazwy programistycznej pomaga im błyskawicznie zrozumieć kontekst, nawet gdy nie widzą całego elementu naraz.
- Użytkownicy systemów sterowania głosem w sytuacjach mobilnych: Osoby pełnosprawne, które obsługują aplikacje bezdotykowo (np. podczas jazdy samochodem lub gotowania przy użyciu komend głosowych), napotykają tę samą barierę, co osoby z niepełnosprawnościami, jeśli nazwa kodowa przycisku różni się od napisu na ekranie.
Zasady wdrażania i wymagania techniczne
- Linki (
<a>): Zadbaj o to, aby tekst umieszczony między znacznikami stanowił jasną nazwę dostępną. Jeżeli stosujesz atrybutaria-labelw celu rozszerzenia kontekstu, musisz bezwzględnie powtórzyć w nim widoczną etykietę. Dla odnośnika „Więcej”, zapisaria-label="Więcej informacji o naszych usługach"jest w pełni poprawny, alearia-label="Szczegóły oferty"to najpoważniejsze uchybienie. - Przyciski (
<button>,<input type="button">): Umieszczaj widoczny tekst bezpośrednio jako zawartość przycisku. W przyciskach ikonowych zawierających tekst (np. grafika plus słowo „Dodaj”), nazwa dostępna musi zawierać to słowo. Jeśli przycisk wyświetla obraz tekstu (np. grafika z napisem „MENU”), nazwa programistyczna musi zawierać ten tekst. - Pola formularzy (
<input>,<textarea>,<select>): Łącz elementy formularza z natywnym znacznikiem<label>przy użyciu pasujących atrybutówidorazfor. Tekst z etykiety automatycznie wygeneruje prawidłową nazwę dostępną. Gdy używaszaria-labellubaria-labelledby, przypisz im wartość zawierającą widoczną etykietę. Tekst wplaceholdertraktuj jako etykietę wizualną tylko w ostateczności – wówczas nazwa dostępna musi go powielać. - Komponenty niestandardowe: Wykorzystaj atrybuty ARIA w autorskich elementach interfejsu w taki sposób, aby widoczny tekst etykiety został precyzyjnie wdrożony do wartości przekazywanej technologiom wspomagającym.
Wyjątki i sytuacje szczególne
Jeśli komponent interfejsu posiada wyłącznie ikonę będącą symbolem graficznym (np. ikona samej lupy bez jakichkolwiek liter czy słów) i nie zawiera tekstu ani obrazu tekstu, kryterium to nie nakłada wymogu inkluzji tekstu z tej ikony do nazwy dostępnej. Pamiętaj jednak, że taki element wciąż bezwzględnie musi posiadać poprawną nazwę dostępną (np. poprzez aria-label="Wyszukaj"), aby zapewnić podstawową dostępność UX.
Przykłady implementacji
Najczęstsze błędy
- F96: Najpoważniejsze uchybienie polegające na tym, że obliczona nazwa dostępna nie zawiera w sobie widocznego tekstu etykiety. Dzieje się tak, gdy deweloper używa atrybutu
do podania opisu, zapominając o włączeniu do niego oryginalnego tekstu, bądź gdy ukryte znaczniki przerywają ciąg znaków etykiety widocznej.aria-label - F111: Sytuacja, w której komponent posiada widoczną etykietę tekstową, ale całkowicie brakuje mu programistycznej nazwy dostępnej (np. podpis pod polem zrealizowany jako zwykły tekst w akapicie, bez powiązania za pomocą natywnego
<label>lub atrybutów ARIA). - Zaburzenie kolejności słów w nazwie dostępnej: Poważne uchybienie polegające na tym, że nazwa programistyczna zawiera wszystkie słowa z widocznej etykiety, jednak ich szyk w kodzie został zmieniony (np. na ekranie widnieje napis „Zaloguj się”, a w atrybucie
aria-labelwpisano „Się zaloguj”). Oprogramowanie do rozpoznawania mowy oczekuje naturalnej sekwencji słów – każda zmiana kolejności blokuje możliwość głosowej aktywacji elementu. - Rozdzielanie widocznych słów innymi wyrazami: Błąd polegający na wtrącaniu dodatkowych, niewidocznych słów pomiędzy wyrazy tworzące etykietę wizualną (np. na przycisku umieszczono tekst „Anuluj subskrypcję”, a nazwa dostępna w kodzie brzmi „Anuluj moją subskrypcję”). Takie wdrożenie przerywa ciągłość frazy, przez co użytkownik dyktujący komendę głosową opartą na tym, co widzi, nie uruchomi żądanej akcji.
- Nadpisanie nazwy pola, którego jedyną etykietą jest
placeholder: Gdy przy polu nie ma innego widocznego tekstu, etykietą w rozumieniu 2.5.3 może być tekstplaceholder. Błędem jest wtedyaria-labellubaria-labelledby, które nadpisują nazwę dostępną tekstem niezawierającym tekstu placeholdera (np. placeholder „Szukaj”, aaria-label="Wyszukiwarka produktów"). Samo użycie placeholdera zamiast etykiety nie łamie 2.5.3, bo obliczanie nazwy dostępnej uwzględnia jego tekst. W3C nie uważa jednak placeholdera za właściwy sposób podania etykiety, dlatego lepiej dodać widoczny<label>. - Automatyczne generowanie nazw przez frameworki: Poleganie na skryptach, które generują losowe lub generyczne nazwy programistyczne, całkowicie oderwane od widocznego dla użytkownika tekstu.
Najlepsze praktyki
- Używaj semantycznego HTML: Zawsze preferuj natywne rozwiązania systemowe (
<label>,<button>, tekst wewnątrz<a>) ponad skomplikowane i sztuczne konstrukcje ARIA. Gwarantują one wyrazistość bez kompromisów i najwyższą kompatybilność. - Zrozum hierarchię nadpisywania nazw: Pamiętaj, że atrybuty
aria-labelorazaria-labelledbyposiadają najwyższy priorytet i całkowicie usuwają tekst natywny. Stosuj je świadomie i zawsze powtarzaj w nich widoczny zwrot. - Zachowaj pełną spójność: Pilnuj, aby każdy interaktywny element z widocznym napisem posiadał programistyczną nazwę zawierającą ten napis na samym początku, co drastycznie ułatwi obsługę głosową.
- Wykonuj regularne audyty: Testuj interfejs na różnych etapach produkcji przy pomocy rzeczywistych technologii wspomagających w celu natychmiastowego wychwycenia niespójności.
Metody testowania
- Narzędzie deweloperskie (ang.) Developer Tools: Zweryfikuj w drzewie DOM (w zakładce dotyczącej dostępności / ułatwień dostępu), czy obliczona nazwa dostępna wybranego elementu interaktywnego zawiera w całości tekst prezentowany wizualnie na ekranie.
- NVDA: Uruchom czytnik ekranu i przejdź tabulatorem do testowanego komponentu. Oceń słuchowo, czy wypowiadana przez syntezator fraza zawiera słowa widoczne dla oka na przycisku lub odnośniku.
- (ang.) WAVE Evaluation Tool: Użyj tego narzędzia do błyskawicznego wykrywania błędów w strukturze pól formularzy oraz weryfikacji powiązań między komunikatami a etykietami.
- (ang.) IBM Equal Access Toolkit: Przeprowadź zautomatyzowany audyt strony, aby zweryfikować, czy dynamiczne zmiany w interfejsie nie powodują nadpisania nazw dostępnych w sposób niezgodny z widocznymi etykietami.
- ANDI.js: Wybierz moduł analizujący elementy interaktywne lub moduł graficzny. Narzędzie podświetli dany komponent i wskaże jego dokładną nazwę programistyczną, co pozwoli Ci od razu ocenić jej spójność z tekstem wizualnym.
Sprawdź swoją wiedzę
W linku poniżej znajduje się 6 modułów testowych. Twoim zadaniem jest sprawdzenie, czy nazwa dostępna (przekazywana technologiom wspomagającym) zawiera etykietę tekstową, którą widać na ekranie.
Jak to sprawdzić?
- Zbadaj element używając Narzędzi Deweloperskich w przeglądarce (F12).
- Przejdź do zakładki Dostępność (Accessibility).
- Odszukaj pole „Nazwa” (Name) lub „Obliczona nazwa” (Computed Name).
- Sprawdź, czy nazwa zawiera widoczny tekst – te same słowa, w tej samej kolejności, bez wstawionych innych słów. Wielkość liter i znaki interpunkcyjne nie mają znaczenia. Jeśli element nie ma widocznego tekstu (np. sama ikona), kryterium go nie dotyczy.
Proponowane narzędzia: Narzędzie deweloperskie (ang.) Developer Tools, NVDA, (ang.) WAVE Evaluation Tool
Notatka: Zanim zajrzysz do rozwiązania, przetestuj i zapisz swoje wnioski na kartce.
#1 DOBRZE
Dlaczego: Idealne i najbezpieczniejsze rozwiązanie. Użyto natywnego tekstu wewnątrz znacznika <button>. Nazwa programistyczna odczytana przez drzewo dostępności to w 100% „Wyślij formularz”, czyli dokładnie to samo, co widzi oko użytkownika.
#2 BŁĄD
Problem: Atrybut aria-label="Rozpocznij" całkowicie nadpisuje tekst na przycisku. Nazwa w kodzie to „Rozpocznij”, choć wizualnie widnieje „Szukaj”.
Dlaczego: To błąd F96. Użytkownik powie do mikrofonu „Kliknij Szukaj”, a oprogramowanie zignoruje komendę, bo technicznie przycisk ma inną nazwę.
Naprawa: Usuń aria-label (przycisk i tak już ma tekst) lub upewnij się, że jego wartość zawiera słowo „Szukaj”.
#3 BŁĄD
Problem: Widzimy tekst „Imię i nazwisko” nad polem, ale w kodzie to zwykły element <div>, niepowiązany z wejściem formularza.
Dlaczego: To błąd F111. Pole nie ma żadnej programistycznej nazwy dostępnej (accessible name), mimo że wizualnie posiada etykietę.
Naprawa: Zastąp <div> natywnym znacznikiem <label for="imie"> i dodaj id="imie" do inputa.
#4 DOBRZE
Dlaczego: Atrybut aria-label prawidłowo rozszerza kontekst linku, powtarzając widoczny tekst „Więcej” i dodając resztę frazy („informacji o usługach”). Został też umieszczony na początku nazwy, dzięki czemu użytkownik bez problemu aktywuje go głosem poleceniem „Więcej”.
#5 BŁĄD
Problem: Dodatkowe słowo „moją” zostało umieszczone w aria-label tuż pomiędzy wyrazami, które normalnie widzi użytkownik („Anuluj subskrypcję”).
Dlaczego: Kryterium wymaga, by nazwa dostępna zawierała tekst widoczny na ekranie. Nazwa „Anuluj moją subskrypcję” nie zawiera ciągu „Anuluj subskrypcję”, bo słowo „moją” rozdziela widoczne wyrazy. Polecenie głosowe „Kliknij Anuluj subskrypcję” może więc nie zadziałać.
Naprawa: Zmień atrybut na aria-label="Anuluj subskrypcję swojego konta" (widoczne słowa są koło siebie) lub całkowicie usuń ten atrybut.
#6 DOBRZE
Dlaczego: Przycisk składa się wyłącznie z ikony (SVG) i nie zawiera żadnego widocznego tekstu (w tym obrazów tekstu). Z racji tego, że nie ma fizycznej etykiety, zasada spójności „Label in Name” dla 2.5.3 naturalnie tu nie obowiązuje. Nadana mu etykieta aria-label="Dodaj do ulubionych" prawidłowo załatwia wymóg nazwy programistycznej dla czytników (4.1.2), a dla wzrokowców pozostaje ikonka.
Źródła
- Abou-Zahra S., Eggert E., Vanderheiden G. [i in.] (red.), „2.5.3 Label in Name Level A”, [w:] Web Content Accessibility Guidelines (WCAG) 2.2 Quick Reference, 2025, https://www.w3.org/WAI/WCAG22/quickref/#label-in-name [dostęp: 27.05.2026].
- Accessibility Guidelines Working Group Participants, „Understanding SC 2.5.3 Label in Name (Level A)”, [w:] WCAG 2.2 Understanding Docs, 2026, https://www.w3.org/WAI/WCAG22/Understanding/label-in-name.html [dostęp: 27.05.2026].
- Accessibility Guidelines Working Group Participants, „Technique F96: Failure due to the accessible name not containing the visible label text”, [w:] Techniques for WCAG 2.2, 2026, https://www.w3.org/WAI/WCAG22/Techniques/failures/F96 [dostęp: 27.05.2026].
- Accessibility Guidelines Working Group Participants, „Technique F111: Failure of Success Criteria 1.3.1, 2.5.3, and 4.1.2 due to a control with visible label text but no accessible name”, [w:] Techniques for WCAG 2.2, 2025, https://www.w3.org/WAI/WCAG22/Techniques/failures/F111 [dostęp: 27.05.2026].
- World Wide Web Consortium (W3C), „Kryterium sukcesu 2.5.3 Etykieta w nazwie”, [w:] Web Content Accessibility Guidelines (WCAG) 2.1, tłum. Fundacja Instytut Rozwoju Regionalnego, 2021, https://www.w3.org/Translations/WCAG21-pl/#etykieta-w-nazwie [dostęp: 27.05.2026].
- DOCK sp. z o.o., WCAG 2.5.3: Etykieta w nazwie, https://wcag.dock.codes/pl/dokumentacja/wcag-253/ [dostęp: 27.05.2026].
Dodatkowe linki
- W3C WCAG:
- Dokładna definicja: https://www.w3.org/WAI/WCAG22/quickref/#label-in-name
- Dokument pomocniczy W3C: https://www.w3.org/WAI/WCAG22/Understanding/label-in-name.html