Wprowadzanie danych

Podstawową metodą umożliwiającą użytkownikowi wpisywanie danych jest textField(). Istnieje również szereg metod szczegółowych, do wprowadzania szczególnych typów danych, o charakterystycznych właściwościach lub formatach, np.:

• numericField() - pole do wprowadzania liczb.
• dateField() - do wprowadzania daty. Składa się z trzech pól osobno dla dnia, miesiąca i roku, ustawianych wg domyślnego formatu daty. Poprawność wpisanej daty jest sprawdzana automatycznie.
• calendarField() - również pole tekstowe do wpisywania daty. Wpisana data jest porównywana z domyślnym dla danej instancji formatem daty. Poprawność wpisanej daty jest sprawdzana automatycznie.
• emailField() - do wpisywania adresu e-mail. Wykorzystuje wyrażenia regularne do sprawdzenia poprawności wprowadzonego adresu.
• peselField() - do wpisywania numeru PESEL
• postCodeField() - do wpisywania kodu pocztowego- właściwe tylko dla polskiej wersji kodu!
• loginField() - do wpisywania identyfikatora użytkownika programu (loginu).
• passwordField() - do wpisywania hasła.

Dwie ostatnie metody, ze względu na swój szczególny charakter,  mają automatycznie przypisane nazwy parametrów i niektóre właściwości.

Istnieje również metoda textArea(), wyświetlająca obszar tekstowy do wprowadzania danych.

Szczególnym przypadkiem są metody uploadField(), pozwalające na wyświetlanie pola do przesyłania plików na serwer. Jeśli się korzysta z którejś z nich, należy uwzględnić to przy tworzeniu formularza: zamiast podstawowej metody createForm() należy wykorzystać przystosowaną specjalnie do tego celu metodę createUploadForm().

Przykład

<label>"Customer last name"</label>
$html.textField("customer.name",
                (String) $getParam("customer.name"),
                100,
                false,
                (String) "CUSTOMER LAST NAME",
                (String) null,
                (String) "customer.name",
                (String) null,
                (String) null,
                (String) null,
                (String) null,
                {})