Show TOC

Deprecated Themes and LibrariesLocate this document in the navigation structure

As SAPUI5 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.

Deprecated Themes

sap_bluecrystal

The sap_bluecrystal theme is deprecated as of version 1.40. It is replaced by sap_belize as the default theme for SAPUI5 applications.

sap_ux

The sap_ux theme is deprecated as of version 1.38. This was one of the very first SAPUI5 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 SAPUI5 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 SAPUI5 themes and is only implemented by the sap.ui.commons and sap.ui.ux3 controls, which are also deprecated.

Deprecated Libraries

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 SAPUI5. 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 sap.m, sap.ui.table, sap.uxap, sap.tnt, sap.ui.comp, sap.ushell. 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 SAPUI5, 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.

Note

Should you decide to ignore the deprecation and continue using sap.ui.commons, we recommend you use the sap_bluecrystal or sap_belize theme and not the deprecated sap_ux, sap_platinum and sap_goldreflection themes, which will be removed in one of the next releases. The sap_bluecrystal theme is also deprecated, but offers full coverage of the sap.ui.commons library and will be maintained for some time, though not actively developed. The sap_belize theme offers an initial implementation for the sap.ui.commons library to allow for a smoother transition, but it is not supported for this library and will not be maintained. We recommend that you consider migrating your existing apps to actively developed libraries, such as sap.m, and use sap_belize as the default theme going forward.

sap.ui.ux3

The sap.ui.ux3 library is deprecated as of version 1.38.

This library contains more complex UI controls that were based on sap.ui.commons along the UX3 design approach. The sap.m library - successor to sap.ui.commons - implements SAP’s new SAP Fiori design [http://experience.sap.com/fiori-design/], which supersedes UX3. As such, the sap.ui.ux3 library is also deprecated. Some of the UX3 concepts are reflected in SAP Fiori, some are abandoned, as outlined in the following table:

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.

Note

Should you decide to ignore the deprecation and continue using sap.ui.ux3, we recommend you use the sap_bluecrystal or sap_belize theme and not the deprecated sap_ux, sap_platinum and sap_goldreflection themes, which will be removed in one of the next releases. The sap_bluecrystal theme is also deprecated, but offers full coverage of the sap.ui.ux3 library and will be maintained for some time, though not actively developed. The sap_belize theme offers an initial implementation for the sap.ui.ux3 library to allow for a smoother transition, but it is not supported for this library and will not be maintained. We recommend that you consider migrating your existing apps to actively developed libraries, such as sap.m, and use sap_belize as the default theme going forward.

sap.ca

The sap.ca library is deprecated as of version 1.22.

This library contains a mixture of controls for various use cases. Some were replaced by sap.m (e.g. DatePicker, Message) and some were discontinued without being replaced (such as Hierarchy or OverflowContainer).

sap.me

The sap.me library is deprecated as of version 1.34.

The main feature within the sap.me library are the calendar controls. You find replacement controls in the sap.ui.unified library covering most but not all features of the sap.me calendars.

sap.makit

The sap.makit library is deprecated as of version 1.38.

The sap.makit library contains a few chart controls that only support mobile platforms and do not support accessibility measures. This library is replaced by sap.viz.