ऐपएमएल संदेश
AppML संदेश और क्रियाएँ
जब AppML कोई क्रिया करने वाला होता है, तो वह नियंत्रक को एप्लिकेशन ऑब्जेक्ट ($appml) भेजता है।
एप्लिकेशन ऑब्जेक्ट के गुणों में से एक संदेश ($appml.message) है, जो एप्लिकेशन स्थिति का वर्णन करता है।
इस संदेश का परीक्षण करने से आप कार्रवाई के आधार पर अपना स्वयं का जावास्क्रिप्ट कोड जोड़ सकते हैं।
उदाहरण
function myController($appml) {
if ($appml.message == "ready") {alert ("Hello
Application");}
}
ऐपएमएल संदेश
यह प्राप्त किए जा सकने वाले AppML संदेशों की एक सूची है:
| Message | Description |
|---|---|
| "ready" | Sent after AppML is initiated, and ready to load data. |
| "loaded" | Sent after AppML is fully loaded, ready to display data. |
| "display" | Sent before AppML displays a data item. |
| "done" | Sent after AppML is done (finished displaying). |
| "submit" | Sent before AppML submits data. |
| "error" | Sent after AppML has encountered an error. |
"तैयार" संदेश
जब कोई ऐपएमएल एप्लिकेशन डेटा लोड करने के लिए तैयार होता है, तो यह एक "तैयार" संदेश भेजेगा।
एप्लिकेशन को प्रारंभिक डेटा (प्रारंभ मान) प्रदान करने के लिए यह एक आदर्श स्थान है:
उदाहरण
<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 "तैयार" होता है, तो नियंत्रक ऐप्लिकेशन में दो नए गुण जोड़ता है ( आज और कॉपीराइट )।
जब एप्लिकेशन चलता है, तो नए गुण एप्लिकेशन के लिए उपलब्ध होते हैं।
"लोड" संदेश
जब एक ऐपएमएल एप्लिकेशन डेटा (प्रदर्शित करने के लिए तैयार) के साथ लोड होता है, तो यह एक " लोडेड " संदेश भेजेगा ।
लोड किए गए डेटा में परिवर्तन (यदि आवश्यक हो) प्रदान करने के लिए यह एक आदर्श स्थान है।
उदाहरण
function myController($appml) {
if ($appml.message == "loaded") {
// compute your values here before 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>
ऊपर दिए गए उदाहरण में, "ग्राहक नाम" को 15 वर्णों तक छोटा कर दिया गया है, और "देश" को अपर केस में बदल दिया गया है।
"किया" संदेश
जब एक ऐपएमएल एप्लिकेशन ने डेटा प्रदर्शित करना समाप्त कर दिया है, तो यह एक "हो गया " संदेश भेजेगा ।
एप्लिकेशन डेटा (प्रदर्शन के बाद) को साफ करने या गणना करने के लिए यह एक आदर्श स्थान है।
उदाहरण
<script>
function myController($appml) {
if ($appml.message == "done") {
calculate data here
}
}
</script>
"सबमिट" संदेश
जब कोई ऐपएमएल एप्लिकेशन डेटा जमा करने के लिए तैयार होता है, तो यह एक " सबमिट " संदेश भेजेगा ।
एप्लिकेशन इनपुट को मान्य करने के लिए यह सही जगह है।
उदाहरण
<script>
function myController($appml) {
if ($appml.message == "submit") {
validate data here
}
}
</script>
"त्रुटि" संदेश
यदि कोई त्रुटि होती है, तो AppML एक " त्रुटि " संदेश भेजेगा ।
त्रुटियों को संभालने के लिए यह एक आदर्श स्थान है।
उदाहरण
<script>
function myController($appml) {
if ($appml.message ==
"error") {
alert ($appml.error.number + " " + $appml.error.description)
}
}
</script>
ऐपएमएल गुण
यह आमतौर पर उपयोग की जाने वाली कुछ AppML संपत्तियों की सूची है:
| Property | Description |
|---|---|
| $appml.message | The current state of the application. |
| $appml.display.name | The name of the data field about to be displayed. |
| $appml.display.value | The value of the data field about to be displayed. |
| $appml.error.number | The error number. |
| $appml.error.description | The error description. |