Rozdiely

Tu môžete vidieť rozdiely medzi vybranou verziou a aktuálnou verziou danej stránky.

--- omega:modules:dailyoperations:button [2015/05/11 17:43]
Roman Sališ vytvorené
+++ omega:modules:dailyoperations:button [2015/05/11 18:13] (aktuálne)
Roman Sališ [Reakcia na zachytenú udalosť]
@@ Riadok 2: / Riadok 2: @@
 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:
-  * Atribúty musia byť v úvodzovkách alebo apostrofoch.
-  * Samotný element musí byť ukončený. <code xml><layout controlId="btn2" /></code>
-Ak bude nejaká hodnota typu ''boolean'',
+''Button'' je  nadstavba prvku [[./action|Action]] s možnosťou zobrazenia textu.
-môže sa používať aj alternatívny zápis ''on'', ''off'', ''yes'', ''no'', ''true'', ''false''.
-----
-===== layout =====
-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.
-==== Príklad ====
-<code xml>
-  <layout controlId="cmd_tlacitko2" visible="1" />
-</code>
-==== Atribúty ====
-^ 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ý\\ :!:  Nie je zatiaľ implementované.  |
-| ''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í.                                                  |
-----
-===== date =====
-Táto akcia nastavuje dátum.
-Dátum sa bude nastavovať pre premennú objektu ''formData'' definovanú buď ako atribút akcie (''dataId'', ''formDataId''), alebo definovanú na samotnom tlačítku ako ''dataId''.
-Treba myslieť na to, že táto akcia iba nastavuje premennú.
-Samotné prekleslenie nastane:
-  * nastavením atribútu ''%%broadcast="1"%%'',
-  * alebo ďalšou akciou ''<broadcast />''.
-==== Atribúty ====
-^ Atribút                      ^             ^ Popis                                                                                                                                                                                            ^
-| ''dataId''\\ ''formDataId''  | //string//  | Dátumová premenná (formData), ktorá sa bude nastavovať.                                                                                                                                          |
-| ''action''                   | //string//  | Typ akcie:\\ ''today'' - dnešný dátum\\ ''next_day'' - následujúci deň\\ ''previous_day'' - predchádzajúci deň\\ ''next_week'' - následujúci týždeň\\ ''previous_week'' - predchádzajúci týždeň  |
-| ''broadcast''                | //bool//    | 1 = odvysielajú sa udalosti definované na tomto tlačítku.                                                                                                                                        |
-| ''updateControl''            | //bool//    | 1 = cieľový prvok sa obnoví.                                                                                                                                                                     |
-==== Príklad ====
-<code xml>
-  <date formDataId="cmd_date1" action="next_week" />
-  <broadcast />
-  <!-- alternatívny zápis -->
-  <date formDataId="cmd_date1" action="next_week" broadcast="true" />
-</code>
-----
-===== set =====
-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.
-==== Príklad ====
-<code xml>
-  <set formDataId="aktivny_obcan" value="1" />
-</code>
-==== Atribúty ====
-^ Atribút                                    ^             ^ Popis                                                                                    ^
-| ''formDataId''\\ ''dataId''                | //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.                                                               |
-| ''valueDataId''\\ ''valueFormDataId''      | //string//  | Hodnota z objektu ''formData''.\\ Napr. ''priezvisko''                                   |
-| ''valueDataPath''\\ ''valueFormDataPath''  | //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:''\\ string\\ boolean, bool\\ number\\ int\\ raw''  |
-| ''math''                                   | //string//  | Základné matematické operácie:''\\ not''                                                 |
-|                                                                                                                                                   |||
-| ''broadcast''                              | //bool//    | 1 = odvysielajú sa udalosti definované na tomto tlačítku.                                |
-| ''updateControl''                          | //bool//    |                                                                                          |
-==== Príklady zadania cez atribút ====
-Všetky príklady sa dajú použiť aj s nastavovaním ''helperDataId'' namiesto ''formDataId''
-<code xml>
-  <set formDataId="vek" value="25" />
-  <!-- formData.vek sa nastaví na hodnotu "25" -->
-</code>
-<code xml>
-  <set formDataId="vek" value="25" type="number" />
-  <!-- formData.vek sa nastaví na hodnotu 25 (ako číslo) -->
-</code>
-<code xml>
-  <set formDataId="vek" value="1" type="boolean" />
-  <!-- formData.vek sa nastaví na hodnotu TRUE (ako boolean) -->
-</code>
-=== formData ===
-<code xml>
-  <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 -->
-</code>
-<code xml>
-  <set formDataId="aktivny_obcan_vek" valueFormDataPath="obcan.vek" />
-  <!-- formData.aktivny_obcan_vek sa nastaví na formData.obcan.vek -->
-</code>
-=== helperData ===
-<code xml>
-  <set formDataId="aktivny_obcan" valueHelperDataId="pom_obcan" />
-  <!-- formData.aktivny_obcan sa nastaví na helperData.pom_obcan -->
-</code>
-<code xml>
-  <set formDataId="aktivny_obcan_vek" valueHelperDataPath="pom_obcan.vek" />
-  <!-- formData.aktivny_obcan_vek sa nastaví na helperData.pom_obcan.vek -->
-</code>
-==== Príklady zadania cez hodnotu ====
-<code xml>
-  <set formDataId="vek">25</set>
-  <!-- formData.vek sa nastaví na hodnotu "25" -->
-</code>
-<code xml>
-  <set formDataId="vek" type="number">25</set>
-  <!-- formData.vek sa nastaví na hodnotu 25 (ako číslo) -->
-</code>
-=== formData ===
-<code xml>
-  <set formDataId="aktivny_obcan">{$formData.vybrany_obcan}</set>
-  <!-- formData.aktivny_obcan sa nastaví na formData.vybrany_obcan -->
-</code>
-<code xml>
-  <set formDataId="kod">CX-{$formData.vybrany_obcan}</set>
-  <!-- formData.kod sa nastaví na "CX-formData.vybrany_obcan" -->
-</code>
-<code xml>
-  <set formDataId="vek">V-{$formData.vybrany_obcan.vek}</set>
-  <!-- formData.vek sa nastaví na "V-formData.vybrany_obcan.vek" -->
-</code>
-=== helperData ===
-<code xml>
-  <set formDataId="aktivny_obcan">{$helperData.pom_obcan}</set>
-  <!-- formData.aktivny_obcan sa nastaví na helperData.pom_obcan -->
-</code>
-<code xml>
-  <set formDataId="vek">V-{$helperData.pom_obcan.vek}</set>
-  <!-- formData.vek sa nastaví na "V-helperData.pom_obcan.vek" -->
-</code>
-----
-===== runAction =====
-Spustenie akcie (akcia alebo tlačítko).
-Atribút ''controlId'' je povinný.
-==== Atribúty ====
-^ Atribút            ^             ^ Popis                                                                         ^
-| ''__controlIdId__''  | //string//  | ID prvku, z ktorého bude vyvolaná akcia.                                 |
-==== Príklad ====
-<code xml>
-  <runAction controlId="cmd_zmena_obcana" />
-</code>
-----
-===== broadcastEvent =====
-Vyvolanie jednej konkrétnej udalosti.
-Atribút ''eventId'' je povinný.
-==== Atribúty ====
-^ Atribút            ^             ^ Popis                                                                         ^
-| ''__eventId__''  | //string//  | ID udalosti.                                 |
-==== Príklad ====
-<code xml>
-  <broadcastEvent eventId="e_zmena_obcana" />
-  <!-- Vyvolá sa udalosť "e_zmena_obcana", takže zareaguje každý prvok, ktorý na túto udalosť počúva. -->
-</code>
-----
-===== broadcast =====
-Vyvolanie udalosti.
-Pokiaľ nebude zadaný atribút ''controlId'', vyvolajú sa udalosti, ktoré sú nastavené nad daným tlačítkom (alebo akciou).
-==== Atribúty ====
-^ Atribút            ^             ^ Popis                                                                         ^
-| ''controlId''  | //string//  | ID prvku.                                 |
-==== Príklad ====
-<code xml>
-<broadcast />
-<!-- Vyvolanie udalostí, ktoré sú spriahnuté s aktuálnym prvkom. -->
-<broadcast controlId="cmd_obcan" />
-<!-- Vyvolanie udalostí, ktoré sú spriahnuté s prvkom "cmd_obcan". -->
-</code>
-----
-===== resendFormData =====
-Pomocný príkaz, ktorý opätovne odošle formData na server pri spracovaní požiadaviek.
-Neobsahuje žiadne atribúty.
-Viac info u Romana S.
-==== Príklad ====
-<code xml>
-  <set formDataId="vek" value="12" />
-  <resendFormData />
-</code>
-----
-===== analyze=====
-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úty ====
-^ Atribút         ^           ^ Popis                        ^
-| ''formData''    | //bool//  | Zobrazia sa ''formData''.    |
-| ''helperData''  | //bool//  | Zobrazia sa ''helperData''.  |
-==== Príklad ====
-<code xml>
-  <analyze />
-</code>
-----
-===== Ostatné =====
-<code xml>
-  <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" />
-  <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>
-</code>
+===== Vysielanie udalosti =====
+Udalosti sa vysielajú po stlačení tlačítka.
+===== Reakcia na zachytenú udalosť =====
+''Button'' sa pri zachytení udalosti prekreslí.
+Obsah, ktorý sa vykreslí je možné spracovať aj na serveri.

SystemOmega

Nástroje používateľa

Nástoje správy stránok

Rozdiely

Nástoje stránky