Areas

The “SourceArea”, “TargetArea” and "RefreshableArea" elements that exist under "mor > Ajax > Areas" branch of the library are used to define either Ajax target or Ajax source areas. The content of a target area can be refreshed with the dynamically generated content of a source area. The area refresh definitions can be made either with RefreshAreasAction or RefreshAreasProcess elements.
 

TargetArea

TargetArea element is used to define a page part on a page to be refreshed. It is derived from a panel element and therefore may contain a content that is visible until the refresh operation.

SourceArea

SourceArea element is used to provide a new content for a target area. This element needs to be placed into another page which is called as a source page.

A source page may contain one or more SourceArea elements. Source pages can not be requested to be displayed like normal pages. Although there is no restriction in the number of the SourceArea elements that a source page may contain, it should be taken into account that the whole page is subject to the XSLT processing.

Therefore it is recommended to place only one SourceArea in a page or to place the SourceAreas that need to be refreshed together in the same page.

RefreshableArea

A RefreshableArea is both a TargetArea and a SourceArea at the same time and therefore it is practical since there is no need to define an additional SourceArea in a separate source page.

This element must be used carefully since during the refreshing of its content the whole page that it locates in is subject to XSLT processing. Also note that the data sources used outside the RefreshableArea are not triggered. If, for example, the RefreshableArea is in a repeating panel, you may not get the result you expected since the data source of the repeating panel is not triggered.

The area refresh definitions can be made either with RefreshAreasAction or RefreshAreasProcess elements.