Fragment

amx:fragmentDef, amx:fragment

The Fragment is a dynamic declarative component that allows for reusable parts of an AMX page elements, including attributes and facets, to be inserted into the content represented by a template. This enables you to standardize the look and feel of your application by reusing the Fragment template across various pages within the application. In addition to that, the Fragment also supports:

Embedded popups.
Definition of its own facets. This allows you to create a component such as a layout component that defines a header facet, summary facet, and detail facet, with each facet having its own style class as well as look and feel.
Data model with both attributes and collections.

First, you need to create/define a fragment and then include the contents of the fragment in an AMX page:

amx:fragmentDef: Defines a page fragment.
amx:fragment: Includes a fragment of a page into the current page. It allows for facets to serve as place holders and accepts attributes and methods to be passed to the fragment.

This component is used on tablets and phones.

Appearance

Appearance characteristics for this component.

The Fragment appearance depends on its definition.

Behavior

Common behaviors for this component.

The Fragment receives all the information through its attributes.
In addition to defining individual attributes, you can define a set of attributes to be passed to the Fragment as a list which could be iterated through in the Fragment definition.
Changes: When a page fragment is modified, the pages that consume the page fragment are automatically updated with the modifications.

Usage

Usage guidelines for this component.

Use it when you need to simplify the process of building and maintaining complex pages.
Break down complex pages into several smaller page fragments and reuse them in other pages. For example, suppose different parts of several pages use the same form, then you might find it beneficial to create page fragments containing those components in the form, and reuse those page fragments in several pages.
You can use same page fragment more than once in a page and in multiple pages.
With pages built from page fragments, when you make layout changes, it is highly probable that modifying the page fragments alone is not sufficient; you may also have to modify every page that consumes the page fragments.

Sample

AMX sample code for this component.

The following sample code shows a fragment definition:

 <amx:fragmentDef xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:amx="http://xmlns.oracle.com/adf/mf/amx"
    xmlns:dvtm="http://xmlns.oracle.com/adf/mf/amx/dvt">

    <fragment xmlns="http://xmlns.oracle.com/adf/mf/amx/fragment" id="f1">

    <description id="d1">Description of the fragment</description>

    <facet id="f2">

    <description id="d4">Description of the facet</description>

    <facet-name id="f3">facet1</facet-name>

    </facet>

    <attribute id="a1">

    <description id="d2">Description of an attribute</description>

    <attribute-name id="a2">text</attribute-name>

    <attribute-type id="at1">String</attribute-type>

    <default-value id="d3">defaultValue</default-value>

    </attribute>

    </fragment>

    <amx:panelGroupLayout id="pgl1">

    <amx:facetRef facetName="facet1" id="fr1"/>

    <amx:outputText value="#{text}" id="ot1"/>

    </amx:panelGroupLayout>

    </amx:fragmentDef>

The following sample code shows how to include the contents of a fragment in an AMX page:

 <amx:fragment id="f1" 
    src="/simpleFragment.amxf">

    <amx:attribute id="a1"
    name="text" 
    value="defaultValue" />

    <amx:facet name="facet">

    <amx:outputText id="ot5" value="Fragment"/>

    </amx:facet>

    </amx:fragment>

Used On: Phone, Tablet
Also Called: Frame
Related Components: None
Resources: None