Niestandardowe wzorce walidacji dla pól tekstowych
A pole tekstowe Akceptuje wszystko, co wpisuje użytkownik — ale czasami potrzebne są konkretne formaty. Adresy URL witryn, kody produktów, numery licencji, a nawet nazwy składające się wyłącznie z liter, mają wzorce, które czynią je prawidłowymi. Niestandardowe wzorce walidacji pozwalają precyzyjnie określić, jaki format jest akceptowalny, wychwytując błędy przed wysłaniem.
W tym przewodniku dowiesz się, jak dodawać niestandardowe wzorce walidacji do pól tekstowych w formularzach WordPress.
Czym są wzorce walidacji?
Koncepcja
Wzorce walidacji to reguły definiujące, które dane wejściowe są prawidłowe:
- „Musi zawierać tylko litery”
- „Musi to być prawidłowy adres URL”
- „Musi być zgodny z formatem ABC-1234”
- „Musi mieć dokładnie 10 znaków”
Jak oni pracują
- Użytkownik wpisuje tekst w polu tekstowym
- Podczas przesyłania (lub wpisywania) dane wejściowe są sprawdzane pod kątem zgodności ze wzorcem
- Jeśli pasuje: Walidacja przebiegła pomyślnie
- Jeśli nie: Wyświetla się komunikat o błędzie
Korzyści
- Jakość danych: Zapewnij spójne formaty
- Zapobieganie błędom: Wcześnie wyłapuj błędy
- Wskazówki dla użytkownika: Jasne oczekiwania
- Zgodność z dalszymi wersjami: Dane współpracują z innymi systemami
Wbudowane wzorce walidacji
Automatyczny kreator formularzy obejmuje typowe wzorce:
| Wzór | Waliduje | Przykład prawidłowego wejścia |
|---|---|---|
| Format adresu e-mail | [email chroniony] | |
| URL | Adresy URL witryn | https://example.com |
| Tylko litery | AZ, tylko AZ | John Smith |
| Tylko liczby | Tylko 0-9 | 12345 |
| Alfanumeryczny | Litery i cyfry | ABC123 |
| warunki indywidualne | Twój własny wzór wyrażenia regularnego | (zależy od wzoru) |
Korzystanie z wbudowanych wzorców
Krok 1: Dodaj pole tekstowe
- Otwórz formularz w A.F.B.
- Przeciągnij Tekst pole do utworzenia
- Kliknij, aby skonfigurować
Krok 2: Wybierz wzorzec walidacji
- Znajdź Wzorzec walidacji w ustawieniach
- Wybierz z listy rozwijanej:
- Brak (brak wzoru)
- URL
- Tylko litery
- Tylko liczby
- Alfanumeryczny
- warunki indywidualne
- Zapisać ustawienia
Krok 3: Walidacja testu
- Formularz podglądu
- Wypróbuj prawidłowe dane wejściowe — powinno przejść
- Spróbuj wprowadzić nieprawidłowe dane — powinien pojawić się błąd
Przykłady wzorców i przypadki użycia
Weryfikacja adresu URL
Używać do:
- Pole witryny internetowej
- Linki do portfolio
- Profile mediów społecznościowych
- Adresy URL referencyjne
Prawidłowe przykłady:
- https://example.com
- http://www.example.com/page
- https://example.com/path?query=value
Nieprawidłowe przykłady:
- example.com (brakujący protokół)
- www.example.com (brakujący protokół)
- tylko trochę tekstu
Tylko litery
Używać do:
- Imię/nazwisko (prosta walidacja)
- Nazwy miast
- Kody krajów
- Identyfikatory alfabetyczne
Prawidłowe przykłady:
- John
- Kowal
- NewYork
Nieprawidłowe przykłady:
- John123
- Nowy Jork (kosmos)
- O'Brien (apostrof)
Uwaga: Zasada „tylko litery” jest rygorystyczna. Zastanów się, czy potrzebujesz spacji, myślników lub akcentów.
Tylko liczby
Używać do:
- Numery identyfikacyjne
- Numery kont
- Ilość (jeśli nie jest używane pole liczbowe)
- Kody PIN
Prawidłowe przykłady:
- 12345
- 00123
- 9876543210
Nieprawidłowe przykłady:
- 123-456 (myślnik)
- 123.45 (liczba dziesiętna)
- 12345A
Alfanumeryczny
Używać do:
- Kody produktów
- Numery referencyjne
- Nazwy użytkowników
- Numer seryjny
Prawidłowe przykłady:
- ABC123
- User42
- PROD001
Nieprawidłowe przykłady:
- ABC-123 (myślnik)
- ABC 123 (spacja)
- ABC_123 (podkreślenie)
Niestandardowe wzorce walidacji (Regex)
Co to jest Regex?
Wyrażenia regularne (regex) to wzorce opisujące formaty tekstu:
^= Początek ciągu$= Koniec ciągu[A-Z]= Dowolna wielka litera[a-z]= Dowolna mała litera[0-9]= Dowolna cyfra{3}= Dokładnie 3 z poprzednich{2,5}= Pomiędzy 2 a 5 poprzednich+= Jeden lub więcej*= Zero lub więcej?= Opcjonalnie (zero lub jeden)
Tworzenie niestandardowych wzorów
- Wybierz „Niestandardowe” z listy rozwijanej walidacji
- Wprowadź swój wzór wyrażenia regularnego
- Test z różnymi danymi wejściowymi
Przykłady typowych niestandardowych wzorców
Kod pocztowy USA
Wzór: ^\d{5}(-\d{4})?$
Sprawdza:
- 12345 (5 cyfr)
- 12345-6789 (kod pocztowy+4)
Odrzucenia:
- 1234 (za krótkie)
- 123456 (za długie)
- ABCDE (litery)
Numer telefonu w USA
Wzór: ^\d{3}-\d{3}-\d{4}$
Sprawdza: 555-123-4567
W przypadku formatu elastycznego: ^\(?\d{3}\)?[-.\s]?\d{3}[-.\s]?\d{4}$
Sprawdza:
- 555-123-4567
- (555) 123-4567
- 555.123.4567
- 555 123 4567
Kod produktu (format ABC-1234)
Wzór: ^[A-Z]{3}-\d{4}$
Sprawdza:
- ABC-1234.
- XYZ-9999
- PRO-0001
Odrzucenia:
- abc-1234 (małe litery)
- AB-1234 (tylko 2 litery)
- ABC1234 (brak myślnika)
Tablica rejestracyjna (różne formaty)
Wzór (ogólny, amerykański): ^[A-Z0-9]{1,7}$
Sprawdza: 1-7 wielkich liter/cyfr
Karta kredytowa (format podstawowy)
Wzór: ^\d{4}[\s-]?\d{4}[\s-]?\d{4}[\s-]?\d{4}$
Sprawdza:
- 1234567890123456
- 1234 5678 9012 3456
- 1234-5678-9012-3456
Uwaga: Do faktycznych płatności należy używać właściwych procesorów płatności wraz z ich walidacją.
Nazwa użytkownika (litery, cyfry, podkreślenie)
Wzór: ^[a-zA-Z][a-zA-Z0-9_]{2,19}$
zasady:
- Zaczyna się na literę
- Łącznie 3-20 znaków
- Tylko litery, cyfry i podkreślenie
Sprawdza: user_123, JohnDoe, test42
Kod koloru szesnastkowego
Wzór: ^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$
Sprawdza:
- # FF5733
- #fff
- #ABC123
Data (RRRR-MM-DD)
Wzór: ^\d{4}-\d{2}-\d{2}$
Sprawdza: 2026-01-15
Uwaga: W przypadku dat zazwyczaj lepszym rozwiązaniem jest użycie pola Data z selektorem dat.
Czas (GG:MM 24-godzinny)
Wzór: ^([01]\d|2[0-3]):[0-5]\d$
Sprawdza:
- 09:30
- 14:45
- 23:59
Numer faktury (INV-RRRR-NNNN)
Wzór: ^INV-\d{4}-\d{4}$
Sprawdza:
- INV-2026-0001
- INV-2025-1234
Numer ubezpieczenia społecznego (USA)
Wzór: ^\d{3}-\d{2}-\d{4}$
Sprawdza: 123-45-6789
Ostrzeżenie: Gromadząc numery SSN, zachowaj ostrożność — ma to wpływ na bezpieczeństwo i prywatność.
Tworzenie własnych wzorów
Proces krok po kroku
- Zdefiniuj wymagania: Jakiego formatu potrzebujesz?
- Rozbicie go: Jakie znaki, ile, w jakiej kolejności?
- Wzorzec kompilacji: Przetłumacz na wyrażenie regularne
- Przetestuj dokładnie: Prawidłowe i nieprawidłowe dane wejściowe
- Napisz komunikat o błędzie: Pomóż użytkownikom zrozumieć format
Przykład: ID pracownika
Wymaganie: 2 litery + 4 cyfry + 1 litera (np. AB1234C)
Awaria:
- 2 wielkie litery:
[A-Z]{2} - 4 cyfr:
\d{4} - 1 wielka litera:
[A-Z] - Nic przed i po:
^oraz$
Ostateczny wzór: ^[A-Z]{2}\d{4}[A-Z]$
Testowanie wzorców
Przed użyciem w formie:
- Przetestuj prawidłowe dane wejściowe (powinny zostać zaliczone)
- Test nieprawidłowych danych wejściowych (powinien zakończyć się niepowodzeniem)
- Testowanie przypadków brzegowych (granice, znaki specjalne)
- Użyj internetowych testerów wyrażeń regularnych do debugowania
Komunikaty o błędach dotyczące walidacji
Domyślne wiadomości
- „Proszę wprowadzić prawidłową wartość”
- „To pole jest nieprawidłowe”
Lepsze niestandardowe wiadomości
Poinformuj użytkowników o oczekiwanym formacie:
| Wzór | Lepszy komunikat o błędzie |
|---|---|
| Kod pocztowy | „Proszę podać prawidłowy kod pocztowy (np. 12345 lub 12345-6789)” |
| Phone | „Proszę wpisać numer telefonu 555-123-4567” |
| Kod produktu | „Format: ABC-1234 (3 litery, myślnik, 4 cyfry)” |
| Nazwa użytkownika | „Nazwa użytkownika musi zaczynać się od litery, od 3 do 20 znaków, wyłącznie litery/cyfry/podkreślenie” |
Korzystanie z tekstu zastępczego i tekstu pomocy
Zapobiegaj błędom, wyświetlając format na początku:
- Symbol zastępczy: „ABC-1234”
- Tekst pomocy: „Wprowadź kod produktu (np. ABC-1234)”
Najlepsze praktyki
1. Zacznij od czegoś prostego
W miarę możliwości używaj wbudowanych wzorców. Niestandardowe wyrażenia regularne zwiększają złożoność.
2. Nie przesadzaj z walidacją
Zbyt rygorystyczne wzorce frustrują użytkowników:
- Imiona z myślnikami (Mary-Jane)
- Nazwy z apostrofami (O'Brien)
- Znaki międzynarodowe (José, Müller)
3. Pokaż oczekiwany format
Zawsze informuj użytkowników, czego oczekujesz:
- Symbol zastępczy z przykładem
- Tekst pomocy wyjaśniający format
- Wyczyść komunikat o błędzie
4. Testowanie przypadków brzegowych
- Puste wejście
- Spacje na początku/końcu
- znaki specjalne
- Maksymalna długość
5. Rozważ alternatywy
Czasami inne podejścia są lepsze:
- Daty → Użyj pola Data
- Liczby → Użyj pola liczbowego
- Telefon → Użyj pola Telefon z formatem
- Opcje stałe → Użyj listy rozwijanej
Łączenie z inną walidacją
Wzór + Wymagane
- Pole musi być wypełnione i pasować do wzorca
- Puste pole oznacza „wymagane”
- Nieprawidłowy format powoduje błąd wzorca
Wzór + długość min./maks.
- Wzorzec sprawdza format
- Długość potwierdza rozmiar
- Obydwoje muszą zdać
Rozwiązywanie problemów
Wzór nie działa
Czek:
- Składnia jest poprawna (bez literówek)
- Znaki specjalne zostały poprawnie usunięte
- ^ i $ kotwice, jeśli to konieczne
Prawidłowe dane wejściowe są odrzucane
Czek:
- Wzór może być zbyt rygorystyczny
- Brak prawidłowych znaków we wzorcu
- Problemy z rozróżnianiem wielkości liter
Akceptowane są nieprawidłowe dane wejściowe
Czek:
- Wzór może być zbyt luźny
- Brak kotwic (^ i $)
- Test z większą liczbą przykładów
Najczęściej zadawane pytania
Czy mogę łączyć wiele wzorów?
Pojedyncze pole używa jednego wzorca. W przypadku złożonej walidacji połącz wymagania w jednym wyrażeniu regularnym za pomocą alternatywy (|) lub utwórz wzorzec pasujący do wszystkich wymagań.
Czy wzorce uwzględniają wielkość liter?
Domyślnie tak. Użyj [A-Za-z], aby dopasować oba rodzaje liter, lub dodaj flagę nieuwzględniającą wielkości liter, jeśli jest to obsługiwane.
Jak mogę zezwolić na spacje?
Dodaj \s do swojej klasy postaci: [A-Za-z\s] pasuje do liter i spacji.
A co ze znakami międzynarodowymi?
Standardowe [A-Za-z] nie obejmuje znaków akcentowanych. W przypadku nazw międzynarodowych należy rozważyć luźniejszą walidację lub użyć \p{L} (jeśli jest obsługiwane) dla każdej litery.
Czy powinienem zatwierdzić rozmycie czy przesłać?
Oba działają. Rozmycie (utrata ostrości) daje szybszy feedback. Po przesłaniu wszystko jest widoczne. Wiele formularzy działa na oba sposoby.
Podsumowanie
Dodawanie niestandardowych wzorców walidacji:
- Wybierz typ wzoru – Wbudowane lub niestandardowe
- Skonfiguruj wzór – Wybierz lub wprowadź wyrażenie regularne
- Dodaj symbol zastępczy – Pokaż oczekiwany format
- Dodaj tekst pomocy – Wyjaśnij wymagania
- Ustaw komunikat o błędzie – Korekta przewodnika
- Przetestuj dokładnie – Dane wejściowe prawidłowe i nieprawidłowe
Wniosek
Niestandardowe wzorce walidacji zapewniają jakość danych poprzez wymuszanie określonych formatów. Niezależnie od tego, czy potrzebujesz walidacji adresów URL, kodów produktów, czy niestandardowych identyfikatorów, wzorce wychwytują błędy przed wysłaniem i prowadzą użytkowników do poprawnych danych.
Automatyczny kreator formularzy Zawiera popularne wzorce (adres e-mail, adres URL, litery, cyfry, znaki alfanumeryczne) i obsługuje niestandardowe wyrażenia regularne do specjalistycznych potrzeb walidacji. Czyste dane zaczynają się od prawidłowej walidacji.
Chcesz sprawdzić dane w formularzu? Pobierz Auto Form Builder i upewnij się, że Twoje formularze zbierają poprawnie sformatowane dane.