¶ Pole tekstowe z maską
Kontrolka Pole tekstowe umożliwia użytkownikom wprowadzanie tekstu za pomocą klawiatury oraz wyświetlanie tekstu w formie edytowalnego pola tekstowego. W przeciwieństwie do zwykłego Pola tekstowego, pole tekstowe z maską pozwala na ograniczenie i ustrukturyzowanie wpisywanych znaków według tzw. "maski". Dzięki temu kontrolka jest użyteczna w sytuacjach, gdy wymagane jest wprowadzenie danych w ściśle określonym formacie, takich jak numery telefonów, kody pocztowe, daty czy numery identyfikacyjne.
Ikona kontrolki w zasobniku:
¶ Użycie
Jest wykorzystywana w tych miejscach w skrypcie, gdzie użytkownik musi wprowadzać tekst zgodnie z wcześniej ustalonym wzorcem. Kontrolka jest szczególnie przydatna w aplikacjach biznesowych i formularzach, gdzie poprawność wprowadzonych danych ma kluczowe znaczenie, np. w formularzach rejestracyjnych, systemach bankowych, aplikacjach medycznych itp., typowe przypadki użycia kontrolki pole tekstowe z maską to:
- Walidacja danych: pole automatycznie wymusza zgodność wprowadzanych danych z ustawionym wzorcem, co minimalizuje potrzebę dodatkowej walidacji po stronie bazy lub w regułach skryptu
- Formatowanie danych wejściowych: Dzięki użyciu masek, dane wprowadzone przez użytkownika są sformatowane zgodnie z wymaganiami, co ułatwia ich dalsze przetwarzanie.
- Poprawność i ułatwienie użytkowania: Maski prowadzą użytkownika w trakcie wprowadzania danych, co pomaga unikać błędów.
Wygląd przykładowej kontrolki Pole tekstowe w skrypcie:
¶ Właściwości
| 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 z maską, 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 z maską). |
| Wymagalny | Określa czy wypełnienie pola tekstowe z maską jest wymagalne. Jeśli pole tekstowe z maską ustawimy jako wymagalne (true) to walidator nie pozwoli przejść na kolejną stronę skryptu jeśli w pole tekstowe z maską pozostanie puste (lub nie będą spełnione reguły maski). |
| 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 z maską do zmiennej. Wartość ze zmiennej może być zapisana do bazy lub wykorzystana w kolejnych krokach skryptu. Uwaga: Nie zapisanie zawartości pola tekstowego z maską 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 | |
| Skrypt walidacji | Predefiniowane, szablony popularnych typów danych niestandardowych. Skrypty oprócz sprawdzenia formatu danch (długość, typy znaków) oferują sprawdzenie tak zwanych sum kontrolnych. W chwili pisania tego opisu dostępne były następujące skrypty walidacji: NIP, Regon, Pesel, IBAN, Alfanumeric (litery i cyfry bez znaków specjalnych), Numeric (tylko cyfry). |
| Field heigth | Określa szerokość kontrolki podaną w pixelach. |
| Field width | Określa wysokość kontrolki podaną w pixelach. |
| Tabulatory | Właściwość określa zachowanie kursora w przypadku kliknięcia klawisza tabulator. Wartość ustawiona na true powoduje dodanie odstępu tabulatora w tekście kontrolki, wartość ustawiona na false powoduje przejście do kolejnej kontrolki w skrypcie. |
| Maska | Umożliwia określenie wzorca maski, 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 znaków masek podane są 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ą kontrolke). 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. |
¶ Znaki maski:
0 Cyfra, wymagana. Ten element zaakceptuje dowolną pojedynczą cyfrę z zakresu od 0 do 9.
9 Cyfra lub spacja, opcjonalnie.
# Cyfra lub spacja, opcjonalnie. Jeśli ta pozycja jest pusta w masce, zostanie ona renderowana jako miejsce puste . Znaki plus (+) i minus (-) są dozwolone.
L List, wymagane. Ogranicza dane wejściowe do liter ASCII a-z i A-Z. Ten element maski jest odpowiednikiem [a-zA-Z] w wyrażeniach regularnych.
? Litera, opcjonalnie. Ogranicza dane wejściowe do liter ASCII a-z i A-Z. Ten element maski jest odpowiednikiem [a-zA-Z] w wyrażeniach regularnych.
& Wymagany znak. Jeśli właściwość jest ustawiona AsciiOnly na wartość true, ten element zachowuje się jak element "L".
C Znak, opcjonalny. Dowolny znak bez kontroli.
A Alfanumeryczne, wymagane.
a Alfanumeryczne, opcjonalne.
. Symbol zastępczy liczby dziesiętnej.
, Symbol zastępczy tysięcy.
: Separator godziny. Użyty rzeczywisty znak wyświetlania będzie symbolem czasu odpowiednim dla dostawcy formatu.
/ Separator daty. Użyty rzeczywisty znak wyświetlania będzie symbolem daty odpowiednim dla dostawcy formatu.
$ Symbol waluty. Wyświetlany rzeczywisty znak będzie symbolem waluty odpowiednim dla dostawcy formatu.