The rebuild element
This action causes the default processing of xforms-rebuild to happen, bypassing the normal event flow (i.e. the behavior occurs without dispatching the xforms-rebuild event).
This action results in the XForms Processor rebuilding any internal data structures used to track computational dependencies among instance data nodes.
In general, the XForms processor automatically runs this action when required. As such, this action is included mostly for completeness.
However, if an action sequence includes a setvalue action that affects a node which is used in an XPath predicate in the nodeset of an XForms bind, then you may need to call rebuild to cause the XForms bind to be re-evaluated.
Example
| XML |
Copy Code
|
|---|---|
<xforms:trigger> <xforms:label>Rebuild</xforms:label> <xforms:rebuild ev:event="DOMActivate" model="x"/> </xforms:trigger> |
|
Attributes
| Name | Required / optional | Description |
|---|---|---|
| model | optional | XForms model selector, as defined in Single Node Binding Atttributes. If this attribute is omitted, then the default is the model associated with the in-scope evaluation context node. |
| 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) |
Content
The rebuild element does not allow any content.
Specification
Link to the XForms specification: the rebuild element.