# XForms models ## Placement of local models A component can have its own set of XForms models, called *local models*. For each instance of the component, a new copy of the models is made, so that component instances behave completely independently from each other. With XForms 1.1, the standard convention is to place your models under the `` element. An XBL component does not have an `` element, so Orbeon Forms supports placing models in two places: * Under the `` element. In this case, models are identical for all instances of a particular component. * Under the `` element. In this case, models can be different depending on the component instance, since the XBL template can parametrize its elements and attributes. *NOTE: In XBL, the purpose of* `` *is to place new methods and properties. Orbeon Forms uses XForms as the implementation or "scripting" language of XBL components, so it does not have methods and properties. But models, through events, can implement behavior, so allowing model placement under* `` *seems to fit the intent of XBL.* ## Local model-related events XForms 1.1 specifies the following event sequence upon value changes, insertions, etc.: * `rebuild` (if document structure changed): update binds structure/dependencies * `recalculate` (if value changed): perform MIPs and calculated values updates * `revalidate` (if value changed): perform instance revalidation * `refresh`: updates the UI and dispatch UI events XBL components with local models are no different and they receive these events when needed. ## Construction and destruction of local models The following rules apply: * Models go through initialization when a sub-tree of controls is created. * Situations: * control becomes relevant * a repeat iteration is bound to a new node * Events dispatched upon creation: * `xforms-model-construct` * `xforms-model-construct-done` * events dispatched upon receiving `xforms-enabled` * \[SINCE Orbeon Forms 4.10] `xforms-ready` * Models go through destruction when a sub-tree of controls is deleted. * Situations: * control becomes non-relevant * a repeat iteration is no longer bound to a node * Events dispatched: * `xforms-model-destruct` * Models do not get construction/destruction events when iterations change --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://doc.orbeon.com/xforms/xbl/guide/xforms-models.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.