navpopover/NavigationPopoverHandler The NavigationPopoverHandler control determines navigation targets for a semantic object and shows them together with further information in a Popover.<br> <b>Note:</b> Navigation targets are determined using {@link sap.ushell.services.CrossApplicationNavigation CrossApplicationNavigation} of the unified shell service. Name of semantic object which is used to determine target navigations. Names of additional semantic objects which are used to determine target navigations. The semantic object controller controls events for several NavigationPopoverHandler controls. If the controller is not set manually, it tries to find a SemanticObjectController in its parent hierarchy. The metadata field name for this NavigationPopoverHandler control. Shown title of semantic object. Title section with <code>semanticObjectLabel</code> has been removed due to new UI design If set to <code>false</code>, the NavigationPopoverHandler control will not replace its field name with the according <code>semanticObject</code> property during the calculation of the semantic attributes. This enables the usage of several NavigationPopoverHandler on the same semantic object. * Navigation property that points from the current to the related entity type where the com.sap.vocabularies.Communication.v1.Contact annotation is defined, for example, <code>'to_Supplier'</code>. An empty string means that the related entity type is the current one. Determines whether the personalization link is shown inside the NavigationPopover control. Event is fired before the navigation popover opens and before navigation target links are getting retrieved. Event can be used to change the parameters used to retrieve the navigation targets. In case of NavigationPopoverHandler, the <code>beforePopoverOpens</code> is fired after the link has been clicked. The semantic object for which the navigation targets will be retrieved. Map containing the semantic attributes calculated from the binding that will be used to retrieve the navigation targets. The parameter <code>semanticAttributes</code> is obsolete. Instead use the parameter <code>semanticAttributesOfSemanticObjects</code>. A map of semantic objects for which the navigation targets will be retrieved and it's semantic attributes calculated from the binding context. The semantic attributes will be used as parameters in order to retrieve the navigation targets. This callback function enables you to define a changed semantic attributes map. Signatures: <code>setSemanticAttributes(oSemanticAttributesMap)</code> Parameter: <ul> <li>{object} oSemanticAttributesMap New map containing the semantic attributes</li> <li>{string} sSemanticObject Semantic Object for which the oSemanticAttributesMap belongs</li> </ul> This callback function sets an application state key that is used over the cross-application navigation. Signatures: <code>setAppStateKey(sAppStateKey)</code> Parameter: <ul> <li>{string} sAppStateKey</li> </ul> The ID of the NavigationPopoverHandler. This callback function triggers the retrieval of navigation targets and leads to the opening of the navigation popover. Signatures: <code>open()</code> If the <code>beforePopoverOpens</code> has been registered, the <code>open</code> function has to be called manually in order to open the navigation popover. After the navigation targets are retrieved, <code>navigationTargetsObtained</code> is fired and provides the possibility to change the targets. The main navigation object. Array of available navigation target objects. The navigation object for the own application. This navigation option is by default not visible on the popover. Array containing contact data. The semantic object for which the navigation targets have been retrieved. Map containing the semantic attributes. The ID of the NavigationPopoverHandler. This callback function shows the actual navigation popover. If the <code>navigationTargetsObtained</code> has been registered, the <code>show</code> function has to be called manually in order to open the navigation popover. Signatures: <code>show()</code> <ul> <li><code>show(oMainNavigation, aAvailableActions, oAdditionalContent)</code> Parameters: <ul> <li>{sap.ui.comp.navpopover.LinkData | null | undefined} oMainNavigation The main navigation object. With <code>null</code> the main navigation object will be removed. With <code>undefined</code> the old object will remain.</li> <li>{sap.ui.comp.navpopover.LinkData[] | [] | undefined} aAvailableActions Array containing the cross application navigation links. With empty array all available links will be removed. With <code>undefined</code> the old links will remain.</li> <li>{sap.ui.core.Control | null | undefined} oAdditionalContent Control that will be displayed in extra content section on the popover. With <code>null</code> the main extra content object will be removed. With <code>undefined</code> the old object still remains.</li> </ul> </li> <li><code>show(sMainNavigationId, oMainNavigation, aAvailableActions, oAdditionalContent)</code> Parameters: <ul> <li>{string | undefined} sMainNavigationId The visible description for the main navigation link. With <code>''</code>, both the description and subtitle will be removed. With <code>undefined</code>, the description is calculated using the binding context of a given source object (for example <code>SmartLink</code> control).</li> <li>{sap.ui.comp.navpopover.LinkData | null | undefined} oMainNavigation The main navigation object. With <code>null</code> the main navigation object will be removed. With <code>undefined</code> the old object will remain.</li> <li>{sap.ui.comp.navpopover.LinkData[] | [] | undefined} aAvailableActions Array containing the cross application navigation links. With empty array all available links will be removed. With <code>undefined</code> the old links will remain.</li> <li>{sap.ui.core.Control | null | undefined} oAdditionalContent Control that will be displayed in extra content section on the popover. With <code>null</code> the main extra content object will be removed. With <code>undefined</code> the old object still remains.</li> </ul> </li> </ul> This event is fired after a navigation link on the navigation popover has been clicked. This event is only fired, if the user left-clicks the link. Right-clicking the link and selecting 'Open in New Window' etc. in the context menu does not fire the event. The UI text shown in the clicked link. The navigation target of the clicked link. The semantic object used to retrieve this target. Map containing the semantic attributes used to retrieve this target. The ID of the NavigationPopoverHandler. The parent control.