AppML Meldungen und Aktionen
Wenn AppML im Begriff ist , eine Aktion auszuführen, sendet er das Anwendungsobjekt ($appml) an die Steuerung.
Einer der Anwendung Eigenschaften des Objekts ist eine Nachricht ($appml.message) , beschreibt den Anwendungszustand.
Testen Sie diese Meldung, können Sie Ihre eigenen JavaScript-Code hinzufügen, abhängig von der Aktion.
Beispiel
function myController($appml) {
if ($appml.message == "ready") {alert ("Hello
Application");}
} Versuch es selber " AppML Nachrichten
Dies ist eine Liste von AppML Nachrichten, die empfangen werden können:
| Nachricht | Beschreibung |
|---|---|
| "ready" | Sent nach AppML eingeleitet wird, und bereit ist, Daten zu laden. |
| "loaded" | Sent nach AppML vollständig geladen ist, bereit, Daten anzuzeigen. |
| "display" | Sent vor AppML ein Datenelement anzeigt. |
| "done" | Sent nach AppML erfolgt (finished displaying) die (finished displaying) . |
| "submit" | Sent vor AppML Daten einreicht. |
| "error" | Sent nach AppML ist ein Fehler aufgetreten. |
Die "ready" Nachricht
Wenn eine AppML Anwendung bereit ist , Daten zu laden, wird es eine senden "ready" Nachricht.
Dies ist der perfekte Ort , um die Anwendung mit Anfangsdaten zur Verfügung zu stellen (start values) :
Beispiel
<div appml-controller="myController" appml-data="customers.js">
<h1>Customers</h1>
<p>{{today}}</p>
<table>
<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>
<p>Copyright {{copyright}}</p>
</div>
<script>
function myController($appml) {
if ($appml.message == "ready") {
$appml.today = new Date();
$appml.copyright = "w3ii"
}
}
</script> Versuch es selber " In dem obigen Beispiel, wenn der $ appml.message ist "ready" , fügt der Controller zwei neue Eigenschaften für die Anwendung ( today and copyright ) .
Wenn die Anwendung ausgeführt wird, sind die neuen Eigenschaften der Anwendung zur Verfügung.
Die "loaded" Nachricht
Wenn eine AppML Anwendung mit Daten geladen wird (ready to display) kann " loaded " (ready to display) , wird es eine schicken " loaded " Nachricht.
Dies ist der perfekte Ort , Veränderungen zu schaffen (if necessary) an die geladenen Daten.
Beispiel
function myController($appml) {
if ($appml.message == "loaded") {
// compute your values here before display
}
}Die "display" Nachricht
Jedes Mal , AppML ist ein Datenelement angezeigt wird , wird es eine senden " display " Nachricht.
Dies ist der perfekte Ort, um die Ausgabe zu ändern:
Beispiel
<div appml_app="myController" appml-data="customers.js">
<h1>Customers</h1>
<table>
<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>
</div>
<script>
function myController($appml) {
if
($appml.message == "display") {
if ($appml.display.name ==
"CustomerName") {
$appml.display.value = $appml.display.value.substr(0,15);
}
if ($appml.display.name == "Country") {
$appml.display.value = $appml.display.value.toUpperCase();
}
}
}
</script> Versuch es selber " In dem obigen Beispiel "CustomerName" wird auf 15 Zeichen abgeschnitten, und die "Country" ist in Großbuchstaben umgewandelt.
Die "done" Nachricht
Wenn ein AppML Antrag Daten beendet anzeigt, wird es eine schicken " done " Nachricht.
Dies ist der perfekte Ort, um aufzuräumen oder Anwendungsdaten berechnen (nach der Anzeige).
Beispiel
<script>
function myController($appml) {
if ($appml.message == "done") {
calculate data here
}
}
</script>Die "submit" Nachricht
Wenn eine AppML Anwendung bereit ist , Daten zu übermitteln, wird es eine schicken " submit " Nachricht.
Dies ist der perfekte Ort, um Applikations-Input zu validieren.
Beispiel
<script>
function myController($appml) {
if ($appml.message == "submit") {
validate data here
}
}
</script>Die "error" Nachricht
Wenn ein Fehler auftritt, AppML wird eine senden " error " Nachricht.
Dies ist der perfekte Ort, um Fehler zu behandeln.
Beispiel
<script>
function myController($appml) {
if ($appml.message ==
"error") {
alert ($appml.error.number + " " + $appml.error.description)
}
}
</script>AppML Eigenschaften
Dies ist eine Liste von einigen häufig verwendeten AppML Eigenschaften:
| Eigentum | Beschreibung |
|---|---|
| $appml.message | Der aktuelle Status der Anwendung. |
| $appml.display.name | Der Name des Datenfeldes über die angezeigt werden sollen. |
| $appml.display.value | Der Wert des Datenfeldes über die angezeigt werden soll. |
| $appml.error.number | Die Fehlernummer. |
| $appml.error.description | Die Fehlerbeschreibung. |