About UIX XML Page Structure

A UIX XML page is a namespace-aware XML document that specifies the page layout, data sources, and events for an ADF UIX user interface in UIX XML (an XML dialect). Designing and formatting a user interface page in UIX XML involves working with UIX XML elements. Each page consists of a hierarchical tree of UIX XML elements that represent a page of a UIX application.

A UIX XML page or file has the extension .uix. Like any XML document, a UIX XML page must be well formed and valid, complying with schemas that describe the rules for UIX XML elements semantics and XML syntax.

To simplify page and application development with UIX XML, you can use one of the wizards included in the ADF UIX category of the New Gallery. For example, an empty UIX page written in UIX XML would look like this:


Example of a UIX page written in UIX XML:

<?xml version="1.0" encoding="windows-1252"?>
<page xmlns="http://xmlns.oracle.com/uix/controller"
      xmlns:ui="http://xmlns.oracle.com/uix/ui"
      xmlns:ctrl="http://xmlns.oracle.com/uix/controller"
      xmlns:html="http://www.w3.org/TR/REC-html40"
      expressionLanguage="el">
  <content>
    <dataScope xmlns="http://xmlns.oracle.com/uix/ui">
      <provider>
        <!-- Add data sources here -->
      </provider>

      <contents>
        <!-- Start page content here --> 
        <document>
          <metaContainer>
            <!-- Set the page title -->
            <head title=""/> 
          </metaContainer>
          <contents>
            <body>
              <contents>
                <form name="form0">
                  <contents> 
                    <pageLayout title=""> 

                      <!-- Main contents -->
                      <contents>
                        <!-- Define the content of the page here --> 
                      </contents>

                      <!-- Navigation -->
                      <tabs/>
                      <globalButtons/>
                      <pageButtons/>
                      <pageHeader/>

                      <!-- Side sections -->
                      <start/>
                      <end/>

                      <!-- Footer sections -->
                      <about/>
                      <copyright/>
                      <privacy/>

                      <!-- Branding images -->
                      <corporateBranding/>
                      <productBranding/>
                    </pageLayout> 
                  </contents>
                </form>
              </contents>
            </body>
          </contents>
        </document>
      </contents>
    </dataScope>
  </content>

  <handlers>
    <!-- Add event handlers here -->
  </handlers>

</page>

Notes:

By default UIX adds the namespaces for UIX user interface components (http://xmlns.oracle.com/uix/ui) and the UIX Controller (http://xmlns.oracle.com/uix/controller).
The three main sections are <provider> (for data sources), <contents> (for page content and layout), and <handlers> (for event handlers).
Define the layout of a page (main content and navigation elements) in the <pageLayout> section.
You must specify a title attribute for the <pageLayout> element.

A UIX XML page that is based on a UIX XML template (UIT) would include elements at the beginning of the file to import the template:


Example of a UIX page based on a UIT written in UIX XML:

<?xml version="1.0" encoding="windows-1252"?>
<page xmlns="http://xmlns.oracle.com/uix/controller"
      xmlns:ui="http://xmlns.oracle.com/uix/ui">
      xmlns:data="http://xmlns.oracle.com/uix/ui"
      xmlns:ctrl="http://xmlns.oracle.com/uix/controller"
      xmlns:html="http://www.w3.org/TR/REC-html40"
      expressionLanguage="el"
      xmlns:myTemplate="http://www.demos.org/examples"
  <templates xmlns="http://xmlns.oracle.com/uix/ui">
    <templateImport source="someBasicTemplate.uit"/>
  </templates>
  <content>
    <dataScope xmlns="http://xmlns.oracle.com/uix/ui">
      <provider/>
      <contents>
        <document>
          <metaContainer>
            <head title="Some title"/>
          </metaContainer>
          <contents>
            <body>
              <contents>
                <form name="form0">
                  <contents>
                    <myTemplate:demopage title="Some title">
                      <contents/>
                    </myTemplate:demopage>
                  </contents>
                </form>
              </contents>
            </body>
          </contents>
        </document>
      </contents>
    </dataScope>
  </content>
  <handlers/> 
</page>

For complete information about creating pages and how templates are used in UIX XML pages, refer to the ADF UIX Developer's Guide.