navpopover/SmartLink The SmartLink control uses a semantic object to display {@link sap.ui.comp.navpopover.NavigationPopover NavigationPopover} for further navigation steps.<br> <b>Note:</b> Navigation targets are determined using {@link sap.ushell.services.CrossApplicationNavigation CrossApplicationNavigation} of the unified shell service. sap.m/Link Name of semantic object which is used to fill the navigation popover. <b>Note</b>: Setting a value triggers an asynchronous determination, so the effect can be delayed. Semantic object names which can be used additional to the default <code>semanticObject</code> property in order to get navigation targets links. The semantic object controller controls events for several SmartLink controls. If the controller is not set manually, it tries to find a SemanticObjectController in its parent hierarchy. The metadata field name for this SmartLink control. Shown label of semantic object. Title section with <code>semanticObjectLabel</code> has been removed due to new UI design Function that enables the SmartLink control to create an alternative control, which is displayed if no navigation targets are available. The function has no parameters and has to return an instance of sap.ui.core.Control. If set to <code>false</code>, the SmartLink 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 SmartLink controls 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. If set to <code>true</code>, the SmartLink control will render the <code>innerControl</code> or the control provided by <code>createControlCallback</code> instead of the actual link. This is used for example by the SemanticObjectController if this SmartLink is listed in its <code>ignoredFields</code> or no navigation targets were found during prefetch. Determines whether the personalization link is shown inside the NavigationPopover control. If set to true, the <code>SmartLink</code> control is rendered as a link even if <code>contactAnnotationPath</code> is not set and navigation targets do not exist. Setting this property to <code>true</code> allows the application, for example, to modify the <code>SmartLink</code> control in the event handler, after the user has clicked on a link and the registered event handler has been called. <b>Note:</b> The <code>ignoreLinkRendering</code> property and the <code>ignoredFields</code> property of the associated <code>SemanticObjectController</code> take precedence over <code>forceLinkRendering</code>. Additionally to the <code>text</code> property the Unit of Measure can be displayed. 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 SmartLink control, 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 SmartLink control. 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 SmartLink control. 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 SmartLink control. Control that is displayed instead of SmartLink control, if the SmartLink is disabled (for example, if no navigation targets are available). If <code>innerControl</code> is not provided, the SmartLink control tries to create one with property <code>createControlCallback</code>.