Nástroje používateľa

Nástoje správy stránok


omega:modules:dailyoperations:button

Toto je staršia verzia dokumentu!


Button

Tento prvok je určený pre spúšťanie rôznych akcii.

Button je nadstavba prvku Action s možnosťou zobrazenia textu.

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

<layout controlId="cmd_tlacitko2" visible="1" />

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

<date formDataId="cmd_date1" action="next_week" />
<broadcast />
 
<!-- alternatívny zápis -->
<date formDataId="cmd_date1" action="next_week" broadcast="true" />

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

<set formDataId="aktivny_obcan" value="1" />

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

<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) -->

formData

<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 -->

helperData

<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 -->

Príklady zadania cez hodnotu

<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) -->

formData

<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" -->

helperData

<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" -->

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

<runAction controlId="cmd_zmena_obcana" />

broadcastEvent

Vyvolanie jednej konkrétnej udalosti.

Atribút eventId je povinný.

Atribúty

Atribút Popis
eventId string ID udalosti.

Príklad

<broadcastEvent eventId="e_zmena_obcana" />
<!-- Vyvolá sa udalosť "e_zmena_obcana", takže zareaguje každý prvok, ktorý na túto udalosť počúva. -->

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

<broadcast />
<!-- Vyvolanie udalostí, ktoré sú spriahnuté s aktuálnym prvkom. -->
 
<broadcast controlId="cmd_obcan" />
<!-- Vyvolanie udalostí, ktoré sú spriahnuté s prvkom "cmd_obcan". -->

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

<set formDataId="vek" value="12" />
<resendFormData />

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

<analyze />

Ostatné

<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>
omega/modules/dailyoperations/button.1431359698.txt.gz · Posledná úprava: 2015/05/11 17:54 od Roman Sališ