Messages et actions appml
Lorsque appml est sur le point d'effectuer une action, il envoie l'objet d'application ($appml) au contrôleur.
L' une des propriétés de l' objet d'application est un message ($appml.message) , décrivant l'état de l' application.
Tester ce message, vous permet d'ajouter votre propre code JavaScript, en fonction de l'action.
Exemple
function myController($appml) {
if ($appml.message == "ready") {alert ("Hello
Application");}
} Essayez vous - même » Messages appml
Voici une liste des messages appml qui peuvent être reçues:
| Message | La description |
|---|---|
| "ready" | Envoyé après appml est lancé et prêt à charger des données. |
| "loaded" | Envoyé après appml est complètement chargé, prêt à afficher les données. |
| "display" | Envoyé avant appml affiche un élément de données. |
| "done" | Envoyé après appml est fait (finished displaying) l' (finished displaying) . |
| "submit" | Envoyé avant appml envoie des données. |
| "error" | Envoyé après appml a rencontré une erreur. |
Le "ready" message
Lorsqu'une application appml est prêt à charger des données, il envoie un "ready" message.
Ceci est l'endroit idéal pour fournir à l'application des données initiales (start values) de (start values) :
Exemple
<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> Essayez vous - même » Dans l'exemple ci - dessus, lorsque le appml.message de $ est "ready" , le contrôleur ajoute deux nouvelles propriétés à l'application ( today and copyright ) le ( today and copyright ) d' ( today and copyright ) .
Lorsque l'application fonctionne, les nouvelles propriétés sont disponibles à la demande.
Le "loaded" message
Lorsqu'une application appml est chargé avec des données (ready to display) , il envoie un " loaded " message.
Ceci est l'endroit idéal pour fournir des changements (if necessary) le (if necessary) aux données chargées.
Exemple
function myController($appml) {
if ($appml.message == "loaded") {
// compute your values here before display
}
}Le "display" message
Chaque fois que appml affiche un élément de données, il envoie un " display " message.
Ceci est l'endroit idéal pour modifier la sortie:
Exemple
<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> Essayez vous - même » Dans l'exemple ci - dessus, "CustomerName" est tronquée à 15 caractères, et "Country" est converti en majuscules.
Le "done" un message
Lorsqu'une application appml a terminé l' affichage des données, il envoie un " done " un message.
Ceci est l'endroit idéal pour nettoyer ou calculer des données d'application (après affichage).
Exemple
<script>
function myController($appml) {
if ($appml.message == "done") {
calculate data here
}
}
</script>Le "submit" un message
Lorsqu'une application appml est prêt à soumettre des données, il envoie un " submit " message.
Ceci est l'endroit idéal pour valider l'entrée d'application.
Exemple
<script>
function myController($appml) {
if ($appml.message == "submit") {
validate data here
}
}
</script>La "error" message
Si une erreur se produit, appml envoie une " error " message.
Ceci est l'endroit idéal pour gérer les erreurs.
Exemple
<script>
function myController($appml) {
if ($appml.message ==
"error") {
alert ($appml.error.number + " " + $appml.error.description)
}
}
</script>Propriétés appml
Voici une liste de quelques propriétés appml couramment utilisées:
| Propriété | La description |
|---|---|
| $appml.message | L'état actuel de l'application. |
| $appml.display.name | Le nom du champ de données sur le point d'être affiché. |
| $appml.display.value | La valeur du champ de données sur le point d'être affiché. |
| $appml.error.number | Le numéro d'erreur. |
| $appml.error.description | La description de l'erreur. |