2016 Releases
This article lists the breaking changes in the Kendo UI 2016 releases.
Kendo UI 2016 R3
AutoComplete
In AngularJS, the usage of the separator
option binds the primitive string value of the input. To bind multiple data items, consider the MultiSelect widget.
Icons
Icon rendering across all widgets now have unified rendering, using the k-i-
prefix. Code depending on icon classes might need to change.
DropDownList
The widget will clear the applied filter when
ESC
key is pressed.The widget will not select the focused item on
focusout
when the list is filtered.
DropDownList/ComboBox/MultiSelect
The widget will not update the OPTION selected
attribute to keep the behavior of the defaultSelected
property. For more information, refer to this Github issue.
MultiSelect
The widget with a single
tag mode will deselect all selected items on Backspace
or Delete
keyboard press. The previous behavior is impossible to revert.
DropDownList/ComboBox
The widget will not bind on open
if autoBind
is set to false
and minLength
is set to a value higher than 1
.
Validator
The email validation rule has been changed to match the HTML5 specification suggests for browsers to use. If the previous behavior is required, the email validation rule should be overridden by specifying a custom rule with the email
key.
Chart
100% stacked series will be clipped by default. See the related issue for a discussion. To revert to the previous behavior, disable clipping on the pane:
$("#chart").kendoChart({
...
panes: [{
clip: false
}]
});
Scheduler
The widget will use the ,
separator for the recurrenceException
values to conform the RFC5545 specs. More details can be found in this forum thread.
Kendo UI 2016 R2
Scheduler
The widget will keep the selection state on blur
. The change was introduced to behave similarly to the Kendo UI Grid. To bring the old behavior back, use the select
method to clear the selection on blur
.
Kendo UI 2016 Q1
Grunt was replaced with Gulp as the preferred build tool for Kendo UI. From now on, the Gruntfile.js
file is replaced with Gulpfile.js
as part of the Kendo UI distribution.
DropDownList/ComboBox/MultiSelect
The widget will clear the applied filter if the user decides to set a new value using the value
method.
DropDownList/ComboBox
The cascading widget will trigger the change
event when its value is changed due to parent update. The benefit of this change is the proper behavior achieved in MVVM-like frameworks (related issue).
DropDownList
The widget will not select the first item automatically when the data source is changed with the setDataSource
method. To mimic the old behavior, manually select the first item:
var dropdownlist = $({widget id}).data("kendoDropDownList");
dropdownlist.setDataSource(["Item1", "Item2"]);
dropdownlist.select(0); //force selection of the first item
Remove support for Globalize 0.1
For more information, refer to issue 1354. To revert to the previous behavior, add the code from this Gist after the Kendo UI scripts.
Chart
The CategoryAxis max
and the plotbands to
values for non-justified axis no longer refer to the category end but to the category start. For example, limiting the displayed categories to January 1 and January 2:
<div id="chart"></div>
<script>
$("#chart").kendoChart({
categoryAxis: {
categories: [new Date(2016, 0, 1), new Date(2016, 0, 3)],
justified: false,
max: new Date(2016, 0, 2)
}
});
</script>
<div id="chart"></div>
<script>
$("#chart").kendoChart({
categoryAxis: {
categories: [new Date(2016, 0, 1), new Date(2016, 0, 3)],
justified: false,
max: new Date(2016, 0, 3)
}
});
</script>
The Grid, Gantt, TreeList, Scheduler, Toolbar, and Spreadsheet widgets will use the native click
event for taps on desktop environments. Previously, the mouseup
event was utilized. For more details and means to revert that behavior, refer to this issue.