Skip to content

Latest commit

 

History

History
198 lines (116 loc) · 5.08 KB

Object_Page_Headers_d2ef009.md

File metadata and controls

198 lines (116 loc) · 5.08 KB
loio
d2ef0099542d44dc868719d908e576d0

Object Page Headers

The sap.uxap.ObjectPageLayout control has two types of header - classic header and dynamic header.


The sap.uxap.ObjectPageLayout control implements the snapping header concept. This means that the upper part of the header (Header Title) always stays visible, while the lower part (Header Content) can scroll out of view.

The common pattern is that the most important information describing the object, such as title, subtitle, and image is in the Header Content area when the header is expanded, and moves to the Header Title area when the header is collapsed (snapped - its lower part scrolled out of view).

sap.uxap.ObjectPageLayout header in expanded state

The following image shows the collapsed (snapped) header is where the Header Content area is scrolled out and not visible, and the main information is visible in the Header Title area.

sap.uxap.ObjectPageLayout Header in Collapsed (snapped) State


Up to version 1.52, only sap.uxap.ObjectPageHeader could have been used to build up the sap.uxap.ObjectPageLayout header.

Header area

sap.uxap.ObjectPageLayout aggregation

App must provide:

Header Title

headerTitle (0..1)

An instance of the sap.uxap.ObjectPageHeader control

Header Content

headerContent (0..n)

An array of arbitrary controls.

Note:

sap.uxap.ObjectPageHeaderContent control is used internally to display the controls.

The app provides an instance of sap.uxap.ObjectPageHeader as the value of the headerTitle aggregation, and arbitrary controls as the value of the headerContent aggregation (which are internally added to an instance of the sap.uxap.ObjectPageHeaderContent control).


As of version 1.52, a new sap.uxap.ObjectPageDynamicHeaderTitle control can be used to build a dynamic header for sap.uxap.ObjectPageLayout.

Header Area

sap.uxap.ObjectPageLayout aggregation

App Must Provide:

Header Title

headerTitle (0..1)

An instance of the sap.uxap.ObjectPageDynamicHeaderTitle control

Header Content

headerContent (0..n)

An array of arbitrary controls.

Note:

sap.uxap.ObjectPageDynamicHeaderContent control is used internally to display the controls.

Again, the app provides an instance of sap.uxap.ObjectPageDynamicHeaderTitle as the value of the headerTitle aggregation and a list of controls for the headerContent aggregation (sap.uxap.ObjectPageLayout uses internally sap.uxap.ObjectPageDynamicHeaderContent to lay out the controls).

Related Information

API Reference: sap.uxap.ObjectPageLayout

API Reference: sap.uxap.ObjectPageHeader

API Reference: sap.uxap.ObjectPageDynamicHeaderTitle