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 withk-button-flat-base
class. - Added
k-prompt-view
andk-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 ofk-button-md
. - Unpinned pane has now class
k-pane-unpinned
instead ofk-pane-pinned
. - Pin and close button of not active TabStrip Tabs now have
k-button-flat-primary
, instead ofk-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 tok-group-cell.k-table-group-td.k-table-td
. - Added
k-input-icon
. - Removed
k-label
class from extra class onk-pager-info
. - Removed
k-reorderable
class fromtbody
of a reorderable grid. - Removed
k-editable
class.
ImageEditor
- The
k-widget
class is now removed. - The
k-imageeditor-pane-confirm-button
andk-imageeditor-pane-button
classes have been removed from the resize/crop pane buttons. - The
k-colspan-1
class is removed from thek-col-span-1
element. - The
k-colspan-2
class is removed from thek-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
tok-button-flat
on the scroll buttons - Changed
k-button-solid-base
tok-button-flat-base
on the scroll buttons - Added
k-menu-scroll-wrapper-vertical
to thediv.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 thek-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 byk-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 theth.k-pivotgrid-cell
elements. - The
k-table-td
has been removed from thetd.k-pivotgrid-cell
elements. - The
k-pos-relative
andk-widget
classes are now removed from the Configurator. - The
k-rounded-full
class is substituted byk-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 itsk-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. - The
k-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 withk-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
andk-splitter-vertical/horizontal
classes have been added to thek-splitter
rootdiv
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 withref-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