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") {
        // compute your values here before display
    }
}

"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 错误描述。