]> Chapter 10: Actions Chapter 10: Actions
10.1 The XForms Action Module
  • Actions an implementation does not recognize should be silently ignored.
    •
    10.1.1 The action Element
  • If an ev:event attribute is specified on the action element, the action is triggered when the corresponding event is targeted at its parent (this is XML Events)
  • Children of the action element are processed in sequence, with each action completing before the next begins.
  • At the end of processing the <action> element, the UI and instance MUST be completely up to date.
  • rebuild actions must be processed immediately.
  • If a rebuild is flagged to occur and the rebuild action is processed, the rebuild action MUST NOT occur at the end of <action> processing.
  • recalculate actions must be processed immediately.
  • If a recalculate is flagged to occur and the recalculate action is processed, the recalculate action MUST NOT occur at the end of <action> processing.
  • revalidate actions must be processed immediately.
  • If a revalidate is flagged to occur and the revalidate action is processed, the revalidate action MUST NOT occur at the end of <action> processing.
  • refresh actions must be processed immediately.
  • If a refresh is flagged to occur and the refresh action is processed, the refresh action MUST NOT occur at the end of <action> processing.
  • When the insert action has been processed, the rebuild,recalculate,revalidate, and refresh actions MUST NOT occur until <action> processing concludes, at which time the actions MUST occur.
  • When the delete action has been processed, the rebuild,recalculate,revalidate, and refresh actions MUST NOT occur until <action> processing concludes, at which time the actions MUST occur.
  • When the setvalue action has been processed, the recalculate,revalidate, and refresh actions MUST NOT occur until <action> processing concludes, at which time the actions MUST occur.
  • When the setvalue action has been processed, the rebuild action MUST NOT occur.
  • When the setindex action has been processed, the recalculate,revalidate, and refresh actions MUST NOT occur until <action> processing concludes, at which time the actions MUST occur.
  • When the setindex action has been processed, the rebuild action MUST NOT occur.
  • reset actions must be processed immediately.
  • If a rebuild,recalculate,revalidate or refresh is flagged to occur and the reset action is processed, the flagged actions MUST NOT occur at the end of <action> processing.
  • If a toggle action causes a rebuild,recalculate,revalidate, or refresh then SOMETHING SOMETHING SOMETHING
  • When the dispatch action is processed, the rebuild,recalculate,revalidate, and refresh actions MUST NOT occur.
  • When the setfocus action is processed, the rebuild,recalculate,revalidate, and refresh actions MUST NOT occur.
  • When the load action is processed, the rebuild,recalculate,revalidate, and refresh actions MUST NOT occur.
  • When the message action is processed, the rebuild,recalculate,revalidate, and refresh actions MUST NOT occur.
  • When the send action is processed, and the current document is *not* replaced, the rebuild,recalculate,revalidate, and refresh actions MUST NOT occur at the end of <action> processing.
  • <action> actions must be processed immediately.
  • If a rebuild,recalculate,revalidate or refresh is flagged to occur and a child <action> is processed, the flagged actions MUST NOT occur at the end of the parent's action processing.
    •
    10.1.2 The dispatch Element
  • dispatch actions with no name or with no target MUST be ignored.
  • XForms events MUST be fired.
  • Events MUST not prepend "xforms-" to the event name when firing.
  • For XForms events, the bubbles and cancelable attributes MUST be ignored.
  • Non-XForms events MUST be fired.
  • For Non-XForms events, the bubbles and cancelable attributes MUST be honored.
  • Non-existent targets MUST be ignored.
    •
    10.1.3 The rebuild Element
  • rebuild actions with no model attribute or whose specified model does not exist MUST be ignored.
  • The rebuild action MUST dispatch a rebuild event to the specified model.
    •
    10.1.4 The recalculate Element
  • recalculate actions with no model attribute or whose specified model does not exist MUST be ignored.
  • The recalculate action MUST dispatch a recalculate event to the specified model.
    •
    10.1.5 The revalidate Element
  • revalidate actions with no model attribute or whose specified model does not exist MUST be ignored.
  • The revalidate action MUST dispatch a revalidate event to the specified model.
    •
    10.1.6 The refresh Element
  • refresh actions with no model attribute or whose specified model does not exist MUST be ignored.
  • The refresh action MUST dispatch a refresh event to the specified model.
    •
    10.1.7 The setfocus Element
  • setfocus actions with no control attribute or whose specified control does not exist MUST be ignored.
  • setfocus action must fire the xforms-focus event at the specified control.
  • If a setfocus element is targeted at a <repeat> element or a descendant thereof, the xforms-focus event MUST be dispatched to the corresponding control in the repeat item at the current repeat index
    •
    10.1.8 The load Element
  • load actions with no resource attribute and no (model+ref or bind) MUST be ignored.
  • load actions with resource attribute *and* (model, ref or bind) MUST be ignored.
  • load actions with resource attribute MUST load the resource.
  • load actions with "bind"-specified resource pointed at no nodes MUST be ignored.
  • load actions with "bind"-specified resource pointed at multiple nodes MUST load the resource specified in the first node.
  • load actions with "ref"-specified resource pointed at no nodes MUST be ignored.
  • load actions with "ref"-specified resource pointed at multiple nodes MUST load the resource specified in the first node.
  • load actions with a failed link MUST fire the xforms-link-error event with the resource URI in it.
  • load actions with show="new" MUST NOT replace the current document with the new link and MUST show the new document somewhere else.
  • load actions with show="replace" MUST replace the current document with the new link.
  • load actions with no show attribute MUST be treated as "replace".
    •
    10.1.9 The setvalue Element
  • setvalue actions with no model+ref or bind attribute MUST be ignored.
  • setvalue actions pointed at an element with no text node child MUST create a textnode with the specified value as the first child of the element.
  • setvalue actions pointed at an element with multiple text node children MUST replace the first textnode with the specified value.
  • setvalue actions pointed at an attribute MUST set the attribute's value to the specified value.
  • setvalue actions pointed at a textnode MUST replace the textnode with the specified value
  • setvalue actions with no value attribute and no text MUST set the corresponding node to "".
  • setvalue actions with text and no value attribute MUST set the corresponding node to the text.
  • setvalue actions with value attribute and no text MUST set the corresponding node to the value.
  • setvalue actions with value attribute and text MUST set the corresponding node to the value.
  • setvalue actions with model+ref pointed at no nodes MUST set the corresponding node to the value.
  • setvalue actions with model+ref pointed at multiple nodes MUST set the first node in the set to the value.
  • setvalue actions with bind pointed at no nodes MUST set the corresponding node to the value.
  • setvalue actions with bind pointed at multiple nodes MUST set the first node in the set to the value.
    •
    10.1.10 The send Element
  • send action must fire the xforms-submit event at the specified submission.
    •
    10.1.11 The reset Element
  • reset actions with no model attribute or whose specified model does not exist MUST be ignored.
  • reset action must fire the xforms-reset event at the specified model.
    •
    10.1.12 The message Element
  • message actions with no [resource|src] and no bind/ref/model and no text MUST be ignored.
  • message actions with no level MUST be ignored.
  • message actions with a failed [resource|src] link MUST fire the xforms- link-error event with the [resource|src] URI in it.
  • message actions with [resource|src] link MUST display the message.
  • message actions with bind/ref/model link MUST display the message.
  • message actions with textnode link MUST display the message.
  • message actions with level="ephemeral" SHOULD allow processing to continue immediately and SHOULD NOT require user interaction to remove the disruption from the user's experience.
  • message actions with level="modeless" SHOULD allow processing to continue immediately.
  • message actions with level="modal" SHOULD NOT allow processing to continue until the user has explicitly agreed to continue.
  • message actions with level values that are recognized by the user agent MUST be ignored.
    •

    NOTE: anyAttribute needs to be tested somewhere

    NOTE: that unrecognized event types should not cause problems for actions!