@ui5/webcomponents-react-compat

@ui5/webcomponents-react-compat

The compat (compatibility) package provides components that were removed in the v2 release but are still available for backwards compatibility.

Some of these components lack accessibility or design support, while others have been replaced by UI5 web components. In general, we recommend using components from this package only as a temporary solution.

Component Support

Components in this package will not receive any new features. Only critical bugs, that are outside the component's inherent limitations, will be addressed. This package will be maintained until the next major release (which is not currently on our roadmap).

Installation

npm install @ui5/webcomponents-react-compat

Importing Components

As the v1 ui5-table (Table) component is part of this package and some custom element names are equal to the new v2 ui5-table, importing components from the root (import { Table } from "@ui5/webcomponents-react-compat") is discouraged. The primary reason is that tree-shaking capabilities are limited in the default configurations of most bundlers in dev mode. As a result, custom elements for the v1 table will still be defined, even if only the Toolbar is imported. This can cause unexpected behavior if the v2 table is also used in the same app.

Please only import components from the file path!

E.g.:

• import { Table } from '@ui5/webcomponents-react-compat/dist/components/Table/index.js';
• import { Toolbar } from '@ui5/webcomponents-react-compat/dist/components/Toolbar/index.js';

It is not supported using the v1 Table and the v2 Table in the same application!

Documentation

You can find an interactive documentation in our Storybook (Legacy Components).

Contribute

Please check our Contribution Guidelines.

License

Please see our LICENSE for copyright and license information. Detailed information including third-party components and their licensing/copyright information is available via the REUSE tool.

Changelog

2.5.0 (2024-12-09)

Bug Fixes

• AnalyticalTable: block interaction during loading (#6602) (de3c96d)
• AnalyticalTable: only show BusyIndicator if table has data (#6614) (36aa447)
• AnalyticalTable: show vertical resizer while dragging (#6694) (0715e49)
• AnalyticalTable: update column header icons to align with latest specs (#6593) (b5859ed)
• cli: improve description for events & outline experimental components (#6625) (799e0dc)
• deps: update dependency @tanstack/react-virtual to ~3.11.0 (#6702) (2d9dbe4)
• deps: update dependency @tanstack/react-virtual to v3.10.9 (#6605) (4f76c5d)
• deps: update dependency recharts to v2.14.1 (#6684) (4ce15b0)
• deps: update nextjs monorepo to v15 (major) (#6538) (6ca32ce)
• MessageViewButton: add default tooltip & aria-label (#6595) (d924cbf), closes #6594
• NavigationLayout: add root export (#6657) (6954d95)
• ObjectPage: fix selection & header scroll behavior (#6663) (62eb7e0), closes #6600 #6648
• ObjectStatus: fix icon alignment in large & inverted mode (#6676) (7aebe5f), closes #6668
• Pie- & DonutChart: improve activeSegment handling & fix focus behavior (#6686) (d5b612d), closes #6683
• StyleStore: fix stale reference leading to memory leak (#6649) (4aaf4f9), closes #6646
• StyleStore: replace useSyncExternalStore shim with react import (#6650) (af15a8c)
• VariantManagement: fix hideApplyAutomatically (#6624) (06a88f5), closes #6618
• VariantManagement: fix boolean prop handling (#6641) (69ed3e0), closes #6616
• VariantManagement: fix dirty-state and readOnly behavior (#6628) (fe389bc), closes #6622 #6617
• VariantManagement: support React 19 (#6639) (1b4c37d)

Features

• AnalyticalTable: introduce popinDisplay column option (#6619) (cc2bca7), closes #5972
• update to UI5 Web Components 2.5.0 (#6696) (19a29aa)