Introduction
Knowledge Base
Breaking Changes / 2024 Releases
New to Telerik UI for ASP.NET MVC? Start a free 30-day trial

2024 Releases

This article lists the breaking or important changes in the 2024 releases of Telerik UI for ASP.NET MVC.

Telerik UI for ASP.NET MVC Q4 2024

Kendo UI Themes

For a while, the CSS Utilities were bundled with the Kendo UI themes. Starting with version Q4 2024, the CSS Utilities are no longer included in the Kendo UI themes. The Kendo UI theme stylesheet still contains all the necessary styles. However, in case you need to create an additional layout, dependent on the utility classes, you need to include the additional stylesheet kendo-theme-utils.css, which is available in the styles folder of the Telerik UI for ASP.NET MVC distribution and through the Kendo CDN service.

HTML
    <link rel="stylesheet" href="~/lib/kendo/styles/default-ocean-blue.css" />
    <link rel="stylesheet" href="~/lib/kendo/styles/kendo-theme-utils.css" />

Deprecated APIs

The <WidgetName>.AsChildComponent() method has been deprecated.

Content browsing APIs

The following interfaces, classes and their methods have been deprecated and removed from the Kendo.Mvc dll:

ComponentClass
EditorDirectoryBrowser.cs
EditorDirectoryPermission.cs
EditorIDirectoryBrowser.cs
EditorIDirectoryPermission.cs
EditorFitImageResizer.cs
EditorIImageResizer.cs
EditorImageResizer.cs
EditorImageSize.cs
EditorIThumbnailCreator.cs
EditorThumbnailCreator.cs
FileManagerContentBrowser.cs
FileManagerContentPermission.cs
FileManagerIContentBrowser.cs
FileManagerIContentPermission.cs

The code is moved to the demo application, where it is used for demo purposes only, demonstrating a possible implementation of the directory and file access functionality, and thumbnail creation. It is advisable to follow the best practices of your company/organization when implementing the read/write access for the backend required for the above-listed components.

Editor APIs

OldNew
Editor.Messages.Styles()Editor.Messages.Formatting()
Editor.Messages.FormatBlock()Editor.Messages.Formatting()
EditorToolFactory.FontColor()EditorToolFactory.ForeColor()

TextArea APIs

OldNew
Resizable(String)Resize(TextAreaResize)

Class Changes in Components

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.
  • The k-state-default class is now removed.
  • The text of menu items is now wrapped in a span element with the k-menu-link-text class

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 Q4Versions 2024 Q4 and later
k-navigator-upk-navigator-n
k-navigator-rightk-navigator-e
k-navigator-downk-navigator-s
k-navigator-leftk-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

PanelBar

  • Removed wrong classes k-level-0 and k-panelbar-header from child items.
  • Removed duplicate class k-panelbar-item on items initialized via Items(), which are not k-level-0.
  • Removed extra class k-content applied to k-panelbar-content div wrapper.

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 Q4Versions 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-leftk-i-caret-alt-left
k-svg-i-arrow-rightk-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 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 split 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 Q4Versions 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.

Telerik UI for ASP.NET MVC Q2 2024

Target Framework

As of the Q2 2024 release, Telerik UI for ASP.NET MVC supports .NET Framework 4.6.2 and later versions. You can update to a supported .NET Framework version.

Telerik.Web.Captcha As of the Q2 2024 release, the Telerik.Web.Captcha package targets .NET Framework 4.6.2

Telerik.Web.Spreadsheet As of the Q2 2024 release, the Telerik.Web.Spreadsheet package targets .NET Framework 4.6.2

Kendo.Mvc.Export As of the Q2 2024 release, the Kendo.Mvc.Export.dll assembly targets .NET Framework 4.6.2

Chart

The default Theme configuration for the Telerik UI for ASP.NET MVC Charts is changed to sass. By default, the Chart theme will now match the loaded Sass-based theme.

Telerik UI for ASP.NET MVC Q1 2024

Deprecated Controllers

As of the Q1 2024 release, the following controllers will be deprecated.

  • FileManager—ContentProviderController
  • Editor—EditorImageBrowserController, FileBrowserController, EditorFileBrowserController

Deprecated Interfaces

As of the Q1 2024 release, the following interfaces will be deprecated.

  • FileManager—IContentProviderController
  • Editor—IFileBrowserController, IImageBrowserController

Deprecated APIs

As of the Q1 2024 release, the following APIs will be deprecated.

  • ChartSeriesBuilderBase.GroupNameTemplate

    Razor
        .Series(series => series.Bar(s => s.Sales)
        .Name("Sales")
        .GroupNameTemplate("#= series.name # for #= group.field #   #=    group.value #")
    )

  • EditorMessages.FormatBlock, EditorMessages.Styles

    Razor
        .Messages(messages => messages
        .FormatBlock("Format")
        .Styles("Style")
    )
In this article
Telerik UI for ASP.NET MVC Q4 2024Kendo UI ThemesDeprecated APIsClass Changes in ComponentsTelerik UI for ASP.NET MVC Q2 2024Target FrameworkChartTelerik UI for ASP.NET MVC Q1 2024
Not finding the help you need?
Contact Support