sap.uxap.ObjectPageLayout.extend(sClassName, oClassInfo?, FNMetaImpl?): function
Creates a new subclass of class sap.uxap.ObjectPageLayout with name
sClassName
and enriches it with the information contained in
oClassInfo
.
oClassInfo
might contain the same kind of information as described in sap.ui.core.Control.extend.
Parameters:
{string} | sClassName | Name of the class being created |
{object} | oClassInfo? | Object literal with information about the class |
{function} | FNMetaImpl? | Constructor function for the metadata object; if not given, it defaults to sap.ui.core.ElementMetadata |
Returns:
{function} | Created class / constructor function |
Returns a metadata object for class sap.uxap.ObjectPageLayout.
Returns:
Adds some headerContent to the aggregation headerContent
.
Parameters:
Returns:
Adds some section to the aggregation sections
.
Parameters:
Returns:
Attaches event handler
fnFunction
to the
editHeaderButtonPress
event of this
sap.uxap.ObjectPageLayout
.
When called, the context of the event handler (its this
) will be bound to oListener
if specified, otherwise it will be bound to this sap.uxap.ObjectPageLayout
itself.
The event is fired when the Edit Header button is pressed
Parameters:
{object} | oData? | An application-specific payload object that will be passed to the event handler along with the event object when firing the event |
{function} | fnFunction | The function to be called when the event occurs |
{object} | oListener? | Context object to call the event handler with. Defaults to this sap.uxap.ObjectPageLayout itself |
Returns:
Attaches event handler
fnFunction
to the
tabSelect
event of this
sap.uxap.ObjectPageLayout
.
When called, the context of the event handler (its this
) will be bound to oListener
if specified, otherwise it will be bound to this sap.uxap.ObjectPageLayout
itself.
The event is fired when the selected tab changes. Note: Event is fired only when IconTabBar is used for navigation.
Parameters:
{object} | oData? | An application-specific payload object that will be passed to the event handler along with the event object when firing the event |
{function} | fnFunction | The function to be called when the event occurs |
{object} | oListener? | Context object to call the event handler with. Defaults to this sap.uxap.ObjectPageLayout itself |
Returns:
Attaches event handler
fnFunction
to the
toggleAnchorBar
event of this
sap.uxap.ObjectPageLayout
.
When called, the context of the event handler (its this
) will be bound to oListener
if specified, otherwise it will be bound to this sap.uxap.ObjectPageLayout
itself.
The event is fired when the Anchor bar is switched from moving to fixed or the other way round.
Parameters:
{object} | oData? | An application-specific payload object that will be passed to the event handler along with the event object when firing the event |
{function} | fnFunction | The function to be called when the event occurs |
{object} | oListener? | Context object to call the event handler with. Defaults to this sap.uxap.ObjectPageLayout itself |
Returns:
Destroys all the headerContent in the aggregation headerContent
.
Returns:
Destroys the headerTitle in the aggregation headerTitle
.
Returns:
Destroys all the sections in the aggregation sections
.
Returns:
Detaches event handler
fnFunction
from the
editHeaderButtonPress
event of this
sap.uxap.ObjectPageLayout
.
The passed function and listener object must match the ones used for event registration.
Parameters:
{function} | fnFunction | The function to be called, when the event occurs |
{object} | oListener | Context object on which the given function had to be called |
Returns:
Detaches event handler
fnFunction
from the
tabSelect
event of this
sap.uxap.ObjectPageLayout
.
The passed function and listener object must match the ones used for event registration.
Parameters:
{function} | fnFunction | The function to be called, when the event occurs |
{object} | oListener | Context object on which the given function had to be called |
Returns:
Detaches event handler
fnFunction
from the
toggleAnchorBar
event of this
sap.uxap.ObjectPageLayout
.
The passed function and listener object must match the ones used for event registration.
Parameters:
{function} | fnFunction | The function to be called, when the event occurs |
{object} | oListener | Context object on which the given function had to be called |
Returns:
Fires event editHeaderButtonPress
to attached listeners.
Parameters:
{Map} | mArguments? | The arguments to pass along with the event |
Returns:
Fires event
tabSelect
to attached listeners.
Expects the following event parameters:
section
of type sap.uxap.ObjectPageSection
The selected section object.
Parameters:
{Map} | mArguments? | The arguments to pass along with the event |
Returns:
Fires event
toggleAnchorBar
to attached listeners.
Expects the following event parameters:
fixed
of type boolean
False indicates that the Anchor bar has just detached from the Header and became part of the scrolling area. True means that the Anchor bar has just snapped to the Header.
Parameters:
{Map} | mArguments? | The arguments to pass along with the event |
Returns:
getAlwaysShowContentHeader(): boolean
Gets current value of property
alwaysShowContentHeader
.
Determines whether Header Content will always be expanded on desktop.
Default value is false
.
- Since:
- 1.34.0
Returns:
{boolean} | Value of property alwaysShowContentHeader |
getEnableLazyLoading(): boolean
Gets current value of property
enableLazyLoading
.
Enable lazy loading for the Object page Subsections.
Default value is false
.
Returns:
{boolean} | Value of property enableLazyLoading |
getFlexEnabled(): boolean
Gets current value of property
flexEnabled
.
Specifies whether the object page enables flexibility features, such as hiding and adding sections.
For more information about SAPUI5 flexibility, refer to the Developer Guide.
Default value is false
.
- Since:
- 1.34.0
Returns:
{boolean} | Value of property flexEnabled |
Gets content of aggregation
headerTitle
.
Object page header title - the upper, always static, part of the Object page header.
Returns:
Gets current value of property
height
.
Determines the height of the ObjectPage.
Default value is 100%
.
Returns:
getIsChildPage(): boolean
Gets current value of property
isChildPage
.
Determines whether the page is a child page and renders it with a different design. Child pages have an additional (darker/lighter) stripe on the left side of their header content area.
Default value is false
.
- Since:
- 1.34.0
Returns:
{boolean} | Value of property isChildPage |
getScrollDelegate(): object
Returns a sap.ui.core.delegate.ScrollEnablement object used to handle scrolling
Returns:
getScrollingSectionId(): string
Returns the UI5 ID of the Section that is currently being scrolled.
Returns:
Gets content of aggregation
sections
.
The sections that make up the Object page content area.
Returns:
getShowAnchorBar(): boolean
Gets current value of property
showAnchorBar
.
Determines whether the Navigation bar (Anchor bar) is displayed.
Default value is true
.
Returns:
{boolean} | Value of property showAnchorBar |
getShowAnchorBarPopover(): boolean
Gets current value of property
showAnchorBarPopover
.
Determines whether to show a Popover with Subsection links when clicking on Section links in the Anchor bar.
Default value is true
.
Returns:
{boolean} | Value of property showAnchorBarPopover |
getShowEditHeaderButton(): boolean
Gets current value of property
showEditHeaderButton
.
Determines whether an Edit button will be shown in Header Content.
Default value is false
.
- Since:
- 1.34.0
Returns:
{boolean} | Value of property showEditHeaderButton |
getShowHeaderContent(): boolean
Gets current value of property
showHeaderContent
.
Determines the visibility of the Header content (headerContent aggregation).
Default value is true
.
Returns:
{boolean} | Value of property showHeaderContent |
getShowOnlyHighImportance(): boolean
Gets current value of property
showOnlyHighImportance
.
Determines whether sections and subsections with importance Low and Medium are hidden even on large screens.
Default value is false
.
- Since:
- 1.32.0
Returns:
{boolean} | Value of property showOnlyHighImportance |
getShowTitleInHeaderContent(): boolean
Gets current value of property
showTitleInHeaderContent
.
Determines whether the title, image, markers and selectTitleArrow are shown in the Header content area.
Default value is false
.
Returns:
{boolean} | Value of property showTitleInHeaderContent |
Gets current value of property
subSectionLayout
.
Determines whether Subsection titles are displayed on top or to the left of the Subsection content.
Default value is TitleOnTop
.
Returns:
getUpperCaseAnchorBar(): boolean
Gets current value of property
upperCaseAnchorBar
.
Determines whether the Anchor bar items are displayed in upper case.
Default value is true
.
Returns:
{boolean} | Value of property upperCaseAnchorBar |
getUseIconTabBar(): boolean
Gets current value of property
useIconTabBar
.
Use sap.m.IconTabBar instead of the default Anchor bar
Default value is false
.
Returns:
{boolean} | Value of property useIconTabBar |
getUseTwoColumnsForLargeScreen(): boolean
Gets current value of property
useTwoColumnsForLargeScreen
.
Determines whether the to use two column layout for the L screen size.
Default value is false
.
Returns:
{boolean} | Value of property useTwoColumnsForLargeScreen |
indexOfHeaderContent(oHeaderContent): int
Checks for the provided sap.ui.core.Control
in the aggregation headerContent
. and returns its index if found or -1 otherwise.
Parameters:
Returns:
{int} | The index of the provided control in the aggregation if found, or -1 otherwise |
indexOfSection(oSection): int
Checks for the provided sap.uxap.ObjectPageSection
in the aggregation sections
. and returns its index if found or -1 otherwise.
Parameters:
Returns:
{int} | The index of the provided control in the aggregation if found, or -1 otherwise |
Inserts a headerContent into the aggregation headerContent
.
Parameters:
{sap.ui.core.Control} | oHeaderContent | the headerContent to insert; if empty, nothing is inserted |
{int} | iIndex | the 0 -based index the headerContent should be inserted at; for a negative value of iIndex , the headerContent is inserted at position 0; for a value greater than the current size of the aggregation, the headerContent is inserted at the last position |
Returns:
Inserts a section into the aggregation sections
.
Parameters:
{sap.uxap.ObjectPageSection} | oSection | the section to insert; if empty, nothing is inserted |
{int} | iIndex | the 0 -based index the section should be inserted at; for a negative value of iIndex , the section is inserted at position 0; for a value greater than the current size of the aggregation, the section is inserted at the last position |
Returns:
Removes all the controls from the aggregation
headerContent
.
Additionally, it unregisters them from the hosting UIArea.
Returns:
Removes all the controls from the aggregation
sections
.
Additionally, it unregisters them from the hosting UIArea.
Returns:
Removes a headerContent from the aggregation headerContent
.
Parameters:
Returns:
Removes a section from the aggregation sections
.
Parameters:
Returns:
scrollToSection(sId, iDuration, iOffset)
Scrolls the Object page to the given Section.
Parameters:
{string} | sId | The Section ID to scroll to |
{int} | iDuration | Scroll duration (in ms). Default value is 0 |
{int} | iOffset | Additional pixels to scroll |
Sets a new value for property
alwaysShowContentHeader
.
Determines whether Header Content will always be expanded on desktop.
When called with a value of null
or undefined
, the default value of the property will be restored.
Default value is false
.
Parameters:
{boolean} | bAlwaysShowContentHeader | New value for property alwaysShowContentHeader |
- Since:
- 1.34.0
Returns:
setBusy(bBusy)
Overwrite setBusy, because the busyIndicator does not cover the header title, because the header title has z-index: 2 in order to appear on top of the content
Parameters:
Sets a new value for property
enableLazyLoading
.
Enable lazy loading for the Object page Subsections.
When called with a value of null
or undefined
, the default value of the property will be restored.
Default value is false
.
Parameters:
{boolean} | bEnableLazyLoading | New value for property enableLazyLoading |
Returns:
Sets a new value for property
flexEnabled
.
Specifies whether the object page enables flexibility features, such as hiding and adding sections.
For more information about SAPUI5 flexibility, refer to the Developer Guide.
When called with a value of null
or undefined
, the default value of the property will be restored.
Default value is false
.
Parameters:
{boolean} | bFlexEnabled | New value for property flexEnabled |
- Since:
- 1.34.0
Returns:
Sets the aggregated headerTitle
.
Parameters:
Returns:
Sets a new value for property
height
.
Determines the height of the ObjectPage.
When called with a value of null
or undefined
, the default value of the property will be restored.
Default value is 100%
.
Parameters:
Returns:
Sets a new value for property
isChildPage
.
Determines whether the page is a child page and renders it with a different design. Child pages have an additional (darker/lighter) stripe on the left side of their header content area.
When called with a value of null
or undefined
, the default value of the property will be restored.
Default value is false
.
Parameters:
{boolean} | bIsChildPage | New value for property isChildPage |
- Since:
- 1.34.0
Returns:
Sets a new value for property
showAnchorBar
.
Determines whether the Navigation bar (Anchor bar) is displayed.
When called with a value of null
or undefined
, the default value of the property will be restored.
Default value is true
.
Parameters:
{boolean} | bShowAnchorBar | New value for property showAnchorBar |
Returns:
Sets a new value for property
showAnchorBarPopover
.
Determines whether to show a Popover with Subsection links when clicking on Section links in the Anchor bar.
When called with a value of null
or undefined
, the default value of the property will be restored.
Default value is true
.
Parameters:
{boolean} | bShowAnchorBarPopover | New value for property showAnchorBarPopover |
Returns:
Sets a new value for property
showEditHeaderButton
.
Determines whether an Edit button will be shown in Header Content.
When called with a value of null
or undefined
, the default value of the property will be restored.
Default value is false
.
Parameters:
{boolean} | bShowEditHeaderButton | New value for property showEditHeaderButton |
- Since:
- 1.34.0
Returns:
Sets a new value for property
showOnlyHighImportance
.
Determines whether sections and subsections with importance Low and Medium are hidden even on large screens.
When called with a value of null
or undefined
, the default value of the property will be restored.
Default value is false
.
Parameters:
{boolean} | bShowOnlyHighImportance | New value for property showOnlyHighImportance |
- Since:
- 1.32.0
Returns:
Sets a new value for property
showTitleInHeaderContent
.
Determines whether the title, image, markers and selectTitleArrow are shown in the Header content area.
When called with a value of null
or undefined
, the default value of the property will be restored.
Default value is false
.
Parameters:
{boolean} | bShowTitleInHeaderContent | New value for property showTitleInHeaderContent |
Returns:
Sets a new value for property
subSectionLayout
.
Determines whether Subsection titles are displayed on top or to the left of the Subsection content.
When called with a value of null
or undefined
, the default value of the property will be restored.
Default value is TitleOnTop
.
Parameters:
Returns:
Sets a new value for property
upperCaseAnchorBar
.
Determines whether the Anchor bar items are displayed in upper case.
When called with a value of null
or undefined
, the default value of the property will be restored.
Default value is true
.
Parameters:
{boolean} | bUpperCaseAnchorBar | New value for property upperCaseAnchorBar |
Returns:
Sets a new value for property
useTwoColumnsForLargeScreen
.
Determines whether the to use two column layout for the L screen size.
When called with a value of null
or undefined
, the default value of the property will be restored.
Default value is false
.
Parameters:
{boolean} | bUseTwoColumnsForLargeScreen | New value for property useTwoColumnsForLargeScreen |
Returns: