3.0 Draft List

[ilhan007]

Future 3.0 will be focused on cleaning up deprecated APIs and only very few changes to actively used APIs, based on consumers feedback. Thus, the migration effort will be minimal. Timeline of 3.0 is not fixed yet, but most likely will take place in the first half of 2026.

@ui5/webcomponents-base

Configuration

• Rename defaultFontLoading to skipFont default: false
• Rename enableDefaultTooltips to disableDefaultTooltips default: false (4.0)
• Remove getFirstDayOfWeek? Is it covered completely by calendarWeekNumbering (ask Balkan)

UI5Element

• Remove fireEvent, use fireDecoratorEvent instead and rename fireDecoratorEvent to fireEvent (deprecated)

@customElement

• Remove dependencies option (and static get dependencies), no longer necessary for jsxRenderer-enabled components (deprecated)
• Remove features option, no longer necessary for jsxRenderer-enabled components (deprecated)
• Remove static async onDefine() lifecycle hook, use the @i18n decorator and @customElement#cldr option to fetch i18 and cldr data. (deprecated)
  Note: research if this hook is used by stakeholders

@event

• Remove @ui5/webcomponents-base/dist/decorators/event.js and rename @ui5/webcomponents-base/dist/decorators/event-strict.js to @ui5/webcomponents-base/dist/decorators/event.js (deprecated)

@bound

• Remove @bound decorator as not used

• Remove addCustomCSS?

index.ts

• change structure of exported modules, cluster them semantically

@ui5/webcomponents-tools

WDIO

• Remove the support of WDIO test (deprecated)

HBS

• Remove the support of HBS templates (deprecated)
  And, clean up everything related to it: LitRenderer, lit-html, hbs2lit, scripts, commands, etc
• Recheck legacy and jsx flags.

Configuration

• create-package does not create config/
• create-package does create vite config, eslint config, package-script.css

What remains public?

Dependencies

• Update Dependencies (eslint, vite, ect.) to latest. This is part of 3.0 as the updates may manifest in changes to config files and may require adopting changes in working projects.

@ui5/webcomponents-icons

• Remove clinical-tast-tracker icon

@ui5/webcomponents

ui5-button

• Remove submits property, set the "type" property to "Submit" (v1.15) (deprecated)

ui5-calendar, ui5-date-picker, ui5-datetime-picker, ui5-daterange-picker

• Remove formatPattern property, use displayFormat and valueFormat instead (v2.14) (deprecated)

ui5-combobox

TBD by Rila

• TBD

ui5-datepicker, ui5-datetime-picker, ui5-daterange-picker

• Remove isValid method, use isValidValue or isValidDisplayValue instead (deprecated)

ui5-*

• change open/close events of drop-down components to non-bubbling
• components with bubbling "open" event: Menu, ViewSettingDialog, ComboBox, Input, ToolbarSelect, TimePicker
• components with bubbling "close" event: ColorPalettePopover, BarcodeScannerDialog, ViewSettingDialog, TimePicker

ui5-option

• Remove selected property in favor of ui5-select#value

ui5-popover, ui5-responsive-popover, ui5-dialog, etc.

• Remove before-open, keep open, before-close and close

ui5-split-button

• Rename event arrow-click to arrow-button-click
• Rename property activeArrowButton to arrowButtonPressed

ui5-table

• Remove TableSelection (ui5-table-selection) web component and the TableSelectionMode enum
  Use the ui5-table-selection-single or ui5-table-selection-multi web components instead (v2.8) (deprecated)

@ui5/webcomponents-fiori

ui5-shellbar

TBD by Pirin

• Remove property primaryTitle, use branding slot (with ui5-shellbar-branding) (deprecated)
• Remove slot logo, use branding slot (with ui5-shellbar-branding) (deprecated)
• Remove slot menuItems, use ?

IllustrationMessageDesign

• Remove Dot, use ExtraSmall (v2.10) (deprecated)
• Remove Spot, use Small (v2.10)(deprecated)
• Remove Dialog, use Medium (v2.10) (deprecated)
• Remove Scene, use Large (v2.10) (deprecated)

IllustrationMessageType

• Remove ~39 illustrations, replaced by new (v2.11) (deprecated)

ViewSettingsDialogMode

• Change enum visibility from public to private
  as the enum describes a private property and shouldn't have been made public

[adrian-bobev]

As described in issue #10502 the before-open event is not working properly with the current implementation. And furthermore, it is somehow obsolete and maybe not needed.

[nnaydenow]

Remove clinical-tast-tracker icon