Difference between revisions of "Message Box"
(Created page with ' {{ZKDevelopersGuidePageHeader}} == The Message Box == The <tt>org.zkoss.zul.Messagebox</tt> class provides a set of utilities to show message boxes. It is typically used to ale…') |
m (correct highlight (via JWB)) |
||
| (One intermediate revision by one other user not shown) | |||
| Line 1: | Line 1: | ||
| + | {{ZKDevelopersGuidePageHeader}} | ||
| − | {{ | + | {{Old Version |
| + | |url=http://books.zkoss.org/wiki/ZK_Developer%27s_Reference/UI_Patterns/Message_Box | ||
| + | |}} | ||
== The Message Box == | == The Message Box == | ||
| − | The < | + | The <code>org.zkoss.zul.Messagebox</code> class provides a set of utilities to show message boxes. It is typically used to alert user when an error occurs, or to prompt user for an decision. |
<source lang="java" > | <source lang="java" > | ||
| Line 11: | Line 14: | ||
</source> | </source> | ||
| − | Since it is common to alert user for an error, a global function called < | + | Since it is common to alert user for an error, a global function called <code>alert</code> is added for zscript. The <code>alert</code> function is a shortcut of the <code>show</code> method in the <code>Messagebox</code> class. In other words, The following two statements are equivalent. |
<source lang="java" > | <source lang="java" > | ||
| Line 18: | Line 21: | ||
</source> | </source> | ||
| − | Notice that < | + | Notice that <code>Messagebox</code> is a modal window so it shares the same constraint: executable only in an event listener. Thus, the following codes will fail. Refer to the '''Modal Windows and Event Listeners''' section above for more descriptions. |
<source lang="xml" > | <source lang="xml" > | ||
Latest revision as of 02:58, 20 January 2022
This documentation is for an older version of ZK. For the latest one, please click here.
This documentation is for an older version of ZK. For the latest one, please click here.
The Message Box
The org.zkoss.zul.Messagebox class provides a set of utilities to show message boxes. It is typically used to alert user when an error occurs, or to prompt user for an decision.
if (Messagebox.show("Remove this file?", "Remove?", Messagebox.YES | Messagebox.NO, Messagebox.QUESTION) == Messagebox.YES) {
...//remove the file
}
Since it is common to alert user for an error, a global function called alert is added for zscript. The alert function is a shortcut of the show method in the Messagebox class. In other words, The following two statements are equivalent.
alert("Wrong");
Messagebox.show("Wrong");
Notice that Messagebox is a modal window so it shares the same constraint: executable only in an event listener. Thus, the following codes will fail. Refer to the Modal Windows and Event Listeners section above for more descriptions.
<window title="Messagebox not allowed in paging loading">
<zscript>
//failed since show cannot be called in paging loading
if (Messagebox.show("Redirect?", "Redirect?",
Messagebox.YES | Messagebox.NO, Messagebox.QUESTION) == Messagebox.YES)
Executions.sendRedirect("another.zul");
</zscript>
</window>