Class sap.ushell.renderers.fiori2.RendererModule: sap/ushell/renderers/fiori2/Renderer

extends UIComponent

The SAPUI5 component of SAP Fiori Launchpad renderer for the Unified Shell.


Since: 1.15.0.
Constructor Summary
new sap.ushell.renderers.fiori2.Renderer()This method MUST be called by the Unified Shell's container only, others MUST call sap.ushell.Container.createRenderer("fiori2").
Field Summary
LaunchpadStateThe launchpad states that can be passed as a parameter.
Method Summary
sap.ushell.renderers.fiori2.Renderer.extend(sClassName, oClassInfo?, FNMetaImpl?)Creates a new subclass of class sap.ushell.renderers.fiori2.Renderer with name sClassName and enriches it with the information contained in oClassInfo.
sap.ushell.renderers.fiori2.Renderer.getMetadata()Returns a metadata object for class sap.ushell.renderers.fiori2.Renderer.
addActionButton(controlType, oControlProperties, bIsVisible, bCurrentState, aStates)Creates an Action Button in Fiori launchpad, in the given launchpad states.
addEndUserFeedbackCustomUI(oCustomUIContent, bShowCustomUIContent)Adds the given sap.ui.core.Control to the EndUserFeedback dialog.
addFloatingActionButton(controlType, oControlProperties, bIsVisible, bCurrentState, aStates)Creates a FloatingActionButton in Fiori launchpad, in the given launchpad states.
addHeaderEndItem(controlType, oControlProperties, bIsVisible, bCurrentState, aStates)Creates and displays one or more HeaderItem controls in Fiori launchpad, in the given launchpad states.
addHeaderItem(controlType, oControlProperties, bIsVisible, bCurrentState, aStates)Creates and displays an item in the header of Fiori launchpad, in the given launchpad states.
addLeftPaneContent(controlType, oControlProperties, bIsVisible, bCurrentState, aStates)Creates the Left Pane content in Fiori launchpad, in the given launchpad states.
addSubHeader(controlType, oControlProperties, bIsVisible, bCurrentState, aStates)Creates and displays a sub header control in Fiori launchpad, in the given launchpad states.
addToolAreaItem(oControlProperties, bIsVisible, bCurrentState, aStates)Creates a ToolAreaItem in Fiori Launchpad and adds it to the Tool Area, in the given launchpad states.
addUserPreferencesEntry(entryObject)Adds an entry to the User Preferences dialog box including the UI control that appears when the user clicks the new entry,
and handling of User Preferences actions such as SAVE and CANCEL.
getCurrentViewportState()This method returns the current state of the Viewport Container control.
hideActionButton(aIds, bCurrentState, aStates)Hide the given Action Button from Fiori Launchpad, in the given launchpad states.
hideFloatingActionButton(aIds, bCurrentState, aStates)Hide the given sap.ushell.ui.shell.ShellFloatingAction from Fiori Launchpad, in the given launchpad states.
hideHeaderEndItem(aIds, bCurrentState, aStates)Hide the given sap.ushell.ui.shell.ShellHeadItem from Fiori Launchpad, in the given launchpad states.
hideHeaderItem(aIds, bCurrentState, aStates)Hide the given sap.ushell.ui.shell.ShellHeadItem from Fiori Launchpad, in the given launchpad states.
hideLeftPaneContent(aIds, bCurrentState, aStates)Hide the given control from Fiori Launchpad, in the given launchpad states.
hideSubHeader(aIds, bCurrentState, aStates)Hide the given control from the Fiori Launchpad sub header, in the given launchpad states.
removeFooter()If exists, this method will remove the footer from the Fiori Launchpad.
removeToolAreaItem(aIds, bCurrentState, aStates)Remove the given Tool Area Item from Fiori Launchpad, in the given launchpad states.
setFooter(oFooter)Displays the given sap.m.Bar as the footer of the Fiori launchpad shell.
setHeaderTitle(sTitle)Sets the title in the Fiori Launchpad shell header.
setHeaderVisibility(bVisible, bCurrentState, aStates)Sets the header visibility accrding to the given value and shell states.
setLeftPaneVisibility(sLaunchpadState, bVisible)Sets the visibility of the left pane in the Fiori Launchpad shell, in the given launchpad state
showActionButton(aIds, bCurrentState, aStates, bIsFirst)Displays Buttons on the user actions menu in the Fiori launchpad shell, in the given launchpad states (see sap.ushell.renderers.fiori2.renderer.LaunchpadState).
showFloatingActionButton(aIds, bCurrentState, aStates)Displays FloatingActionButton on the bottom right corner of the Fiori launchpad, in the given launchpad states.
showHeaderEndItem(aIds, bCurrentState, aStates)Displays HeaderItems on the right side of the Fiori launchpad shell header, in the given launchpad states (see sap.ushell.renderers.fiori2.renderer.LaunchpadState).
showHeaderItem(aIds, bCurrentState, aStates)Creates and displays one or more HeaderItem controls according to the given control IDs and Shell states
(see sap.ushell.renderers.fiori2.renderer.LaunchpadState).
showSubHeader(aIds, bCurrentState, aStates)Displays one or more sub header controls according to the given control IDs and shell states.
showToolArea(sLaunchpadState?, bVisible?)Sets the ToolArea visibility
showToolAreaItem(sId, bCurrentState, aStates+)Displays ToolAreaItem on the left side of the Fiori launchpad shell, in the given launchpad states (see sap.ushell.renderers.fiori2.renderer.LaunchpadState).
Constructor Detail
new sap.ushell.renderers.fiori2.Renderer()
This method MUST be called by the Unified Shell's container only, others MUST call sap.ushell.Container.createRenderer("fiori2").
Field Detail
LaunchpadState
The launchpad states that can be passed as a parameter.
Values: App - launchpad state when running a Fiori app
Home - launchpad state when the home page is open
Since:
1.30
Method Detail
sap.ushell.renderers.fiori2.Renderer.extend(sClassName, oClassInfo?, FNMetaImpl?): function
Creates a new subclass of class sap.ushell.renderers.fiori2.Renderer 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.UIComponent.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
sap.ushell.renderers.fiori2.Renderer.getMetadata(): sap.ui.base.Metadata
Returns a metadata object for class sap.ushell.renderers.fiori2.Renderer.
Returns:
{sap.ui.base.Metadata} Metadata object describing this class
addActionButton(controlType, oControlProperties, bIsVisible, bCurrentState, aStates): object
Creates an Action Button in Fiori launchpad, in the given launchpad states.
The button will be displayed in the user actions menu, that is opened from the user button in the shell header.
Example:
 sap.ushell.Container.getRenderer("fiori2").addActionButton("sap.m.Button", {id: "testBtn2", text: "test button"}, true, true);
Parameters:
{string}controlType The (class) name of the control type to create.
{object}oControlProperties The properties that will be passed to the created control.
{boolean}bIsVisible Specify whether to display the control
{boolean}bCurrentState If true, add the current control only to the current rendered shell state. Once the user navigates to another app or back to the Home page, this control will be removed.
{String[]}aStates (only valid if bCurrentState is set to false) - list of the sap.ushell.renderers.fiori2.Renderer.LaunchpadState in which to add the control.
Since:
1.30
Returns:
{object} oItem - the created control
See:
LaunchpadState. If no launchpad state is provided the content is added in all states.
addEndUserFeedbackCustomUI(oCustomUIContent, bShowCustomUIContent)
Adds the given sap.ui.core.Control to the EndUserFeedback dialog.
The EndUserFeedback dialog is opened via the user actions menu in the Fiori Launchpad shell header.
Parameters:
{object}oCustomUIContent The control to be added to the EndUserFeedback dialog.
{boolean}bShowCustomUIContent Specify whether to display the control.
Since:
1.30
addFloatingActionButton(controlType, oControlProperties, bIsVisible, bCurrentState, aStates): object
Creates a FloatingActionButton in Fiori launchpad, in the given launchpad states.
The FloatingActionButton is rendered in the bottom right corner of the shell.
Example:
 sap.ushell.Container.getRenderer("fiori2").addFloatingActionButton("sap.ushell.ui.shell.ShellFloatingAction", {id: "testBtn"}, true, true);
Parameters:
{string}controlType The (class) name of the control type to create.
{object}oControlProperties The properties that will be passed to the created control.
{boolean}bIsVisible Specify whether to display the control.
{boolean}bCurrentState If true, add the current control only to the current rendered shell state. Once the user navigates to another app or back to the Home page, this control will be removed.
{String[]}aStates (only valid if bCurrentState is set to false) - list of the sap.ushell.renderers.fiori2.Renderer.LaunchpadState in which to add the control.
Since:
1.30
Returns:
{object} oItem - the created control
See:
LaunchpadState. If no launchpad state is provided the content is added in all states.
addHeaderEndItem(controlType, oControlProperties, bIsVisible, bCurrentState, aStates): object
Creates and displays one or more HeaderItem controls in Fiori launchpad, in the given launchpad states.
The HeaderItem will be displayed in the right side of the Fiori Launchpad shell header.
Example:
 sap.ushell.Container.getRenderer("fiori2").addHeaderEndItem("sap.ushell.ui.shell.ShellHeadItem", {id: "testBtn"}, true, true);
Parameters:
{string}controlType The (class) name of the control type to create. Currently only "sap.ushell.ui.shell.ShellHeadItem" control type is supported.
{object}oControlProperties The properties that will be passed to the created control.
{boolean}bIsVisible Specify whether to display the control.
{boolean}bCurrentState If true, add the current control only to the current rendered shell state. Once the user navigates to another app or back to the Home page, this control will be removed.
{String[]}aStates (only valid if bCurrentState is set to false) - list of the sap.ushell.renderers.fiori2.Renderer.LaunchpadState in which to add the control.
Since:
1.30
Returns:
{object} oItem - the created control
See:
LaunchpadState. If no launchpad state is provided the content is added in all states.
addHeaderItem(controlType, oControlProperties, bIsVisible, bCurrentState, aStates): object
Creates and displays an item in the header of Fiori launchpad, in the given launchpad states.
The new header item will be displayed on the left-hand side of the Fiori Launchpad shell header, according to the given display parameters.
The new header item will be added to the right of any existing header items. The header can contain a maximum of three header items.

Example:
var oRenderer = sap.ushell.Container.getRenderer("fiori2");
oRenderer.addHeaderItem("sap.ushell.ui.shell.ShellHeadItem", {id: "testBtn"}, true, true);
Parameters:
{string}controlType The (class) name of the control type to create. For example: "sap.m.Button"
{object}oControlProperties The properties that will be passed to the created control. For example: {id: "testButton"}
{boolean}bIsVisible Specifies whether the header item control is displayed after being created.
If true then the control is displayed according to parameters bCurrentState and aStates.
If false then the control is created but not displayed.
{boolean}bCurrentState If true then the new created control is added to the current rendered shell state.
When the user navigates to a different state including a different application then the control will be removed.
If false then add the control to the LaunchPadState itself.
{String[]}aStates (Valid only if bCurrentState is false)
A list of shell states (i.e. sap.ushell.renderers.fiori2.Renderer.LaunchpadState) in which the control is added.
If no launchpad state is provided the control is added in all states.
Since:
1.30
Returns:
{object} The created control
See:
LaunchpadState.
addLeftPaneContent(controlType, oControlProperties, bIsVisible, bCurrentState, aStates): object
Creates the Left Pane content in Fiori launchpad, in the given launchpad states.
Example:
 sap.ushell.Container.getRenderer("fiori2").addLeftPaneContent("sap.m.Button", {id: "testBtn", text: "Test Button"}, true, true);
Parameters:
{string}controlType The (class) name of the control type to create.
{object}oControlProperties The properties that will be passed to the created control.
{boolean}bIsVisible Specify whether to display the control.
{boolean}bCurrentState If true, add the current control only to the current rendered shell state. Once the user navigates to another app or back to the Home page, this control will be removed.
{String[]}aStates (only valid if bCurrentState is set to false) - list of the sap.ushell.renderers.fiori2.Renderer.LaunchpadState in which to add the control.
Since:
1.30
Returns:
{object} oItem - the created control
See:
LaunchpadState. If no launchpad state is provided the content is added in all states.
addSubHeader(controlType, oControlProperties, bIsVisible, bCurrentState, aStates): object
Creates and displays a sub header control in Fiori launchpad, in the given launchpad states.
The new control is displayed in FLP UI according to the given display parameters.
If a sub header already exists, the new created one will replace the existing one.

Example:
var oRenderer = sap.ushell.Container.getRenderer("fiori2");
oRenderer.addSubHeader("sap.m.Bar", {id: "testBar", contentLeft: [new sap.m.Button({text: "Test SubHeader Button",
     press: function () {
     sap.m.MessageToast.show("Pressed");
     }
 })
]}, true, true);
Parameters:
{string}controlType The (class) name of the control type to create.
For example: "sap.m.Bar"
{object}oControlProperties The properties that will be passed to the created control.
For example: {id: "testBar"}
{boolean}bIsVisible Specifies whether the sub header control is displayed after being created.
If true then the control is displayed according to parameters bCurrentState and aStates,
if false then the control is created but not displayed.
{boolean}bCurrentState If true then the new created control is added to the current rendered shell state.
When the user navigates to another application (including the Home page) then the control will be removed.
If false then add the control to the LaunchPadState itself.
{String[]}aStates (Valid only if bCurrentState is false)
A list of shell states (i.e. sap.ushell.renderers.fiori2.Renderer.LaunchpadState) in which the control is added.
If no launchpad state is provided the control is added in all states.
Since:
1.30
Returns:
{object} The created control
See:
LaunchpadState.
addToolAreaItem(oControlProperties, bIsVisible, bCurrentState, aStates): object
Creates a ToolAreaItem in Fiori Launchpad and adds it to the Tool Area, in the given launchpad states.
If no items are added to the Tool Area, it will not be displayed.
Once an item is added, the Tool Area is rendered on the left side on the Fiori Launchpad shell.

Example:

sap.ushell.Container.getRenderer("fiori2").addToolAreaItem({
             id: "testButton",
             icon: "sap-icon://documents",
             expandable: true,
             press: function (evt) {
                window.alert("Press" );
               },
            expand: function (evt) {
                // This function will be called on the press event of the "expand" button. The result of "expand" event in the UI must be determined by the developer
                window.alert("Expand" );
               }
          }, true, false, ["home"]);
Parameters:
{object}oControlProperties The properties object that will be passed to the constructor of sap.ushell.ui.shell.ToolAreaItem control.
{boolean}bIsVisible Specify whether to display the control.
{boolean}bCurrentState If true, add the current control only to the current rendered shell state.
{String[]}aStates List of the sap.ushell.renderers.fiori2.Renderer.LaunchpadState in which to add the control.Only valid if bCurrentState is set to false.
Since:
1.30
Returns:
{object} oItem - the created control
See:
sap.ushell.ui.shell.ToolAreaItem
LaunchpadState.

If no launchpad state is provided the content is added in all states.

addUserPreferencesEntry(entryObject)
Adds an entry to the User Preferences dialog box including the UI control that appears when the user clicks the new entry,
and handling of User Preferences actions such as SAVE and CANCEL.

Example:

var oRenderer = sap.ushell.Container.getRenderer("fiori2");
var oEntry = {
  title: "title",
  value: function() {
      return jQuery.Deferred().resolve("entryTitleToBeDisplayed");
  },
  content: function() {
      return jQuery.Deferred().resolve(new sap.m.Button("userPrefEntryButton", {text: "Button"}));
  },
  onSave: function() {
      return jQuery.Deferred().resolve();
  }
  };
oRenderer.addUserPreferencesEntry(oEntry);   
Parameters:
{object}entryObject The data of the new added User Preference entry
Including:
  • {String} entryHelpID (Optional) - The ID of the object.
  • {String} title - The title of the entry to be presented in the list in the User Preferences dialog box.
    We recommend using a string from the translation bundle.
  • {String}/{Function} value - A string to be presented as the value of the entry
    OR a function to be called which returns a {jQuery.Deferred.promise} object.
  • {Function} content - A function to be called that returns a {jQuery.Deferred.promise} object
    which consists of a {sap.ui.core.Control} to be displayed in a follow-on dialog box. A SAPUI5 view instance can also be returned. The functions is called on each time the user opens the User Preferences dialog box.
  • {Function} onSave - A function to be called which returns a {jQuery.Deferred.promise} object when the user clicks Save in the User Preferences dialog box.
    If an error occurs, pass the error message via the {jQuery.Deferred.promise} object. Errors are displayed in the log.
  • {Function} onCancel - A function to be called that closes the User Preferences dialog box without saving any changes.
Since:
1.30
getCurrentViewportState()
This method returns the current state of the Viewport Container control.
Since:
1.37
hideActionButton(aIds, bCurrentState, aStates)
Hide the given Action Button from Fiori Launchpad, in the given launchpad states. The removed button will not be destroyed.

This API is meant to be used for implementing custom elements in the SAP Fiori launchpad. We do not recommend using it on a standard launchpad element, as this may interfere with the standard launchpad functionality.
Parameters:
{String[]}aIds the Ids of the Action Button to remove.
{boolean}bCurrentState if true, remove the current control only from the current rendered shell state.
{String[]}aStates list of the sap.ushell.renderers.fiori2.Renderer.LaunchpadState in which to remove the control.(Only valid if bCurrentState is set to false)
Since:
1.30
See:
LaunchpadState.

If no launchpad state is provided the content is removed in all states.

hideFloatingActionButton(aIds, bCurrentState, aStates)
Hide the given sap.ushell.ui.shell.ShellFloatingAction from Fiori Launchpad, in the given launchpad states. The removed control will not be destroyed.

This API is meant to be used for implementing custom elements in the SAP Fiori launchpad. We do not recommend using it on a standard launchpad element, as this may interfere with the standard launchpad functionality.
Parameters:
{String[]}aIds the Ids of the sap.ushell.ui.shell.ShellFloatingAction to remove.
{boolean}bCurrentState if true, remove the current control only from the current rendered shell state.
{String[]}aStates list of the sap.ushell.renderers.fiori2.Renderer.LaunchpadState in which to remove the control.(Only valid if bCurrentState is set to false)
Since:
1.30
See:
LaunchpadState.

If no launchpad state is provided the content is removed in all states.

hideHeaderEndItem(aIds, bCurrentState, aStates)
Hide the given sap.ushell.ui.shell.ShellHeadItem from Fiori Launchpad, in the given launchpad states. The removed control will not be destroyed.

This API is meant to be used for implementing custom elements in the SAP Fiori launchpad. We do not recommend using it on a standard launchpad element, as this may interfere with the standard launchpad functionality.
Parameters:
{String[]}aIds the Ids of the sap.ushell.ui.shell.ShellHeadItem to remove.
{boolean}bCurrentState if true, remove the current control only from the current rendered shell state.
{String[]}aStates list of the sap.ushell.renderers.fiori2.Renderer.LaunchpadState in which to remove the control.(Only valid if bCurrentState is set to false)
Since:
1.30
See:
LaunchpadState.

If no launchpad state is provided the content is removed in all states.

hideHeaderItem(aIds, bCurrentState, aStates)
Hide the given sap.ushell.ui.shell.ShellHeadItem from Fiori Launchpad, in the given launchpad states. The removed control will not be destroyed.

This API is meant to be used for implementing custom elements in the SAP Fiori launchpad. We do not recommend using it on a standard launchpad element, as this may interfere with the standard launchpad functionality.
Parameters:
{String[]}aIds the Ids of the sap.ushell.ui.shell.ShellHeadItem to remove.
{boolean}bCurrentState if true, remove the current control only from the current rendered shell state.
{String[]}aStates list of the sap.ushell.renderers.fiori2.Renderer.LaunchpadState in which to remove the control.(Only valid if bCurrentState is set to false)
Since:
1.30
See:
LaunchpadState.

If no launchpad state is provided the content is removed in all states.

hideLeftPaneContent(aIds, bCurrentState, aStates)
Hide the given control from Fiori Launchpad, in the given launchpad states. The removed control will not be destroyed.

This API is meant to be used for implementing custom elements in the SAP Fiori launchpad. We do not recommend using it on a standard launchpad element, as this may interfere with the standard launchpad functionality.
Parameters:
{String[]}aIds the Ids of the controls to remove.
{boolean}bCurrentState if true, remove the current control only from the current rendered shell state.
{String[]}aStates list of the sap.ushell.renderers.fiori2.Renderer.LaunchpadState in which to remove the control.(Only valid if bCurrentState is set to false)
Since:
1.30
See:
LaunchpadState.

If no launchpad state is provided the content is removed in all states.

hideSubHeader(aIds, bCurrentState, aStates)
Hide the given control from the Fiori Launchpad sub header, in the given launchpad states. The removed control will not be destroyed.

This API is meant to be used for implementing custom elements in the SAP Fiori launchpad. We do not recommend using it on a standard launchpad element, as this may interfere with the standard launchpad functionality.
Parameters:
{String[]}aIds the Ids of the controls to remove.
{boolean}bCurrentState if true, remove the current control only from the current rendered shell state.
{String[]}aStates list of the sap.ushell.renderers.fiori2.Renderer.LaunchpadState in which to remove the control.(Only valid if bCurrentState is set to false)
Since:
1.30
See:
LaunchpadState.

If no launchpad state is provided the content is removed in all states.

removeFooter()
If exists, this method will remove the footer from the Fiori Launchpad.

This API is meant to be used for implementing custom elements in the SAP Fiori launchpad. We do not recommend using it on a standard launchpad element, as this may interfere with the standard launchpad functionality.
Since:
1.30
removeToolAreaItem(aIds, bCurrentState, aStates)
Remove the given Tool Area Item from Fiori Launchpad, in the given launchpad states.

This API is meant to be used for implementing custom elements in the SAP Fiori launchpad. We do not recommend using it on a standard launchpad element, as this may interfere with the standard launchpad functionality.
Parameters:
{String[]}aIds the Ids of the sap.ushell.ui.shell.ToolAreaItem control to remove.
{boolean}bCurrentState if true, remove the current control only from the current rendered shell state.
{String[]}aStates list of the sap.ushell.renderers.fiori2.Renderer.LaunchpadState in which to remove the control.(Only valid if bCurrentState is set to false)
Since:
1.30
See:
LaunchpadState.

If no launchpad state is provided the content is removed in all states.

setFooter(oFooter)
Displays the given sap.m.Bar as the footer of the Fiori launchpad shell.
The footer will be displayed in all states.

Example:

 var bar = new sap.m.Bar({contentLeft: [new sap.m.Button({text: "Test Footer Button",
press: function () {
sap.m.MessageToast.show("Pressed");
}})
]});
 var renderer = sap.ushell.Container.getRenderer("fiori2");
 renderer.setFooter(bar);
Parameters:
{Object}oFooter sap.m.Bar the control to be added as the footer of the Fiori Launchpad
Since:
1.30
setHeaderTitle(sTitle)
Sets the title in the Fiori Launchpad shell header.
Parameters:
{string}sTitle The title to be displayed in the Fiori Launchpad shell header
Since:
1.30
setHeaderVisibility(bVisible, bCurrentState, aStates)
Sets the header visibility accrding to the given value and shell states.
(see sap.ushell.renderers.fiori2.renderer.LaunchpadState).

Example:

var oRenderer = sap.ushell.Container.getRenderer("fiori2");
oRenderer.setHeaderVisibility(false, false, ["home", "app"]);
Parameters:
{boolean}bVisible The visibility of the header
{boolean}bCurrentState If true then the visibility is set only to the current rendered shell state.
When the user navigates to another application (including the Home page) then the visibility flag is reset.
If false then set the visibility according to the states provided in the aState parameter.
{String[]}aStates (Valid only if bCurrentState is false)
A list of shell states (i.e. sap.ushell.renderers.fiori2.Renderer.LaunchpadState) in which the header visibility flag should be set.
If no launchpad state is provided the visibility flag is set for all states.
Since:
1.38
See:
LaunchpadState.
setLeftPaneVisibility(sLaunchpadState, bVisible)
Sets the visibility of the left pane in the Fiori Launchpad shell, in the given launchpad state
Parameters:
{string}sLaunchpadState LaunchpadState in which to show/hide the left pane
{boolean}bVisible specif whether to display the left pane or not
Since:
1.30
See:
LaunchpadState.
showActionButton(aIds, bCurrentState, aStates, bIsFirst)
Displays Buttons on the user actions menu in the Fiori launchpad shell, in the given launchpad states (see sap.ushell.renderers.fiori2.renderer.LaunchpadState).
If no launchpad state is provided the content is displayed in all states.
The user actions menu is opened via the button on the right hand side of the shell header.

Example:

  var button1 = new sap.m.Button();
  var renderer = sap.ushell.Container.getRenderer("fiori2");
  renderer.showActionButton([button1.getId()], false, ["home", "app"]);
  
Parameters:
{String[]}aIds List of ID elements to add to the user actions menu.
{boolean}bCurrentState if true, add the current Buttons only to the current instance of the rendering of the shell. if false, add the Buttons to the LaunchPadState itself.
{String[]}aStates (only valid if bCurrentState is set to false) - list of the sap.ushell.renderers.fiori2.renderer.LaunchpadState in which to add the aIds.
{boolean}bIsFirst if true, the Button will be added to the top of the ActionItems list.
Since:
1.30
showFloatingActionButton(aIds, bCurrentState, aStates)
Displays FloatingActionButton on the bottom right corner of the Fiori launchpad, in the given launchpad states. The FloatingActionButton is rendered in the bottom right corner of the shell.
(see sap.ushell.renderers.fiori2.renderer.LaunchpadState).
If no launchpad state is provided the content is displayed in all states.

Example:

  var button1 = new sap.ushell.ui.shell.ShellFloatingAction();
  var renderer = sap.ushell.Container.getRenderer("fiori2");
  renderer.showFloatingActionButton([button1.getId()], true);
  
Parameters:
{String[]}aIds List of ID elements to add to the user actions menu.
{boolean}bCurrentState if true, add the current Buttons only to the current instance of the rendering of the shell. if false, add the Buttons to the LaunchPadState itself.
{String[]}aStates (only valid if bCurrentState is set to false) - list of the sap.ushell.renderers.fiori2.renderer.LaunchpadState in which to add the aIds.
Since:
1.30
showHeaderEndItem(aIds, bCurrentState, aStates)
Displays HeaderItems on the right side of the Fiori launchpad shell header, in the given launchpad states (see sap.ushell.renderers.fiori2.renderer.LaunchpadState).
If no launchpad state is provided the content is displayed in all states.
The shell header can display the user HeaderItem, and just one more HeaderItem.
If this method is called when the right side of the header is full, this method will not do anything.

Example:

  var button1 = new sap.ushell.ui.shell.ShellHeadItem();
  var renderer = sap.ushell.Container.getRenderer("fiori2");
  renderer.showHeaderEndItem ([button1.getId()], false, ["home", "app"]);
  
Parameters:
{String[]}aIds List of ID elements to add to the shell header.
{boolean}bCurrentState if true, add the current HeaderItems only to the current instance of the rendering of the shell. if false, add the HeaderItems to the LaunchPadState itself.
{String[]}aStates (only valid if bCurrentState is set to false) - list of the sap.ushell.renderers.fiori2.renderer.LaunchpadState in which to add the aIds.
Since:
1.30
showHeaderItem(aIds, bCurrentState, aStates)
Creates and displays one or more HeaderItem controls according to the given control IDs and Shell states
(see sap.ushell.renderers.fiori2.renderer.LaunchpadState).

The HeaderItem controls will be displayed on the left side of the Fiori Launchpad shell header according to the given display parameters.
There can be up to three header items. If the number of existing header items plus the given ones exceeds 3, then the operation fails and no new header items are created.

Example:

var button1 = new sap.ushell.ui.shell.ShellHeadItem();
var button2 = new sap.ushell.ui.shell.ShellHeadItem();
var renderer = sap.ushell.Container.getRenderer("fiori2");
renderer.showHeaderItem ([button1.getId(), button2.getId()], false, ["home", "app"]);
Parameters:
{String[]}aIds IDs Array of headerItem controls that should be added to the shell header
{boolean}bCurrentState If true then the new created controls are added to the current rendered shell state.
When the user navigates to another application (including the Home page) then the controls will be removed.
If false then the controls are added to the LaunchPadState itself.
{String[]}aStates (Valid only if bCurrentState is false)
A list of shell states (i.e. sap.ushell.renderers.fiori2.Renderer.LaunchpadState) in which the controls are added.
If no launchpad state is provided the controls are added in all states.
Since:
1.30
See:
LaunchpadState.
showSubHeader(aIds, bCurrentState, aStates)
Displays one or more sub header controls according to the given control IDs and shell states.
(see sap.ushell.renderers.fiori2.renderer.LaunchpadState).

A sub header is placed in a container, located directly below the main Fiori launchpad shell header.

Example:

var bar = new sap.m.Bar({id: "testBar", contentLeft: [new sap.m.Button({text: "Test SubHeader Button",
press: function () {
sap.m.MessageToast.show("Pressed");
}})
]});
var oRenderer = sap.ushell.Container.getRenderer("fiori2");
oRenderer.showSubHeader([bar.getId()], false, ["home", "app"]);
Parameters:
{String[]}aIds Array of sub header control IDs to be added
{boolean}bCurrentState If true then the new created controls are added only to the current rendered shell state.
When the user navigates to another application (including the Home page) then the controls will be removed.
If false then add the control to the LaunchPadState itself.
{String[]}aStates (Valid only if bCurrentState is false)
A list of shell states (i.e. sap.ushell.renderers.fiori2.Renderer.LaunchpadState) in which the controls are added.
If no launchpad state is provided the controls are added in all states.
Since:
1.30
See:
LaunchpadState.
showToolArea(sLaunchpadState?, bVisible?)
Sets the ToolArea visibility
Parameters:
{String}sLaunchpadState? LaunchpadState in which to show/hide the ToolArea
{boolean}bVisible? specifies whether to display the ToolArea or not
See:
LaunchpadState
showToolAreaItem(sId, bCurrentState, aStates+)
Displays ToolAreaItem on the left side of the Fiori launchpad shell, in the given launchpad states (see sap.ushell.renderers.fiori2.renderer.LaunchpadState).
If no launchpad state is provided the content is displayed in all states.

Example:

  var button1 = new sap.ushell.ui.shell.ToolAreaItem();
  var renderer = sap.ushell.Container.getRenderer("fiori2");
  renderer.showToolAreaItem(button1.getId(), false, ["home", "app"]);
  
Parameters:
{string}sId ID of the element to add to the Tool Area.
{boolean}bCurrentState if true, add the current ToolAreaItems only to the current instance of the rendering of the shell. if false, add the ToolAreaItems to the LaunchPadState itself.
{String[]}aStates+ (only valid if bCurrentState is set to false) - list of the sap.ushell.renderers.fiori2.renderer.LaunchpadState in which to add the aIds.
Since:
1.30