Breaking Changes

New to Telerik UI for ASP.NET Core? Download free 30-day trial

2024 Releases

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

Telerik UI for ASP.NET Core 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 Core distribution and through the Kendo CDN service.

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

    <link rel="stylesheet" href="https://kendo.cdn.telerik.com/themes/10.0.1/default/default-ocean-blue.css" />
    <link rel="stylesheet" href="https://kendo.cdn.telerik.com/themes/10.0.1/utils/all.css"/>

Target Framework

With the Q4 2024 release, Telerik UI for ASP.NET Core support for .NET 7 has been dropped as it has reached EOL on May 14, 2024. You can update to a supported LTS and STS versions of .NET Core.

Checkbox

The Rounded configuration for the HTML Helpers now expects Kendo.Mvc.UI.Rounded enum instead of Kendo.Mvc.UI.BasicRounded, exposing an additional Full option.

PanelBar TagHelper

The PanelBarItemBase(ViewContext) constructor of the PanelBarItemBase.cs class is now obsolete. Use the parameterless constructo instead.

Form TagHelper

The Size attribute now expects Kendo.Mvc.UI.ComponentSize enum instead of a string.

Deprecated APIs

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

Content browsing APIs

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

Component Class
Editor DirectoryBrowser.cs
Editor DirectoryPermission.cs
Editor IDirectoryBrowser.cs
Editor IDirectoryPermission.cs
FileManager ContentBrowser.cs
FileManager ContentPermission.cs
FileManager IContentBrowser.cs
FileManager IContentPermission.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. It is advisable to follow the best practices of your company/organisation when implementing the read/write access for the backend required for the above-listed components.

Editor APIs

Old New
Editor.Messages.Styles() Editor.Messages.Formatting()
Editor.Messages.FormatBlock() Editor.Messages.Formatting()
EditorToolFactory.FontColor() EditorToolFactory.ForeColor()

TextArea APIs

Old New
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.

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.

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.

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.

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.

Telerik UI for ASP.NET Core Q2 2024

Target Framework

As of the Q2 2024 release, Telerik UI for ASP.NET Core supports only LTS and STS versions of .NET Core. You can update to a supported .NET Core version.

Chart

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

Telerik UI for ASP.NET Core 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.

  • ChartSeriesBuilder.Type(string)

        .Series(series => series
         .Bar(new double[] { 3.907 })
         .Type("bar")
    )

        .Series(series => series
       .Bar(new double[] { 3.907 }) // Type is determined by the declared Series builder.
    )

  • ChartSeriesLineSettingsBuilder.Width(string), ChartSeriesLineSettingsBuilder.Style(ChartAreaStyle), ChartSeriesLineSettingsBuilder.Style(ChartPolarAreaStyle), ChartSeriesLineSettingsBuilder.Style(ChartRadarAreaStyle)

        .Series(series => series
       .Bar(new double[] { 3.907 })
       .Line(line => line
               .Width("100px")
               .Style(ChartAreaStyle.Normal)
               .Style(ChartPolarAreaStyle.Normal)
               .Style(ChartRadarAreaStyle.Normal)
       )
    )

        .Series(series => series
       .Bar(new double[] { 3.907 })
       .Line(line => line
               .Width(100)
               .Style(ChartSeriesLineStyle.Normal)
       )
    )

  • ChartSeriesOverlaySettingsBuilder.Gradient

        .Series(series => series
       .Bar(new double[] { 3.907 })
       .Overlay(overlay => overlay.Gradient(ChartBarGradient.Glass))
    )

        .Series(series => series
       .Bar(new double[] { 3.907 })
       .Overlay(overlay => overlay.Gradient(ChartSeriesGradient.Glass))
    )

  • SplitterEventBuilder.LayoutChange

        .Events(events => events
       .LayoutChange("change")
       .LayoutChange(@<text>function () { return; }</text>)
    )

        .Events(events => events
       .Render("change")
       .Render(@<text>function () { return; }</text>)
    )

Deprecated Extensions

  • ApplicationBuilderExtensions
In this article
Related articles
Not finding the help you need? Improve this article