loio

a87ca843bcee469f82a9072927a7dcdb
view on: demo kit nightly build | demo kit latest release

Deprecated Themes and Libraries

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.

Themes that are no longer supported

sap_hcb
The sap_hcb theme is deprecated as of version 1.48. It has been replaced by the
sap_belize_hcb theme.
sap_hcb is the High Contrast Black theme used for the already deprecated
sap_goldreflection and sap_bluecrystal themes. For sap_belize and sap_belize_plus
there are two high contrast themes available: sap_belize_hcb (High Contrast Black) and
sap_belize_hcw (High Contrast White).

sap_bluecrystal
The sap_bluecrystal theme is no longer supported as of version 1.40. It has been replaced
by sap_belize as the default theme for OpenUI5 applications.
Custom themes based on sap_bluecrystal are no longer supported with 1.40 or higher.

sap_ux
The sap_ux theme is no longer supported as of version 1.40. 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.This theme has been removed with
OpenUI5 version 1.48.

sap_platinum
The sap_platinum theme is no longer supported as of version 1.40. 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. This theme has been
removed with OpenUI5 version 1.48.

sap_goldreflection
The sap_goldreflection theme is no longer supported as of version 1.40. 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. This theme has been removed with OpenUI5 version
1.48.

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 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 Accordion and Row Repeater have been abandoned completely.

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 Replaced by sap.m (sap.m.MessagePopover and sap.m.semantic*).
Bar
Thing Indirectly replaced by a different design for displaying object data.
Inspector
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.
Related information
Index of Deprecated APIs
Supported Library Combinations
Supported Combinations of Themes and Libraries