AppML Mesajlar ve Eylemler
AppML bir eylemi gerçekleştirmek üzere, bu uygulama nesnesi gönderir ($appml) kontrolöre.
Uygulama nesnesinin özelliklerinden biri bir mesajdır ($appml.message) uygulama durumunu açıklayan.
Bu mesajı Test, işleme bağlı olarak, kendi JavaScript kodu eklemek olanak sağlar.
Örnek
function myController($appml) {
if ($appml.message == "ready") {alert ("Hello
Application");}
}
Kendin dene " AppML Mesajlar
Bu alınabilir AppML mesajlarının listesidir:
Mesaj | Açıklama |
---|---|
"ready" | AppML sonra Gönderilen başlatılan ve verilerini yüklemek için hazır hale gelir. |
"loaded" | AppML sonra gönderilen tamamen verileri görüntülemek için hazır yüklenir. |
"display" | AppML Bir veri öğesi görüntüler önce gönderildi. |
"done" | AppML yapıldıktan sonra Gönderilen (finished displaying) . |
"submit" | AppML verilerini girmeden önce gönderildi. |
"error" | AppML bir hatayla karşılaştı sonra gönderilir. |
"ready" İleti
Bir AppML uygulama verilerini yüklemek için hazır olduğunda, bu bir göndereceğiz "ready" mesajı.
Bu, ilk veri ile uygulamayı sağlamak için mükemmel bir yer (start values) :
Örnek
<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>
Kendin dene " Yukarıdaki örnekte, $ appml.message olduğunda "ready" , kontrolör uygulamasına iki yeni özellikler ekleyen ( today and copyright ) .
Uygulama çalıştırıldığında, yeni özellikler uygulamaya mevcuttur.
"loaded" İleti
Bir AppML uygulama verileri ile yüklendiğinde (ready to display) , bir göndereceğiz " loaded " mesajı.
Bu değişiklikleri sağlamak için mükemmel bir yerdir (if necessary) yüklü verilere.
Örnek
function myController($appml) {
if ($appml.message == "loaded") {
// compute your values here before display
}
}
"display" İleti
AppML Bir veri öğesi görüntüleyen Her seferinde, bir göndereceğiz " display " mesajı.
Bu çıktıyı değiştirmek için mükemmel bir yerdir:
Örnek
<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>
Kendin dene " Yukarıdaki örnekte, "CustomerName" 15 karakter olarak kesildi ve "Country" harfe dönüştürülür.
"done" İleti
Bir AppML uygulama verilerini gösteren bitirdiğinde, o gönderir " done " mesajı.
Bu temizlemek ya da (ekran sonra) uygulama verilerini hesaplamak için mükemmel bir yerdir.
Örnek
<script>
function myController($appml) {
if ($appml.message == "done") {
calculate data here
}
}
</script>
"submit" İleti
Bir AppML uygulama verilerini göndermeye hazır olduğunda, bu bir göndereceğiz " submit " mesajı.
Bu uygulama girişini doğrulamak için mükemmel bir yerdir.
Örnek
<script>
function myController($appml) {
if ($appml.message == "submit") {
validate data here
}
}
</script>
"error" iletisi
Bir hata oluşursa, AppML bir göndereceğiz " error " iletisi.
Bu hataları işlemek için mükemmel bir yerdir.
Örnek
<script>
function myController($appml) {
if ($appml.message ==
"error") {
alert ($appml.error.number + " " + $appml.error.description)
}
}
</script>
AppML Özellikleri
Bu yaygın olarak kullanılan bazı AppML özelliklerinin listesi aşağıdadır:
özellik | Açıklama |
---|---|
$appml.message | Uygulamanın şu anki durumu. |
$appml.display.name | hakkında veri alanının adı, görüntülenmesini sağlar. |
$appml.display.value | ilgili veri alanı değeri görüntülenmesini sağlar. |
$appml.error.number | Hata numarası. |
$appml.error.description | Hata açıklaması. |