zaplanuj wycenę
Poradniki techniczne

Dostępny formularz internetowy: etykiety, błędy, instrukcje i komunikat sukcesu

ok. 7 min czytania Aktualizacja: 2026 Zespół TwojaWizytówka.pl

Formularz jest dostępny dopiero wtedy, gdy użytkownik potrafi rozpoznać pola, wpisać dane, zrozumieć wymagania, poprawić błędy i potwierdzić wynik bez polegania wyłącznie na wzroku lub myszy. Samo dodanie aria-label do kilku pól nie naprawia całego procesu.

Krótka odpowiedź: każde pole połącz z trwałą, widoczną etykietą. Wymagania i format podaj przed wysłaniem, grupy kontrolek opisuj przez fieldset i legend, a autouzupełnianie wspieraj odpowiednimi typami i autocomplete. Błąd wskaż tekstem, powiąż z polem i przenieś uwagę do podsumowania w przewidywalny sposób. Po wysłaniu ogłoś status bez przeładowania oraz pokaż jednoznaczny komunikat sukcesu. Całość przejdź klawiaturą i czytnikiem ekranu.

Widoczny label zamiast samego placeholdera

Etykieta pozostaje widoczna po rozpoczęciu pisania i zwiększa obszar kliknięcia:

<label for="email">Adres e-mail</label>
<input id="email" name="email" type="email" autocomplete="email">

Placeholder znika po wpisaniu, często ma niski kontrast i bywa mylony z gotową wartością. Może podawać przykład, ale nie zastępuje nazwy pola.

Nie otaczaj każdego pola aria-label, jeśli istnieje prawidłowy widoczny <label>. Dostępna nazwa powinna odpowiadać widocznemu tekstowi.

Pola wymagane i instrukcje

Wyjaśnij symbol gwiazdki oraz użyj semantycznego required, jeśli wymaganie jest egzekwowane. Nie polegaj wyłącznie na czerwonym kolorze.

Instrukcje podaj przed wykonaniem błędu, np. wymagany format numeru lub zakres dat. Powiąż pomoc z polem przez aria-describedby:

<label for="telefon">Telefon</label>
<input id="telefon" name="telefon" type="tel" aria-describedby="telefon-pomoc">
<p id="telefon-pomoc">Wpisz 9 cyfr bez numeru kierunkowego kraju.</p>

Nie narzucaj formatu, którego biznes nie potrzebuje. Akceptowanie spacji i myślników bywa łatwiejsze niż zmuszanie użytkownika do poprawiania poprawnych danych.

Grupowanie kontrolek

Pytanie z kilkoma radio buttonami lub checkboxami powinno mieć wspólny opis:

<fieldset>
  <legend>Preferowany sposób kontaktu</legend>
  <label><input type="radio" name="kontakt" value="email"> E-mail</label>
  <label><input type="radio" name="kontakt" value="telefon"> Telefon</label>
</fieldset>

legend nadaje kontekst każdej opcji. Wizualny nagłówek w zwykłym <div> może go nie przekazać czytnikowi.

Typy pól i autouzupełnianie

Używaj type="email", type="tel" i odpowiednich wartości autocomplete. Pomaga to klawiaturom mobilnym, menedżerom haseł i osobom, które mają trudność z wielokrotnym wpisywaniem.

Nie blokuj wklejania do pól. Przy haśle zapewnij możliwość pokazania wartości dostępnym przyciskiem oraz komunikuj wymagania przed wysłaniem. CAPTCHA nie może być jedyną barierą wymagającą konkretnego zmysłu lub zdolności.

Walidacja w odpowiednim momencie

Agresywny błąd po wpisaniu pierwszej litery rozprasza i nie daje szansy dokończyć. Waliduj po opuszczeniu pola albo przy wysłaniu, a na żywo tylko wtedy, gdy informacja rzeczywiście pomaga.

Walidacja klienta poprawia wygodę, lecz serwer musi niezależnie sprawdzić dane. Dostępność nie zastępuje bezpieczeństwa.

Dostępny komunikat błędu

Dobry błąd:

  • nazywa problem;
  • wskazuje pole;
  • podpowiada korektę, jeśli jest znana;
  • nie usuwa pozostałych danych;
  • nie używa tylko koloru lub ikony;
  • jest programowo powiązany z polem.

Przykład:

<label for="email">Adres e-mail</label>
<input id="email" name="email" type="email"
       aria-invalid="true" aria-describedby="email-blad">
<p id="email-blad">Wpisz adres w formacie nazwa@domena.pl.</p>

Po nieudanym wysłaniu umieść na początku formularza podsumowanie z linkami do pól albo przenieś focus do pierwszego błędu, zależnie od złożoności. Nie przesuwaj focusu bez wyjaśnienia.

Stan wysyłania i sukces

Po kliknięciu przycisku zablokuj przypadkowe wielokrotne wysłanie, ale nie zostawiaj użytkownika bez informacji. Komunikat „Wysyłanie…” powinien być dostępny jako zmiana statusu, a przycisk zachować czytelny stan.

Sukces musi oznaczać przyjęcie zgłoszenia przez system, nie dostarczenie e-maila do firmy. W WordPressie wynik wp_mail() oznacza tylko, że wiadomość została przekazana dalej - nie, że dotarła. Jeśli formularz pokazuje sukces, a maile nie przychodzą, sprawdź kroki z poradnika formularz pokazuje sukces, ale e-mail nie dochodzi i skonfiguruj wysyłkę według instrukcji SMTP w WordPressie.

Użytkownikowi pokaż:

  • jednoznaczne potwierdzenie;
  • następny krok i przewidywany termin odpowiedzi, jeśli jest ustalony;
  • alternatywny kontakt w sprawach pilnych;
  • numer referencyjny, jeśli istnieje;
  • informację, czy formularz można wysłać ponownie.

Dynamiczny komunikat używa właściwego mechanizmu statusu lub live regionu. Nie ustawiaj wszystkiego jako agresywnego alertu, bo czytnik może przerywać inne informacje.

Kolejność i obsługa klawiaturą

Tab powinien przechodzić przez pola i przyciski w logicznej kolejności. Enter lub Spacja muszą aktywować kontrolki zgodnie z ich typem. Niestandardowy selektor daty, lista i upload wymagają kompletnego wzorca klawiaturowego.

Nie używaj dodatniego tabindex. Popraw strukturę DOM. Widoczny focus musi kontrastować z tłem, a sticky header nie może go zasłaniać.

Treść i prywatność

Pytaj tylko o dane potrzebne do celu. Jasno wyjaśnij, do czego służy formularz i gdzie znajduje się informacja o przetwarzaniu danych. Nie oznaczaj zgody marketingowej jako wymaganej do zwykłego kontaktu bez podstawy i przeglądu prawnego.

Komunikaty błędów nie powinny ujawniać danych technicznych ani wskazywać, czy konkretne konto istnieje, jeśli tworzy to ryzyko bezpieczeństwa.

Procedura testowa

  1. Wyłącz CSS i oceń strukturę oraz etykiety.
  2. Przejdź wszystko klawiaturą.
  3. Odczytaj każde pole czytnikiem ekranu.
  4. Wyślij pusty formularz.
  5. Wprowadź błędny format w każdym typie pola.
  6. Sprawdź podsumowanie i powrót do pól.
  7. Popraw dane bez ich utraty.
  8. Wyślij poprawnie i odczytaj status sukcesu.
  9. Sprawdź autouzupełnianie i telefon.
  10. Potwierdź zapis zgłoszenia niezależnie od e-maila.

Które kryteria WCAG 2.2 dotyczą formularza kontaktowego?

Opisane wyżej zasady wynikają z konkretnych kryteriów sukcesu WCAG 2.2. Najważniejsze dla typowego formularza kontaktowego:

  • 1.3.1 Informacje i relacje (A) - etykiety, grupy i instrukcje są powiązane z polami w kodzie, nie tylko wizualnie;
  • 1.3.5 Określenie celu danych wejściowych (AA) - pola z danymi użytkownika mają właściwe autocomplete;
  • 3.3.1 Identyfikacja błędu (A) i 3.3.3 Sugestie korekty błędów (AA) - błąd jest opisany tekstem i wiadomo, jak go poprawić;
  • 3.3.2 Etykiety lub instrukcje (A) - każde pole ma etykietę, a wymagania są podane przed wysłaniem;
  • 3.3.7 Zbędne wprowadzanie danych (A) - nowe w WCAG 2.2: w wieloetapowym procesie nie każ wpisywać ponownie danych podanych wcześniej;
  • 4.1.2 Nazwa, rola, wartość (A) - własne kontrolki przekazują swój stan technologiom wspomagającym;
  • 4.1.3 Komunikaty o stanie (AA) - „Wysyłanie…”, błędy i sukces są ogłaszane bez przenoszenia fokusu, jeśli strona się nie przeładowuje.

Szerszą listę kontrolną całej strony znajdziesz w artykule o dostępności strony internetowej według WCAG 2.2.

Najczęstsze błędy

  • placeholder jako jedyna etykieta;
  • błąd oznaczony samą czerwienią;
  • ogólny komunikat „niepoprawne dane”;
  • usunięcie wszystkich pól po błędzie;
  • focus pozostawiony na początku strony;
  • brak ogłoszenia stanu po AJAX;
  • niestandardowe checkboxy bez klawiatury;
  • blokowanie wklejania;
  • informacja o wymaganiach dopiero po błędzie;
  • uznanie sukcesu wp_mail() za dowód dostarczenia wiadomości.

Podsumowanie

Dostępny formularz łączy semantyczne etykiety, zrozumiałe instrukcje, łagodną walidację, powiązane błędy, logiczny focus i jednoznaczny status. Test musi obejmować cały proces, a nie tylko wygląd pól. Dzięki temu więcej osób potrafi skontaktować się z firmą, a zespół otrzymuje zgłoszenia o lepszej jakości.

Formularz na Twojej stronie WordPress gubi zgłoszenia lub nie wysyła maili? Naprawimy go jednorazowo – wycena indywidualna w 24 h, bez abonamentu.

naprawa formularza i poczty WordPress lub wsparcie techniczne

wróć do Wiedzy