As OpenUI5 evolves over time, some of the UI controls are replaced by others, or their concepts abandoned entirely. This chapter gives an overview on theme and library level of the most important deprecations. Individual control deprecations and more information about the controls replacing them can be found in the API reference within the Demo Kit.
sap_ux
The sap_ux theme is deprecated as of version 1.38. This was one of the very first OpenUI5 themes and is only implemented by a small subset of the sap.ui.commons and sap.ui.ux3 controls, which are also deprecated.
sap_platinum
The sap_platinum theme is deprecated as of version 1.38. This was one of the very first OpenUI5 themes and is only implemented by a small subset of the sap.ui.commons and sap.ui.ux3 controls, which are also deprecated.
sap_goldreflection
The sap_goldreflection theme is deprecated as of version 1.38. This was one of the first OpenUI5 themes and is only implemented by the sap.ui.commons and sap.ui.ux3 controls, which are also deprecated.
sap.ui.commons
The sap.ui.commons library is deprecated as of version 1.38.
sap.ui.commons was available from the very beginning of OpenUI5. It contains a large number of basic UI controls like buttons, input fields and dropdowns. With version 1.16, the sap.m library was introduced. It contains semantically identical controls (button, input and select) that, at that time, were only supported on mobile platforms. In later versions, sap.m was extended to support desktop platforms as well. For more information about this, see Browser and Platform Support. The sap.m controls were bigger in size to support mobile displays that require a larger touch area. The “Compact Content Density” feature explained under Content Densities was then added to OpenUI5, allowing you to display a control in a more compact screen size. Today, applications should be built one single time using sap.m (and other libraries) and their content density switched at runtime depending on the environment. As such, the redundant library sap.ui.commons should no longer be used.
Some of the controls in sap.ui.commons.layout have been replaced by the new dedicated layout library called sap.ui.layout, which runs on the same platforms as sap.m.
Some of the old controls have been made available again through the non-deprecated sap.ui.unified library (e.g. FileUploader, Menu), which runs on the same platforms as sap.m.
Some concepts such as Tree, Accordion and Row Repeater have been abandoned completely.
Should you decide to ignore the deprecation and continue using sap.ui.commons, you should at least use the sap_bluecrystal theme and not the sap_ux, sap_platinum and sap_goldreflection themes, which are also deprecated, as this is more favorable than using a combination of library and theme that are both deprecated.
sap.ui.ux3
The sap.ui.ux3 library is deprecated as of version 1.38.
|
Concept |
What's Happened? |
|---|---|
|
Feeds |
Replaced by sap.m (sap.m.Feed*). |
|
Notification Bar |
Replaced by sap.m (sap.m.MessagePopover and sap.m.semantic*). |
|
Thing Inspector |
Indirectly replaced by a different design for displaying object data. |
|
Shell |
Partially replaced by sap.ui.unified.Shell. |
|
Data Set |
Not part of SAP Fiori. |
|
Exact |
Not directly part of SAP Fiori. Use sap.ui.comp.FilterBar or sap.m.IconTabBar for filtering. |
|
Quick Views |
Concept abandoned as the concept of “hovering with the mouse pointer over a control” does not exist on mobile devices. |
For more information about the SAP Fiori design, see the SAP Fiori Design Guidelines.
Should you decide to ignore the deprecation and continue using sap.ui.ux3, you should at least use the sap_bluecrystal theme and not the sap_ux, sap_platinum and sap_goldreflection themes, which are also deprecated, as this is more favorable than using a combination of library and theme that are both deprecated.