Toto je staršia verzia dokumentu!
Samotný formulár dennej operatívy obsahuje dve základné premenné (objekty):
formData - základné premenné, ktoré sú zároveň aj odosielané na server pri každej požiadavke. Tam sú dostupné v Smarty ako {$formData}.helperData - pomocné premenné, ktoré slúžia pre niektoré obslužné účely. Nie sú prenášané na server.Tento prvok je určený pre spúšťanie rôznych akcii.
Akcie sa zapisujú ako XML, takže pozor na následujúce nástrahy:
<layout controlId="btn2" />
Ak bude nejaká hodnota typu boolean,
môže sa používať aj alternatívny zápis on, off, yes, no, true, false.
Táto akcia mení vlastnosti nejakého iného prvku na aktuálnom tab-e.
Atribút controlId je povinný a určuje prvok na aktuálnom tab-e, na ktorom sa urobia zmeny (cieľový prvok). Ostatné atribúty sú nepovinné.
Ak je atribút broadcast=1, potom sa po skončení všetkých akcií na tlačítku odvysielajú udalosti tlačítka, ktoré vyvolalo túto akciu.
<layout controlId="cmd_tlacitko2" visible="1" />
| Atribút | Popis | |
|---|---|---|
controlId | string | ID prvku na aktuálnom tab-e, povinný atribút. |
width | px | Šírka cieľového prvku. |
height | px | Výška cieľového prvku. |
left | px | Pozícia vľavo (x) cieľového prvku. |
top | px | Pozícia hore (y) cieľového prvku. |
visible | bool | 0 = nie je viditeľný 1 = je viditeľný |
enabled | bool | 0 = nie je povolený 1 = je povolený |
alpha | % | Priehladnosť, hodnoty 0 až 100. 0 = Úplne riehľadný 100 = Nepriehľadný |
broadcast | bool | 1 = odvysielajú sa udalosti definované na tomto tlačítku. |
updateControl | bool | 1 = cieľový prvok sa obnoví. |
Táto akcia nastavuje formData alebo formHelperData.
Ak je atribút broadcast=1, potom sa po skončení všetkých akcií na tlačítku odvysielajú udalosti tlačítka, ktoré vyvolalo túto akciu.
<set formDataId="aktivny_obcan" value="1" />
| Atribút | Popis | |
|---|---|---|
formDataIddataId | string | Index formData premennej, ktorá sa bude nastavovať. |
helperDataId | string | Index helperData premennej, ktorá sa bude nastavovať. |
| Hodnota | ||
value | string | Priama hodnota z atribútu. |
valueDataIdvalueFormDataId | string | Hodnota z objektu formData.Napr. priezvisko |
valueDataPathvalueFormDataPath | string | Hodnota zo štruktúry formData.Napr. obcan.vek |
valueHelperDataId | string | Hodnota z objektu helperData.Napr. pom_priezvisko |
valueHelperDataPath | string | Hodnota zo štruktúry helperData.Napr. pom_obcan.vek |
valueControlDataId | bool | Hodnota z formData podľa controlId aktuálneho prvku. |
type | string | Určenie typu, možné hodnoty atribútu: |
broadcast | bool | 1 = odvysielajú sa udalosti definované na tomto tlačítku. |
updateControl | bool | |
Všetky príklady sa dajú použiť aj s nastavovaním helperDataId namiesto formDataId
<set formDataId="vek" value="25" /> <!-- formData.vek sa nastaví na hodnotu "25" -->
<set formDataId="vek" value="25" type="number" /> <!-- formData.vek sa nastaví na hodnotu 25 (ako číslo) -->
<set formDataId="vek" value="1" type="boolean" /> <!-- formData.vek sa nastaví na hodnotu TRUE (ako boolean) -->
<set formDataId="aktivny_obcan" valueFormDataId="vybrany_obcan" /> <!-- formData.aktivny_obcan sa nastaví na formData.vybrany_obcan --> <set formDataId="aktivny_obcan" valueDataId="vybrany_obcan" /> <!-- to isté, alternatívny zápis -->
<set formDataId="aktivny_obcan_vek" valueFormDataPath="obcan.vek" /> <!-- formData.aktivny_obcan_vek sa nastaví na formData.obcan.vek -->
<set formDataId="aktivny_obcan" valueHelperDataId="pom_obcan" /> <!-- formData.aktivny_obcan sa nastaví na helperData.pom_obcan -->
<set formDataId="aktivny_obcan_vek" valueHelperDataPath="pom_obcan.vek" /> <!-- formData.aktivny_obcan_vek sa nastaví na helperData.pom_obcan.vek -->
<set formDataId="vek">25</set> <!-- formData.vek sa nastaví na hodnotu "25" -->
<set formDataId="vek" type="number">25</set> <!-- formData.vek sa nastaví na hodnotu 25 (ako číslo) -->
<set formDataId="aktivny_obcan">{$formData.vybrany_obcan}</set> <!-- formData.aktivny_obcan sa nastaví na formData.vybrany_obcan -->
<set formDataId="kod">CX-{$formData.vybrany_obcan}</set> <!-- formData.kod sa nastaví na "CX-formData.vybrany_obcan" -->
<set formDataId="vek">V-{$formData.vybrany_obcan.vek}</set> <!-- formData.vek sa nastaví na "V-formData.vybrany_obcan.vek" -->
<set formDataId="aktivny_obcan">{$helperData.pom_obcan}</set> <!-- formData.aktivny_obcan sa nastaví na helperData.pom_obcan -->
<set formDataId="vek">V-{$helperData.pom_obcan.vek}</set> <!-- formData.vek sa nastaví na "V-helperData.pom_obcan.vek" -->
Spustenie akcie (akcia alebo tlačítko).
Atribút controlId je povinný.
| Atribút | Popis | |
|---|---|---|
controlIdId | string | ID prvku, z ktorého bude vyvolaná akcia. |
<runAction controlId="cmd_zmena_obcana" />
Vyvolanie jednej konkrétnej udalosti.
Atribút eventId je povinný.
| Atribút | Popis | |
|---|---|---|
eventId | string | ID udalosti. |
<broadcastEvent eventId="e_zmena_obcana" /> <!-- Vyvolá sa udalosť "e_zmena_obcana", takže zareaguje každý prvok, ktorý na túto udalosť počúva. -->
Vyvolanie udalosti.
Pokiaľ nebude zadaný atribút controlId, vyvolajú sa udalosti, ktoré sú nastavené nad daným tlačítkom (alebo akciou).
| Atribút | Popis | |
|---|---|---|
controlId | string | ID prvku. |
<broadcast /> <!-- Vyvolanie udalostí, ktoré sú spriahnuté s aktuálnym prvkom. --> <broadcast controlId="cmd_obcan" /> <!-- Vyvolanie udalostí, ktoré sú spriahnuté s prvkom "cmd_obcan". -->
Pomocný príkaz, ktorý opätovne odošle formData na server pri spracovaní požiadaviek. Neobsahuje žiadne atribúty. Viac info u Romana S.
<set formDataId="vek" value="12" /> <resendFormData />
Zobrazenie obsahu premenných.
Bez zadania iných atribútov sa zobrazia formData a helperData.
Jedná sa o pomocnú funkciu, ktorá by sa nemala zobrazovať v produkčnom režime.
| Atribút | Popis | |
|---|---|---|
formData | bool | Zobrazia sa formData. |
helperData | bool | Zobrazia sa helperData. |
<analyze />
<date /> <date action="next_day" /> <date action="previous_day_day" /> <date action="next_week" /> <date action="previous_week_week" /> <date action="today" /> <date action="..." broadcast="1" /> <set /> <set dataId="KEY" value="VALUE" /> <set dataId="KEY" value="VALUE {OTHER_DATA_ID}" /> <set dataId="KEY" valueDataId="DATA_ID" /> <set dataId="KEY" valueDataPath="" /> <set dataId="KEY" valueHelperDataId="DATA_ID" /> <set dataId="KEY" valueHelperDataPath="" /> <set dataId="KEY" valueControlDataId="1" /> <set dataId="KEY">VALUE</set > <set dataId="KEY">VALUE {$formData.OTHER_DATA_ID}</set > <set helperDataId="KEY" value="..." /> <set dataId="..." broadcast="1" /> <set type="number" /> <set type="int" /> <set type="boolean" /> <set type="bool" /> <set dataId="..." math="not" /> <request /> <request function="" formData="" updateFormData="" updateHelperData="" broadcastAfter="1" runButtonAfter="BUTTON_CONTROL_ID" > <param key="KEY" value="VALUE" /> <param key="KEY" value="VALUE {$formData.OTHER_DATA_ID}" /> <param key="KEY" valueDataId="OTHER_DATA_ID" /> <param key="KEY" valueDataPath="OTHER_OBJ.OTHER_DATA_ID" /> <param key="KEY" valueHelperDataId="OTHER_HELPER_DATA_ID" /> <param key="KEY" valueHelperDataPath="OTHER_HELPER_OBJ.OTHER_DATA_ID" /> <param key="KEY" controlDataId="1" /> <param key="KEY">VALUE</param> <param key="KEY">VALUE {$formData.OTHER_DATA_ID}</param> <param key="KEY">VALUE {$helperData.OTHER_DATA_ID}</param> <param type="text" /> <param type="string" /> <param type="number" /> <param type="int" /> <param type="boolean" /> <param type="bool" /> <param type="object" /> <param type="array" /> <param type="raw" /> <param key="KEY" type="object"> <param key="OBJ1" value="VALUE" /> <param key="ARR1" type="array"> <param value="16" type="number" /> </param> </param> </request> <report /> <flash object="" function="" > <!-- ako <request /> --> <objectParams> <param key="KEY" value="VALUE /"> </objectParams> </flash>