AppML 消息
AppML 消息和操作
当 AppML 即将执行操作时，它会将应用程序对象 ($appml) 发送到控制器。
应用程序对象的属性之一是消息 ($appml.message)，描述应用程序状态。
测试此消息后，您可以根据操作添加自己的 JavaScript 代码。
实例
function myController($appml) {
if ($appml.message == "ready") {alert ("Hello
Application");}
}
亲自试一试 »
AppML 消息
这是可以接收的 AppML 消息列表:
| 消息 | 描述 |
|---|---|
| "ready" | 在 AppML 启动并准备好加载数据后发送。 |
| "loaded" | AppML 完全加载后发送，准备显示数据。 |
| "display" | 在 AppML 显示数据项之前发送。 |
| "done" | AppML 完成后发送（显示完毕）。 |
| "submit" | 在 AppML 提交数据之前发送。 |
| "error" | 在 AppML 遇到错误后发送。 |
"ready"消息
当 AppML 应用程序准备好加载数据时，它会发送"就绪"消息。
这是为应用程序提供初始数据（起始值）的理想场所:
实例
<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 = "W3Schools"
}
}
</script>
亲自试一试 »
在上面的示例中，当 $appml.message 为"ready"时，控制器向应用程序添加两个新属性（today 和 copyright)。
当应用程序运行时，新属性可供应用程序使用。
"loaded"消息
当 AppML 应用程序加载数据（准备显示）时，它会发送"loaded"消息。
这是为加载的数据提供更改（如有必要）的理想场所。
实例
function myController($appml) {
if ($appml.message == "loaded") {
// 在显示之前在此处计算您的值
}
}
"display"消息
AppML 每次显示数据项时，都会发送"display"消息。
这是修改输出的最佳位置:
实例
<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>
亲自试一试 »
在上面的示例中，"CustomerName"被截断为 15 个字符，"Country"被转换为大写。
"done"消息
当 AppML 应用程序完成显示数据后，它将发送"done"消息。
这是清理或计算应用程序数据（显示后）的理想场所。
实例
<script>
function myController($appml) {
if ($appml.message == "done") {
calculate data here
}
}
</script>
"submit"消息
当 AppML 应用程序准备好提交数据时，它会发送"submit"消息。
这是验证应用程序输入的理想场所。
实例
<script>
function myController($appml) {
if ($appml.message == "submit") {
validate data here
}
}
</script>
"error"消息
如果发生错误，AppML 将发送"error"消息。
这是处理错误的理想场所。
实例
<script>
function myController($appml) {
if ($appml.message ==
"error") {
alert ($appml.error.number + " " + $appml.error.description)
}
}
</script>
AppML 属性
这是一些常用的 AppML 属性的列表:
| 属性 | 描述 |
|---|---|
| $appml.message | 应用程序的当前状态。 |
| $appml.display.name | 即将显示的数据字段的名称。 |
| $appml.display.value | 即将显示的数据字段的值。 |
| $appml.error.number | 错误号。 |
| $appml.error.description | 错误描述。 |
