Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

ServiceFactory jest dostępny na globalnym scope (window).

 

Serwisy

ServiceFactory daje dostęp do następujących serwisów:

...

Code Block
languagejavascript
var variableSetService = ServiceFactory.getVariableSetService();

...


SuncodeFormService

API formularza posiada także dodatkowy serwis serwis SuncodeFormService. Jest on również dostępny na globalnym na globalnym scope (window) i  i jest obsługiwany niezależnie od pozostałych serwisów. Posiada jedną funkcję, która daje


Zdarzenia gotowości formularza

Funkcja addOnReadyEvent daje możliwość dodania dowolnej ilości akcji, jakie zostaną wykonane po zbudowaniu formularza (wszystkie komponenty na formularzu będą już dostępne). Funkcja ta ma nazwę addOnReadyEvent. Przykładowe wykorzystanie jest następujące:

...

Funkcja ta nie zwraca żadnych rezultatów.

 

Grupowanie akcji obliczania wyglądu formularza

Od wersji 3.1.6 możliwe jest dodatkowe grupowanie akcji zmieniających układ formularza (layout). Takie grupowanie zmian układu jest znacznie szybsze niż wykonywanie tych akcji osobno.

Code Block
languagejavascript
SuncodeFormService.suspendLayouts();
try {
	// wiele akcji
	variableService.hide('a');
	variableSetService.hide('a');
}
finally {
	SuncodeFormService.resumeLayouts();
}

 

Ustawienia konfiguracyjne formularza

W wersji 3.1.10 wprowadzono mechanizm ustawień formularza. Umożliwia on dynamiczne ustawienie danych właściwości poprzez API:

Code Block
languagejavascript
// ustawienie właściwości
SuncodeFormService.setConfig('config.key', 'value');
 
// pobranie właściwości
var conf = SuncodeFormService.getConfig('config.key', 'default value');


Tabela zawiera wszystkie dostępne opcje konfiguracyjne formularza

NazwaTypWartość domyślnaOpis
autoupdate.blurifchange
Boolean
false

Domyślnie AutoUpdate na zdarzeniu blur wykonuje się zawsze, nawet wtedy, gdy nie zmienimy wartości pola.

Aby AutoUpdate był wywoływany po wyjściu z pola, jeżeli jego wartość zmieniła się od ostatniego wyjścia z pola należy wywołać kod:

Code Block
languagejavascript
SuncodeFormService.setConfig('autoupdate.blurifchange', true);