Kontrolka Pole tekstowe umożliwia użytkownikom wprowadzanie tekstu za pomocą klawiatury oraz wyświetlanie tekstu w formie edytowalnego pola tekstowego.
Ikona kontrolki w zasobniku:

Jest wykorzystywana w tych miejscach w skrypcie, gdzie użytkownik musi wprowadzać tekst, na przykład do zamówienia, rejestracji, wprowadzania innych danych, wyszukiwania itp. Jest to bardzo wszechstronna kontrolka, która może być dostosowywana do różnych potrzeb aplikacji. Może być wykorzystywana w różnych celach, od prostych pól do wprowadzania danych po zaawansowane pola do wprowadzania wieloliniowego tekstu. Wygląd przykładowej kontrolki Pole tekstowe w skrypcie:


|
Ogólne |
|
| Nazwa | Nazwa kontrolki umożliwiająca jej identyfikację np. w wyrażeniach zależności pól. |
| Nagłówek | Dodatkowy tekst opisujący przeznaczenie pola tekstowego (możliwe jest stosowanie formatowania za pomocą tagów BBCode). |
| Pozycja nagłówka | Określa położenie nagłówka względem pola tekstowego, możliwe wartości to po lewej lub na górze. |
| Szerokość nagłówka | Określa szerokość nagłówka (jeśli nagłówek jest po lewej zwiększenie szerokości nagłówka powoduje zmniejszenie szerokości pola tekstowego). |
| Wymagalny | Określa czy wypełnienie pola jest wymagalne. Jeśli pole tekstowe ustawimy jako wymagalne (true) to walidator nie pozwoli przejść na kolejną stronę skryptu jeśli w pole tekstowe pozostanie puste (lub nie będą spełnione reguły regex jeśli zostaną zdefiniowane). |
| Wartość domyślna |
Ustawienie wartości domyślnej może być pomocne dla użytkownika, sugerując oczekiwaną lub popularną wartość do wpisania. Wartość domyślna może zapewnić wygodę dla użytkownika, zwłaszcza jeśli wymaga się często powtarzających się lub standardowych danych. Wartość domyślna jest wyświetlana w kontrolce tylko wtedy, gdy użytkownik nie wprowadził jeszcze swojej własnej wartości. Jeśli użytkownik rozpocznie wpisywanie danych, wartość domyślna zostanie zastąpiona wprowadzanymi przez niego informacjami. Wartość domyślna może być wprowadzona jako stała lub jako nazwa zmiennej której wartość zostanie ustawiona programowo (np. wartość z bazy danych). |
| Zapisz do zmiennej | Pozwala programowo zapisać wartość z pola tekstowego do zmiennej. Wartość ze zmiennej może być zapisana do bazy lub wykorzystana w kolejnych krokach skryptu. Uwaga: Nie zapisanie zawartości pola tekstowego do zmiennej nie oznacza utraty tej informacji po zamknięciu sesji skryptu. Wszystkie wartości pól edycyjnych są zapisywane w bazie danych bez względu na to, czy są przypisane do zmiennych, czy nie. |
|
Tekst |
|
| Wysokość | Określa wysokość pola tekstowego w pixelach. Wartość tej właściwości pozwala określić ile wierszy tekstu ma być jednocześnie widoczne na ekranie jednocześnie ograniczając maksymalną wysokość kontrolki. |
| Tabulatory | Określa sposób, w jaki zachowa się kursor po kliknięciu klawisza Tabulatora. W przypadku ustawienia wartości false, klikniecie tabulatora, przeniesie focus do kolejnej kontrolki na skrypcie. W przypadku ustawienia wartości true kliknięcie tabulatora spowoduje wstawienie znaku tabulacji w tekście kontrolki. |
| Wieloliniowy |
Właściwość ta decyduje, czy kontrolka Pole tekstowe będzie obsługiwać wprowadzanie tekstu w jednym wierszu (false) czy też w wielu wierszach (true). Gdy właściwość ta jest ustawiona na true, użytkownik może wprowadzać tekst, a kontrolka automatycznie dostosowuje swoją wysokość, aby pomieścić więcej tekstu w pionie. Właściwość wieloliniowy jest przydatna w sytuacjach, gdy użytkownik musi wprowadzać dłuższe fragmenty tekstu, takie jak komentarze, opisy czy wiadomości. Umożliwia to tworzenie obszarów do wprowadzania tekstu o zmiennej wysokości, co poprawia użyteczność i wygodę dla użytkownika. |
| Zawijanie tekstu | Właściwość określa czy tekst ma być zawijany automatycznie do nowej linii, gdy przekroczy szerokość kontrolki (zawijanie), czy też czy ma być wyświetlany w pojedynczej linii, bez zawijania tekstu (Bez zawijania). Zawijanie z przepełnieniem oznacza że tekst, który przekracza szerokość kontrolki, nie będzie automatycznie zawijany do nowej linii, a także będzie kontynuowany poza granice kontrolki, jeśli zajmie więcej miejsca niż dostępne w jej obszarze. |
| Reguła regex | Umożliwia określenie wzorca wyrażenia regularnego, który musi być spełniony przez tekst wprowadzany do kontrolki. Jest to przydatne narzędzie do sprawdzania, czy wprowadzony tekst pasuje do określonych kryteriów, na przykład czy jest to poprawny adres e-mail, numer telefonu czy format daty. Przykłady wyrażeń regularnych podane sa w dalszej części tej strony |
|
Wygląd |
|
| Widoczne | Domyślnie wartość tej właściwości jest ustawiona na widoczny (true), co oznacza, że kontrolka jest widoczna w skrypcie dla użytkownika. Jeśli wartość tej właściwości zostanie zmieniona na niewidoczny (false), kontrolka stanie się niewidoczna dla użytkownika, ale wciąż będzie istniała na stronie skryptu i możliwy będzie dostęp do jej właściwości np. w wyrażeniach zależności pól. |
| Kolor tła | Określa kolor tła kontrolki (chodzi o obszar otaczający kontrolkę i samą kontrolkę). Możliwe jest podanie koloru w formacie szesnastkowym lub wybór z wbudowanej palety barw. |
| Szerokość | Określa szerokość kontrolki podaną w pixelach. |
| Margines | Określa odstęp między kontrolką a sąsiednimi elementami w skrypcie. Można określić osobno każdy z marginesów: lewy, górny, prawy, dolny. |
| Podpowiedź | Umożliwia wprowadzenie tekstu który będzie pokazywany w momencie, gdy użytkownik najedzie kursorem na kontrolkę |
|
Tekst |
|
| Rozmiar czcionki | Definiuje rozmiar czcionki tekstu wyświetlanego w kontrolce Pole tekstowe |
| Kolor czcionki | Definiuje kolor tekstu wyświetlanego w kontrolce. Można użyć tej właściwości, aby zmienić kolor tekstu na dowolny inny niż domyślny. |
| Czcionka | Określa czcionkę, w której tekst jest wyświetlany w kontrolce. |
| Grubość czcionki | Określa sposób wyróżnienia tekstu. |
| Styl czcionki | Sposób ozdabiania lub wyróżniania tekstu poprzez dodanie efektów graficznych do wybranych fragmentów tekstu. Te efekty mogą obejmować podkreślenie, przekreślenie, podwójne podkreślenie, cieniowanie i inne. |
| Dekorator czcionki | Umożliwia dodanie dekoratorów czcionki (jednego lub wielu): Podkreślenie, przekreślenie, linia nad tekstem. |
Poniżej przedstawiono kilka przydatnych wyrażeń regularnych.
Adres email: ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$
Numer telefonu: ^\d{9,15}$
Kod pocztowy:^\d{2}-\d{3}$
Numer NIP (format bez kresek):^[0-9]{10}$
Numer NIP (format 000-000-00-00): ^\d{3}-\d{3}-\d{2}-\d{2}$
Adres URL:^(https?://)?(www\.)?[a-zA-Z0-9-]+\.[a-zA-Z]{2,}(\/[a-zA-Z0-9-._?%&=/]*)?$
Hasło z wymaganymi znakami:^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)[a-zA-Z\d]{8,}$
Data w formacie YYYY-MM-DD: ^(19|20)\d\d-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])$
Godzina w formacie HH:MM: ^(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]$
Numer karty kredytowej: ^(?:\d{4}-){3}\d{4}$
Adres IP: ^(?:[0-9]{1,3}\.){3}[0-9]{1,3}$
tekst o dlugości co najmniej 5 znaków:^.{5,}$
tekst nie dłuzszy niż 5 znaków:^.{1,5}$