Breaking Changes

New to Kendo UI for jQuery? Download free 30-day trial

2024 Releases

This article lists the breaking or important changes in the 2024 releases of Kendo UI. For the complete list of changes in the UI components, see the product release history.

Kendo UI 2024 Q4

Separating the Utilities Classes from the Kendo Themes

Starting with Kendo UI 2024 Q4 release and 9.0.0 version of the Kendo Themes, the Utililities classes, which allow you to customize the layout of the components, are now distributed in a separate package - kendo-theme-utils. You can find more information about the Utilities and how to add the package in the Progress Design System Kit.

AIPrompt

  • The k-button-flat-primary class is now replaced with k-button-flat-base class.
  • Added k-prompt-view and k-prompt-popup.

ComboBox

  • The loading icon is now rendered as a separate span element with classes k-input-loading-icon k-icon k-i-loading before the button k-input-button.

ContextMenu

  • The k-widget class is now removed.
  • The k-menu-expand-arrow-icon class has also been removed.

DockManager

  • Buttons in the vertical toolbar are now size k-button-sm, instead of k-button-md.
  • Unpinned pane has now class k-pane-unpinned instead of k-pane-pinned.
  • Pin and close button of not active TabStrip Tabs now have k-button-flat-primary, instead of k-button-flat-base.

DropDownList

  • The loading icon is now rendered as a separate span element with classes k-input-loading-icon k-icon k-i-loading before the button k-input-button.

Grid

  • Added k-button-icon.k-icon.k-svg-i-arrow-rotate-cw.k-svg-icon to the refresh button in the pager.
  • Added k-drag-col to the draggable of the grid.
  • Added k-filtercell-operator div wrapper on the filter dropdown and clear button.
  • Added k-grid-add-row.
  • Added k-table-group class to k-group-cell.k-table-group-td.k-table-td.
  • Added k-input-icon.
  • Removed k-label class from extra class on k-pager-info.
  • Removed k-reorderable class from tbody of a reorderable grid.
  • Removed k-editable class.
  • Use k-grid-columnmenu-popup instead of k-columnmenu-popup.

GridLayout

  • The k-widget class has been removed.
  • The k-justify-content- classes were substituted with k-justify-items-.

ImageEditor

  • The k-widget class is now removed.
  • The k-imageeditor-pane-confirm-button and k-imageeditor-pane-button classes have been removed from the resize/crop pane buttons.
  • The k-colspan-1 class is removed from the k-col-span-1 element.
  • The k-colspan-2 class is removed from the k-col-span-2 element.

Map

  • The following classes have been substituted:
Versions prior to 2024 Q4 Versions 2024 Q4 and later
k-navigator-up k-navigator-n
k-navigator-right k-navigator-e
k-navigator-down k-navigator-s
k-navigator-left k-navigator-w
  • The k-widget class is now removed.
  • The km-widget class has also been removed.
  • Added k-button-group-solid class on the Zoom button group.

Menu

  • The k-vertical class is removed from the scroll wrapper when the Menu is scrollable.
  • The k-horizontal class is removed from the scroll wrapper when the Menu is scrollable.
  • The k-widget is now removed.
  • The k-menu-expand-arrow-icon is now removed.
  • The k-group class has also been removed.
  • With the latest theme changes the following classes of the scroll buttons are removed: k-scroll-up, k-scroll-down, k-scroll-left, k-scroll-right, k-rounded
  • Changed k-button-solid to k-button-flat on the scroll buttons
  • Changed k-button-solid-base to k-button-flat-base on the scroll buttons
  • Added k-menu-scroll-wrapper-vertical to the div.k-menu-scroll-wrapper only when the orientation is vertical, not applicable for the horizontal orientation

PDFViewer

  • The PDFViewer starts using the Pager component internally and follows its specification.
  • Added k-icon class to the k-dropzone-icon in the center of the viewer.
  • Added k-toolbar-combobox to the combobox for zoom options.
  • Removed k-widget.
  • Removed k-zoom-in-out-group on the zoom tools buttongroup.
  • Removed k-toggle-selection-group on selection buttongroup.

PivotGridV2

The following classes are now removed:

  • The k-pivotgrid-header-total class rendered in the total row of PivotGrid aggregates is replaced by k-pivotgrid-total.
  • The k-grid-header-table class is now removed.
  • The k-table-md class is removed from the .k-pivotgrid-table tables.
  • The k-table-tbody has been removed from the .k-pivotgrid-tbody elements.
  • The k-table-row class is now removed from the .k-pivotgrid-row elements.
  • The k-grid-table class has been removed from the .k-pivotgrid-table values table.
  • The k-table-th has been removed from the th.k-pivotgrid-cell elements.
  • The k-table-td has been removed from the td.k-pivotgrid-cell elements.
  • The k-pos-relative and k-widget classes are now removed from the Configurator.
  • The k-rounded-full class is substituted by k-round-md.
  • Added k-pivotgrid-expanded on an expanded header.
  • The text of a header is now rendered in a span element with k-pivotgrid-header-title class.
  • The content of a cell is rendered in a span element with this k-pivotgrid-content class.
  • The form in the configurator has k-form-md class added to its k-form class.
  • Added k-chip-more-action class on the more action span in configurator chip.

Scheduler

  • The following classes are substituted as follows:
Versions prior to 2024 Q4 Versions 2024 Q4 and later
k-nav-today [data-selector='today']
k-nav-prev [data-selector='previous']
k-nav-next [data-selector='next']
k-view-month [data-selector='month']
k-view-week [data-selector='week']
k-view-day [data-selector='day']
k-view-agenda [data-selector='agenda']
k-view-timeline [data-selector='timeline']
k-svg-i-arrow-left k-i-caret-alt-left
k-svg-i-arrow-right k-i-caret-alt-right
  • The k-button-rectangle is removed from the buttons in views ButtonGroup.
  • Thek-heading-cell is removed from the Scheduler first column.
  • The k-scheduler-table-auto is removed from the Month view.
  • The k-scheduler-group-cell is removed from grouped Scheduler.
  • Added k-scheduler-navigation class to Today, Previous and Next buttongroup.
  • Added k-scheduler-views class to views buttongroup.
  • Added k-scheduler-cell class to Weekview, dayview, timelineview.
  • Added k-group-cell class.
  • Removed k-event-top-actions element from scheduler events.
  • Removed k-event-bottom-actions element from scheduler events
  • Removed k-last from inappropriate scenarios.
  • Replaced k-svg-i-arrow- classes of Prev and Next buttons in RTL Scheduler with k-svg-i-caret-alt.

Splitter

The Splitter has received a rendering update. As a result, the below classes have been added:

  • New k-splitter-flex and k-splitter-vertical/horizontal classes have been added to the k-splitter root div element.
  • New k-pane-static class has been added to the non-resizable panes.
  • New k-hidden class has been added to the collapsed panes.

Apart from that, we made changes in the positioning styles of the component. Until now, the panes had the position:absolute style. As of the 2024 Q4 release, the panes are positioned using flexbox.

Spreadsheet

  • The tabs in the Spreadsheet are now rendered via Kendo Menu instead of a Kendo TabStrip.
  • The rendering of the SheetsBar at the bottom is unified with the rendering of a Kendo UI TabStrip.
  • The Add New Sheet tool in the SheetsBar is now created from <button> element instead of <a role="button"\>.
  • The Quick Access section in the top toolbar is removed and the Undo and Redo buttons are moved in the Home tab.
  • The tools in the toolbar are now splitted into six separate tabs - File, Home, Insert, Format, Data and View.
  • Replaced k-icon k-i-undo with k-icon k-i-reset.
  • Replaced k-icon k-i-redo with k-icon k-i-reload.
  • Default values for rowHeight and headerHeight were set to 30 pixels.

StackLayout

  • The k-widget class has been removed.

TabStrip

  • The k-widget class has been removed.
  • The k-tabstrip-item class has been removed.
  • The k-tab-on-top class has been removed.
  • The k-content class has been removed.
  • k-link-text is added.

ToolBar

  • The following classes have been replaced or removed:
Versions prior to 2024 Q4 Versions 2024 Q4 and later
k-toolbar-tool [data-item-role='toolbar-tool']
  • The k-toolbar-toggle-button class has been removed.
  • The k-dropdown-button class has also been removed.

This change is applied to all components that use the Toolbar internally, such as Grid, Gantt, Scheduler, etc.

TreeList

  • The k-i-none class has been replaced with ref-blank-icon attribute.
  • The k-grid-display-block class is now removed from .k-treelist element.
  • Added k-drag-col to the col element for draggable column both in the header table and the body table.

Kendo UI 2024 Q2

TreeView

The following classes are now removed or replaced:

  • The k-group class has been removed from the ul.k-treeview-group.k-treeview-lines element.
  • The k-first, k-last, and k-item classes have been removed from the li.k-treeview-item element.
  • The k-in class has been removed from the span.k-treeview-leaf element.
  • The k-toggle-icon class has been removed from the toggle arrows.
  • The k-checkbox-wrapper class has been replaced with k-checkbox-wrap class.
In this article
Related articles
Not finding the help you need? Improve this article