About the Body Element

The body element is a container for the body of a UIX document in ADF UIX. This element is required as the root of all content that you wish to be used in windows opened from UIX components content. The body element is automatically added for you when you create any UIX XML page in JDeveloper.

The attributes you can set for the body element are:

dirty - Specifies a boolean value that determines whether the page should be treated as immediately "dirty". This attribute is not supported on the following agent types: pda, phone, voice. If set to true, and the navigationFormName attribute has been set, then a "navigate" event will always be delivered even if the user has not modified the page in any way. (Note that if the "onNavigate" handler returns false, then navigation will be blocked.)
initialFocusId - Specifies the id of the component to which you want the focus to be when the full page renders. The <accessibility-mode> element in the UIX configuration file (uix-config.xml) must be set to inaccessible for this feature to be on. This attribute is not supported on the following agent types: pda, phone, voice.
navigationFormName - Specifies a form name that will be used as a proxy for navigating off the page. This attribute is not supported on the following agent types: pda, phone, voice.
When navigationFormName is used, UIX will automatically track the state of that form and all links that lead to other pages.
- If a link is clicked and the form has been edited, UIX will block the link, and instead submit the form.
- When the form is submitted, it will include a "navigate" event. A "uri" parameter in this event will include the URL that the user was trying to navigate to. Note that not all navigation off the page can be blocked. For example, selecting a bookmark will not go through this mechanism, nor will any JavaScript code that navigates pages.
- In addition, you should make sure that all components on the page that submit events are set to the "formSubmitted" mode.
- This feature gives applications an opportunity to save any intermediate work on behalf of the user, even if a link leads to an entirely different server.
- If the target form has not been edited, the user will simply navigate to the target page without any interruption or any server-side notification.

Use the body element to attach onLoad, onUnload, and other handlers to the UIX page.

onLoad - an onload JavaScript handler.
onNavigate - a JavaScript callback that will be executed before delivering a "navigate" event. The callback can return false, which will block navigation. The callback receives two parameters: 'formName', which is the form name to be submitted, and 'uri', the URI to which the user was navigating.
onUnload - an onunload JavaScript handler.


Example:

...
<body>
  <contents>
    <styledText text="Here is some text inside a body element"
  </contents>
</body>
...