Ovladače AppML


Účelem řadiče AppML je umožnit vám ovládat vaši aplikaci.


Co umí ovladač?

  • Nastavte počáteční data
  • Změňte data aplikace
  • Ovládejte vstup a výstup
  • Ověřte data
  • Shrňte data
  • Ošetřete chyby
  • Spouštění a zastavování aplikací
  • A mnohem víc

Bez ovladače

Ve výchozím nastavení běží aplikace AppML bez řadiče:

Příklad

<table appml-data="customers.js">
<tr>
  <th>Customer</th>
  <th>City</th>
  <th>Country</th>
</tr>
<tr appml-repeat="records">
  <td>{{CustomerName}}</td>
  <td>{{City}}</td>
  <td>{{Country}}</td>
</tr>
</table>

S ovladačem

Pomocí ovladače AppML můžete ovládat svou aplikaci pomocí JavaScriptu .

Ovladač je funkce JavaScriptu, kterou poskytujete .

Atribut appml-controller se používá k odkazování na funkci kontroleru.

Příklad

<h1>Customers</h1>
<table appml-data="customers.js" appml-controller="myController">
  <tr>
    <th>Customer</th>
    <th>City</th>
    <th>Country</th>
  </tr>
  <tr appml-repeat="records">
    <td>{{CustomerName}}</td>
    <td>{{City}}</td>
    <td>{{Country}}</td>
  </tr>
</table>

<script>
function myController($appml) {
    if ($appml.message == "display") {
        if ($appml.display.name == "CustomerName") {
            $appml.display.value = $appml.display.value.toUpperCase();
        }
    }
}
</script>

Kontrolér (myController) ve výše uvedeném příkladu změní hodnotu "CustomerName" na velká písmena, než se zobrazí.

Pokud máte ovladač, AppML odešle aplikační objekt ($appml) do ovladače pro každou důležitou akci.

Jednou z vlastností aplikace je zpráva ($appml.message), popisující stav aplikace.

Message Description
ready Sent after AppML is initiated, and ready to load data.
loaded Sent after AppML is fully loaded, ready to display data.
display Sent before AppML displays a data item.
done Sent after AppML is done (finished displaying).
submit Sent before AppML submits data.
error Sent after AppML has encountered an error.

Zprávy jsou vysvětleny v další kapitole.