XForms Message Element

Introduction

Used in combination with XML Event listeners to display a message to the user when the specified event occurs (see the spec). The message of the message element can exist in instance data, in a remote document, or as inline text. If more than one source of message is specified in this element, the order of precedence is: single node binding attributes, linking attributes, inline text.

Attributes

  • Single-Node Binding
  • Linking
    • src - URL of a document whose contents will be retrieved by the message element and used to provide the message text for the message element.
  • Special
    • level - defines a representation of message element

Type restrictions

The message element can be bound to any simple content.

Representations

It may be represented in the following ways:

  • modal window - if level attribute value is modal
  • modeless window - if level attribute value is modeless
  • tooltip window - if level attribute value is ephemeral

Note: message element doesn't define a default presentation. Therefore you should always specify a level attribute.

Example

<xforms:trigger>
  <xforms:label>It's a button</xforms:label>
  <xforms:message level="modal" ev:event="DOMActivate">Hello</xforms:message>
</xforms:trigger>