...
validateComboBoxes - dokonuje walidacji wszystkich list rozwijanych na formularzu (data chooser, lista użytkowników, lista wartości itd.) oraz zaznacza te listy, które posiadają niepoprawne wartości (także w tabelach dynamicznych). Umożliwia wykonanie określonych akcji po zakończeniu walidacji w zależności od statusu odpowiedzi.
Info Walidacja list rozwijanych jest wywoływana asynchronicznie.
Parametry funkcji:
Nazwa Typ Wartość domyślna
Opis config Object { } Konfiguracja walidacji list rozwijanych. Obiekt posiada następujące właściwości:
checkForm (Typ Boolean)
Określa, czy sprawdzać wymagalność oraz restrykcje na wyrażenia regularne w listach rozwijanych (domyślnie: false)
- submitMessage (Typ String)
Treść wiadomości widocznej podczas trwania walidacji list rozwijanych (domyślnie: '')
- scope (Typ Object)
Scope dla opcjonalnych funkcji wykonywanych po walidacji określonych we właściwościach success i failure (domyślnie: window)
- success (Typ Function)
Opcjonalna funkcja wykonywana po walidacji zakończonej sukcesem (domyślnie: null)
- successParams (Typ Object[])
Tablica określająca parametry przekazywane do funkcji określonej we właściwości success (domyślnie: [form, action] - standardowy rezultat funkcji success dla wysyłania formy)
- failure (Typ Function)
Opcjonalna funkcja wykonywana po walidacji zakończonej niepowodzeniem (domyślnie: null)
- failureParams (Typ Object[])
Tablica określająca parametry przekazywane do funkcji określonej we właściwości failure (domyślnie: [form, action] - standardowy rezultat funkcji failure dla wysyłania formy)
- Rezultat funkcji: brak
- insertHtml - wstawia fragment kodu HTML w dowolne miejsce na formularzu.
Parametry funkcji:
Nazwa Typ Wartość domyślna
Opis html String null Fragment kodu HTML. W celu upodobnienia wstawionego fragmentu kodu HTML do systemu można wykorzystać następujące klasy CSS: suncode-container-underline (dodaje podkreślenie), suncode-form-label (styl dla etykiety pola), suncode-form-grey-panel (nadaje kolor tła zgodny z formularzem, klasę CSS można dodawać tylko do komponentów div). Dodatkowo, jeżeli chcemy umieścić wstawiany kod po lewej stronie formularza, należy wykorzystać jeden z następujących styli: text-align: left, float: left. Analogicznie kod HTML umieszczamy po prawej za pomocą tych samych właściwości, lecz z wartością right. Dodatkowo możemy wyrównywać komponenty za pomocą styli margin-left: Xpx i margin-right: Xpx. Kod HTML możemy wyśrodkować za pomocą połączenia styli margin-left: auto i margin-right: 0. variableId String null Identyfikator zmiennej formularza (zmiennej procesu) względem której następuje wstawienie fragmentu kodu HTML. Może to być także identyfikator tabeli dynamicznej. Jeżeli parametr jest pusty lub na formularzu nie istnieje zmienna o podanym identyfikatorze, to fragment kodu HTML jest wstawiany na początku/na końcu formularza (w zależności od parametru before before Boolean false Informuje, czy fragment kodu HTML powinien zostać wstawiony przed podaną zmienną formularza/tabelą dynamiczną. Jeżeli parametr variableId jest pusty lub na formularzu nie istnieje zmienna o podanym identyfikatorze, to fragment kodu jest wstawiany na początku/na końcu formularza, w zależności od przyjętej wartości parametru sameLine Boolean false Informuje, czy fragment kodu HTML powinien zostać wstawiony w tym samym wierszu, co podana zmienna formularza/tabela dynamiczna. Jeżeli parametr variableId jest pusty lub na formularzu nie istnieje zmienna o podanym identyfikatorze, to wartość parametru nie ma znaczenia - Rezultat funkcji: brak
- hideSaveFormButton - ukrywa przycisk zapisu formularza.
Parametry funkcji: brak
- Rezultat funkcji: brak
- showSaveFormButton - pokazuje przycisk zapisu formularza.
Parametry funkcji: brak
- Rezultat funkcji: brak