SAP Fiori Elements里Smart Link工作原理介绍

The hyperlink could easily be defined by Smart field with the help of corresponding annotation declared in OData Model metadata.

The hyperlink in this example looks like below in UI:


SAP Fiori Elements里Smart Link工作原理介绍


Once clicked, it will display an additional popup contained more information which is defined in the application code:


SAP Fiori Elements里Smart Link工作原理介绍


All the source code of this sample project could be found from this link.


Project resource overview

(1) the label of Hyperlink field is defined in metadata via annotation “sap:label”

(2) the hyperlink field itself is defined in XML view. Its value is bound to field Name in OData Model.

SAP Fiori Elements里Smart Link工作原理介绍


(3) in OData model, the field Name has maintained annotation “com.sap.vocabularies.Common.v1.SemanticObject” so in runtime UI5 framework will render it as a SmartLink.


(4) Once pressed, UI5 framework will raise a popup which contains additional three links which are available to click. The navigation target is defined by application as below.


SAP Fiori Elements里Smart Link工作原理介绍


How link related annotation is parsed and SmartLink instance is created

As discussed in previous two blogs, UI5 framework will try to scan all potential annotations in OData model metadata,


SAP Fiori Elements里Smart Link工作原理介绍SAP Fiori Elements里Smart Link工作原理介绍



Since now semantic annotation is available, in line 55 there is a central _getCreator which will return the dedicated function name for control creation.


SAP Fiori Elements里Smart Link工作原理介绍


In our example, the function name is _createEdmSemantic because of the availability of semantic annotation:

SAP Fiori Elements里Smart Link工作原理介绍



Within this _createEdmSemantic, a new instance of SmartLink is created.


SAP Fiori Elements里Smart Link工作原理介绍


In its constructor, the Press event handler is registered and hyperlink CSS class is added.


SAP Fiori Elements里Smart Link工作原理介绍


How is the popup dialog rendered when hyperlink is pressed

In event handler _linkPressed, semantic Attributes are calculated and returned:


SAP Fiori Elements里Smart Link工作原理介绍


_linkPressed calls fOpen() for Popup creation and display logic:


SAP Fiori Elements里Smart Link工作原理介绍


As the first step, in fOpen() a new popup dialog is created via _createPopover().


SAP Fiori Elements里Smart Link工作原理介绍


The popup dialog is implemented by NavigationPopover. When the links within this popup dialog are clicked, _onInnerNavigate will be called.


SAP Fiori Elements里Smart Link工作原理介绍


In order to render the hyperlinks within the popup dialog, UI5 framework must know the navigation target url. This information is provided by application and retrieved by UI5 framework asynchronously:


SAP Fiori Elements里Smart Link工作原理介绍

The navigation target information from application is passed into UI5 framework callback and LinkData instance is created based on each of them, then added to popup dialog instance.


SAP Fiori Elements里Smart Link工作原理介绍


After that you could observe that the three navigation information are maintained in the popup dialog instance’s aggregation area:


SAP Fiori Elements里Smart Link工作原理介绍


Once all is done, TargetsObtained event is raised:


SAP Fiori Elements里Smart Link工作原理介绍


And the event handler for it will call show function of popup dialog, so you could see it in UI finally.


上一篇:跟我学雨林木风系统制作——2.涉及的技术及用到的工具介绍


下一篇:编解码-java序列化