The message element
This action encapsulates a message to be displayed to the user.
The message specified can exist in instance data or as inline text (mixed content). If more than one source of message is specified in this element, the order of precedence is: single node binding attributes, inline text.
The user interface for the message action is considered to be created at the time the action occurs. If the message is obtained from the inline content of the message action, then the output of any output controls in the message content is determined based on the instance data available when the message action occurs.
Example
| XML |
Copy Code
|
|---|---|
<xforms:action ev:event="xforms-ready"> <xforms:setvalue ref="name">your name</setvalue> <xforms:message level="modal">Hello, <xforms:output ref="name"/>!</message> </xforms:action> |
|
Attributes
| Name | Required / optional | Description |
|---|---|---|
| level | optional | Author-optional attribute containing a message level identifier, one of ephemeral, modeless, modal or a 'QNameButNotNCName'. The default is modal if the attribute is not specified. |
| Single Node Binding | optional | One or more attributes from the Single Node Binding Attributes group (ref, model, bind). |
| Common Attributes | optional | Any attribute from the Common Attributes collection (e.g. id). |
| XML Events | optional | Any attribute from the XML Events collection (e.g. ev:event) |
| Common Action Attributes | optional | Any attribute from the Common Action Attributes collection (if or while) |
| Linking Attributes | optional | Any attribute from the Linking Attributes group (e.g. src). |
Content
Within an message element, the following child elements are allowed (optionally mixed within inline text content):
| Element Name | Required / optional | Description |
|---|---|---|
| output | optional | Zero or more xforms:output elements. |
Specification
Link to the XForms specification: the message element.