2023 Releases
This article lists the breaking or important changes in the 2023 releases of Kendo UI. For the complete list of changes in the UI components, see the product release history.
Kendo UI 2023 R1 SP1
- Drop of the development and support of the LESS themes.
Unified Rendering
As of the 2023 R1 SP1 release, to unify their support for the new ThemeBuilder Pro, the following components have changed their rendering:
- Grid
- FileManager
- TreeList
- Gantt
- PivotGrid
- ListView
- ProgressBar
- Notification
- Upload
- Pager
- Toolbar
- Window
- Editor
- Calendar and MultiViewCalendar
- Animation Containers and their dependent components
The majority of the rendering changes can also be found within the existing test HTML specifications coming from the Kendo UI Themes Monorepo. The
testsfolder contains HTML specifications for all flavour of the components. The components follow the rendering strategy outlined in the specifications.
State Classes
All
k-state-{name of state}classes are transposed tok-{name of state}. A list of all the updated state classes can be found in the existing State Classes article.
Animation Containers
- Animation containers are all components that represent or hold a popup, for example, the Grid filter menu and column, and popup editor, Tooltip, SplitButton, DropDownList, and more.
- The
.k-animation-containerelements are now holding another wrapping element with the.k-child-animation-containerclass.
PanelBar
The text and icon of the items are wrapped within two separate <span> elements annotated with the .k-panelbar-item-text and .k-panelbar-item-icon classes.
Menu
The text of the items are wrapped within a standalone <span> element annotated with the .k-menu-link-text class.
DropDownList
The component's value is wrapped within a <span> element annotated with the .k-input-value-text.
Grid
All rendering changes in the Grid also apply to the FileManager, TreeList, Gantt, and PivotGrid as these components use the Grid internally.
-
The following command classes have been renamed:
Versions prior to 2023.1.314 Versions 2023.1.314 and later k-grid-editk-grid-editk-grid-updatek-grid-save-commandk-grid-cancelk-grid-cancel-commandk-grid-cancelk-grid-cancel-commandk-grid-deletek-grid-remove-command -
The following classes
table-specific classes have been added to thetableelements:Versions prior to 2023.1.314 Versions 2023.1.314 and later <table><table class="k-table"><thead><thead class="k-table-thead"><tbody><tbody class="k-table-tbody"><tfoot><tfoot class="k-table-tfoot"><th><th class="k-table-th"><tr><tr class="k-table-row"><tr> alt rows<tr class="k-table-alt-row"><td><td class="k-table-td"> -
Except for the popups, the sizing option now propagates to all elements inside the Grid. These include the table, toolbar, pager, buttons, inputs, pickers, chip lists, and more.
-
The
.k-widgetclass is now removed from the.k-gridelement. -
The sorting icons will be replaced with their
.k-i-sort-asc-smalland.k-i-sort-desc-smallgeneral names instead of their.k-i-sort-asc-smand.k-i-sort-desc-smaliases. -
The sorting icon is now wrapped in a
<span>element:html<span class="k-sort-icon"> <span class="k-icon k-i-sort-asc-small"></span> </span> -
The headings of the Grid are now updated with the new header rendering:
Pre-Unified-Rendering<!--- Default header cell ---> <th class="k-header"> <a class="k-link"> ProductName </a> </th> <!--- Header cell with sorting---> <th class="k-header k-sorted"> <a class="k-link"> ProductName <span class="k-icon k-i-sort-asc-sm"></span> </a> </th> <!--- Header cell with filter menu---> <th class="k-header k-filterable"> <a class="k-grid-filter"> <span class="k-icon k-i-filter"></span> </a> <a class="k-link"> ProductName </a> </th> <!--- Header cell with column menu---> <th class="k-header"> <a class="k-header-column-menu"> <span class="k-icon k-i-more-vertical"></span> </a> <a class="k-link"> ProductName </a> </th> -
By default, the table elements inside the Grid are of medium-sized. The
.k-table-mdclass is added to the.k-tableelement. -
The
.k-grid-header-table,.k-grid-table, and.k-grid-footer-tableGrid-specific classes are now added to the header, body, and footer tables. -
The Grid uses internally the Toolbar component and follows the it's accessibility specification. The ToolBar is a single tab stop component and when navigation is enabled via the
navigatable:trueconfiguration, pressing theTabkey navigates to and from the Toolbar. When the Toolbar is focused, navigating to the previous or next focusable element is achieved via the arrow keys.
TabStrip
The k-floatwrap class has been removed from the TabStrip.
ListView
- The
.k-pager-wrapclass is now removed from the.k-pagerelement. - The
.k-listview-itemwrapper is now added to the item templates. - The
.k-listview-itemclass is now removed from the item template children. - The
.k-itemclass is now replaced with.k-progressbar-chunk.
ProgressBar
- The
.k-widgetclass is now removed. - A
.k-chunk-progressbarclass has been added to the Chunk ProgressBar. - The
.k-progressbar-chunksclass has been added to the<ul>element. - An additional
.k-progressbar-valueclass is now added to the<div>element with the.k-selectedclass in the default ProgressBar.
CheckBox
The CheckBox is wrapped in a <span> element annotated with the .k-checkbox-wrap class.
Notification
-
The
.k-widgetclass is now removed. -
The
k-notification-wrapclass has also been removed. -
The closable
<a class="k-icon k-i-close"></a>notification icon is now replaced with a<span>element and the icon class.k-i-closename has been changed to.k-i-x.html<span class="k-icon k-i-x">...</span> -
A
.k-notification-actionscontainer added wrapping to the closable icon.html<span class="k-notification-actions"> <span class="k-notification-action k-notification-close-action"> <span class="k-icon k-i-x">...</span> </span> ... </span>
Button
The .k-button-rectangle class is now removed.
-
The Upload button and input are no longer nested but are on one level, wrapped inside a
<div>element.Versions-Before-2023.1.314<div class="k-button k-upload-button" aria-label="Select files..."> <input name="files" id="upload-input"> <span>Select files...</span> </div> -
The following classes related to the Telerik UI for Upload have been renamed:
Versions prior to 2023.1.314 Versions 2023.1.314 and later k-file-groupk-file-iconk-file-name-size-wrapk-file-infok-file-name-invalidk-file-namek-file-informationk-file-summaryk-file-group-wrapperk-file-icon-wrapperk-file-invalid-group-wrapperk-file-icon-wrapperk-multiple-files-invalid-group-wrapperk-file-icon-wrapperk-dropzone-hoverk-hoverk-dropzone-hoveredk-hover -
The
.k-widgetclass is now removed from the.k-uploadelement. -
All
<em>and<strong>elements have been replaced withspanor<div>elements. -
A
.k-upload-dropzoneclass has been added to the.k-dropzoneelement. -
The
.k-upload-status-totalclass has been removed from the.k-upload-statuselement. -
The
.k-validation-iconclass is now removed from the.upload-statusicon. -
The
.k-file-errorclass has been added to.k-file-invalid. -
.k-file-singleand.k-file-multiplewrapper elements have been added inside the.k-fileelement for single and multiple files respectively. -
The
.k-file-name-invalidclass has been removed from the.k-file-nameelement. -
The
.k-text-successand.k-text-errorclasses have been removed from the.k-validation-messageelement. -
The Upload action buttons are no longer wrapped in a
.k-upload-statusclass but in the.k-upload-actionsclass. -
The progress bar is now replaced with the ProgressBar component without visible labels.
Pager
- The
.k-widgetclass is now removed from the.k-pagerelement. - The
.k-pager-numberselement is now a<div>element. - The
<a class="k-link k-page-nav"></a>navigation buttons have been replaced with<button class="k-pager-nav k-button k-button-{size} k-button-flat k-button-flat-base k-icon-button">...</button>flat buttons. - The
<span class="k-link></span>page numbers are now replaced with<button class="k-button k-button-{size} k-button-flat k-button-flat-primary">...</button>flat primary buttons. - The
.k-linkclass is now removed from the component. - The
.k-pager-wrapclass selector is now removed. - The
.k-pager-mobile-mdand.k-pager-mobile-smclasses are added when internal Pager elements are shown or hidden.
Toolbar
- The
.k-widgetclass is now removed from the.k-toolbarelement. - The
.k-toolbar-resizableclass is added when the Toolbar is responsive. - The
.k-overflow-anchorclass has been replaced with the.k-toolbar-overflow-buttonclass.
Window
- The
.k-window-titlelessclass is now removed. - The
.k-window-actionsclass in the title bar has been replaced with.k-window-titlebar-actions. - The
.k-window-buttongroupand.k-window-buttonsclasses are replaced with.k-window-actions. - The
.k-window-titlebar-actionclass is added to action buttons inside the title bar. - The
.k-dialog-{something}classes are removed from the component.
Dialog
-
A
.k-windowclass is now added to the component. -
The
.k-dialog-actionsclass in the title bar has been replaced with the.k-dialog-titlebar-actionsclass. -
The
.k-window-titlebar-actionand.k-dialog-titlebar-actionclasses have been added to the action buttons. -
The
.k-dialog-buttongroupand.k-dialog-buttonsclasses are now replaced with.k-dialog-actions. -
A new
.k-dialog-{value}theme color property has been added to the.k-windowelement. It supports theprimary,dark, andlighttheme colors.html<!-- Primary themeColor --> <div class="k-window k-dialog k-dialog-primary">...</div> <!-- Dark themeColor --> <div class="k-window k-dialog k-dialog-dark">...</div> <!-- Light themeColor --> <div class="k-window k-dialog k-dialog-light">...</div>
Editor
-
As of R1 2023 SP1, the Editor features an improved method to register custom tools. The main difference from the previous implementation is the substitution of the
ToolTemplateinstance with auiconfiguration object. An example of the new approach of registering tools is available in the knowledge-base article on creating custom Editor tools. -
The Editor no longer allows the use of togglable and non-togglable buttons in the same ButtonGroup of its ToolBar. If such a configuration is present, all buttons will be rendered as simple (non-togglable) buttons.
-
The
breakpseudo tool is no longer needed for separating tools from the same logical group. To display such tools separately, place them in separate arrays in thetoolsconfiguration:<textarea id="editor" rows="10" cols="30" style="width:100%; height: 440px;"></textarea> $("#editor").kendoEditor({ tools: [ ["bold"], ["italic"], ["underline"], ["strikethrough"] ] });You can also group multiple tools in a group by following the same approach:
<textarea id="editor" rows="10" cols="30" style="width:100%; height: 440px;"></textarea> $("#editor").kendoEditor({ tools: [ ["bold", "italic"], ["underline", "strikethrough"] ] }); -
The
tableelement has been replaced with a<div>element. -
The toolbar is no longer wrapped inside the
.k-editor-toolbar-wrapelement. -
The toolbar is no longer a
<ul>with<li>elements, but a Toolbar component. -
The
.k-editor-toolbarclass is now added to the toolbar. -
The
.k-resizableclass has been replaced with the.k-editor-resizableone.
Editor Popup
- Instead of the Dialog component, all Editor popups now use the Window.
- The
.k-editor-windowhas been added to all popups. - All inputs in popups have been replaced with the TextBox, NumericTextBox, and other respective components.
- Instead of the
.k-edit-form-container,.k-edit-form-content,.k-edit-label classes, and similar classe, the Form component is now used inside the popups. - Action buttons have been moved outside the form.
- The
.k-editor-table-wizard-dialogclass has been replaced with the.k-editor-table-wizard-windowclass.
Calendar and MultiViewCalendar
-
The text of the title buttons is now wrapped in a
<span>element with the.k-button-textclass. -
The navigation classes have been replaced as follows:
jsk-nav-today k-calendar-nav-today k-nav-prev k-calendar-nav-prev k-nav-next k-calendar-nav-next k-nav-fast k-calendar-nav-today k-prev-view k-calendar-nav-prev k-next-view k-calendar-nav-next
Kendo UI 2023 R1
ToolBar
-
As of the R1 2023 release, the tools in the ToolBar are actual component instances instead of ToolBar items. As a result, the
clickandtoggleevent argument objects no longer hold a reference to the ToolBar item (e.item). From that release on, the component instance of the tool can be taken by using thekendo.widgetInstance()method. When rendered in theOverflowMenuor the popup of a DropDownButton or a SplitButton those tools are menu items. Hence, they are not Kendo UI controls. A reference to the jQuery elements is still available in those cases in thee.targetevent argument.html<div id="toolbar"></div> <script> $("#toolbar").kendoToolBar({ items: [ { type: "button", id: "btn1", text: "Button 1", togglable: true }, { type: "button", id: "btn2", text: "Button 2" } ], click: function(e) { console.log("click:"); console.log(kendo.widgetInstance(e.target)); }, toggle: function(e) { console.log("toggle: ", e.checked); console.log(kendo.widgetInstance(e.target)); } }); </script> -
The ToolBar buttons will always be rendered as
<button>elements (instead of<a>) unless they have aurlconfigured in their options. If aurlis present, those will be rendered as links (<a>). -
The ToolBar no longer requires you to register its custom tools. To explore the new simplified way of defining custom tools in the ToolBar, refer to the article about the custom tools of the ToolBar.
-
The ToolBar won't allow you to use togglable and non-togglable buttons in the same ButtonGroup. If such a configuration is present, all buttons will be rendered and behave as simple (non-togglable) buttons.
-
The ToolBar Overflow menu will open upon each of its button clicks. That is the behavior of the ContextMenu component used in that scenario.