...
Element | Opis | Przykłady akcji | Wybór w PWE | ||||||
---|---|---|---|---|---|---|---|---|---|
form | Formularz Akcja dodana do formularza inicjowana jest metodą | Akcje w których nie można wskazać głównego elementu np.
| |||||||
variable | Zmienna Akcja dodana do zmiennej formularza inicjowana jest metodą
| Akcje w których można jednoznacznie wskazać zmienną, której akcje dotyczy (w największym stopniu) np.
| |||||||
variableset | Tabelka dynamiczna Akcja dodana do zmiennej formularza inicjowana jest metodą
| Akcje które dotyczą tabelki dynamicznej i potrzebują jej identyfikator np.
| |||||||
button | Przycisk Akcja dodana do przycisku formularza inicjowana jest metodą
| Akcje których źródłem jest przycisk np.
|
...
Akcje domyślne
W celu ułatwienia tworzenia akcji które reagują na domyślne zdarzenia elementów docelowych możliwe jest zdefiniowanie tzw. akcji domyślnych.
Twórca akcji może zadeklarować funkcje, które wykonają się automatycznie, jeżeli wystąpi zdarzenie skojarzone z elementem docelowym akcji np. jeżeli akcja dodana jest do przycisku, to klikniecie w ten przycisk spowoduje wywołanie zdefiniowanej akcji domyślnej.
Info |
---|
Akcje domyślne są wywoływane tylko jeżeli warunek wykonania akcji jest spełniony. Parametry wywołania akcji domyślnej są takie same jak parametry zdarzeń, które są źródłem wywołania akcji domyślnej. |
Zdarzenia domyślne w zależności od elementu docelowego akcji:
Element docelowy | Nazwa funkcji | Domyślne zdarzenie | Opis | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
ActionDestination.button() | button | click (
| Funkcja wywoływana jest po kliknięciu na przycisk, do którego dodana jest akcja. | ||||||||
ActionDestination.variable() | variable | change (
| Funkcja wywoływana jest po zmianie wartości zmiennej, do której dodana jest akcja. | ||||||||
ActionDestination.variableSet() | variableSet | change (
| Funkcja wywoływana jest jeżeli zmieni się wartość jakiejkolwiek zmiennej należącej do tabeli dynamicznej, do której dodana jest akcja. |
Poniżej przykładowa implementacja akcji pokazującej skonfigurowaną wiadomość. W zależności elementu docelowego wiadomość pokaże się przy naciśnięciu przycisku, zmianie wartości zmiennej lub zmianie danych w tabelce.
Code Block |
---|
PW.FormActions.create('message', { // domyślne akcje defaultActions: { button: function(button){ this.showMsg(); }, variable: function(variable, newValue, oldValue){ this.showMsg(); }, variableSet: function(variableSet, added, updated, removed){ this.showMsg(); } }, showMsg: function(){ ServiceFactory.getMessageService().showSuccess(this.get('msg')); } }); |
Code Block |
---|
PW.FormActions.create('message', { buttonInit: function(button){ this.button.on('click', this.showMsg); }, variableInit: function(button){ this.button.on('click', this.showMsg); }, variableSetInit: function(button){ this.button.on('click', this.showMsg); }, showMsg: function(){ if(this.isEnabled){ ServiceFactory.getMessageService().showSuccess(this.get('msg')); } } }); |
Własności
- id - unikalny w obrębie całego systemu identyfikator akcji,
- name - nazwa akcji (obsługuje tłumaczenia),
- description - opis akcji (obsługuje tłumaczenia),
- icon - ikona akcji,
- category - kategoria, do której należy akcja (może być wiele),
- destination - element formularza, dla którego dostępna jest akcja (może być wiele)
- parameters - parametry akcji.
...