xforms:refreshAdded by IBM on October 10, 2012 | Version 1 (Original)
|Causes the forms viewing application to update all user interface elements linked to a particular model, so that they match the underlying data in the XForms model.
In general, the XForms processor automatically runs this action when required. As such, this action is included simply for completeness.
Table 1. refresh parameters
<xforms:refresh event model="model"/>
|event||string||The XForms event that triggers the action.|
|model||string||The ID of the model to refresh. If the model attribute is omitted, then the default model is used.|
Example The following button refreshes the model X when clicked:
<xforms:refresh ev:event="DOMActivate" model="X"/>
- This feature is most likely to be used on scaled-down XForms processors, in which the implicit rebuild-recalculate-revalidate-refresh sequence is not implemented because of limited resources. In this case, explicit requests for these actions may force an exchange with a server.
- If you are performing a number of consecutive submissions, refresh may be useful for updating the form to show progress, especially after submissions that return data to the form.