Breaking changes

• jQuery is updated to 1.9.1.
• Mobile: Rename scrollTreshold option of the ListView to scrollThreshold.
• AutoComplete/ComboBox/DropDownList: Rename enable option to enabled.
• TreeView/HierarchicalDataSource/Node: The children field is initialized depending on the hasChildren field, as previously documented. Use the append and load methods to initialize it, and if accessing the children field directly, verify if it is present.

ASP.NET MVC

Some ASP.NET MVC applications may be broken if using other libraries incompatible with jQuery 1.9.1. Further details available in the troubleshooting guide

Breaking changes

• Cascading ComboBoxes/DropDownLists: The parameterMap of the child widget's dataSource is called before the change event of the parent widget. Use cascade event instead of change event.

• Kendo UI Complete for ASP.NET MVC: Remove Slide effect. Use SlideIn instead.

Breaking changes

• Mobile: the kendoMobileSwipe plugin is obsolete - replace its usage with the touch widget.

• Mobile: WebKit mask icons are now deprecated and font icons are used instead. If you have custom icons, they might break after the upgrade. Add the following CSS rule to fix them /if you have data-icon="custom" on them, or use .km-icon to remove all non-custom icons/:

  .km-root .km-pane .km-view .km-custom {
      background-size: 100% 100%;
      -webkit-background-clip: border-box;
      background-color: currentcolor;
  }
  
  
  .km-root .km-pane .km-view .km-custom:after,
  .km-root .km-pane .km-view .km-custom:before
  {
      visibility: hidden;
  }
  

Additionally it should be noted that the mask icons used background-color for colorization, while the font ones use color and custom colorization (but not on custom icons) should be updated after the upgrade. For example a rule like this:

    .km-ios .km-tabstrip .km-icon {
        background-color: rgb(20, 30, 40);
    }

should be changed to this:

    .km-ios .km-tabstrip .km-icon {
        color: rgb(20, 30, 40);
    }

• DataViz: Widgets now require theme-specific stylesheets. For example:

  <link href="styles/kendo.dataviz.min.css" rel="stylesheet" />
  

if using the Default skin, should be updated to:

    <link href="styles/kendo.dataviz.min.css" rel="stylesheet" />
    <link href="styles/kendo.dataviz.default.min.css" rel="stylesheet" />

• DataViz: missingValues defaults to "zero" for area, stacked area and stacked line series. The previous default was "gap" which can lead to incorrect results.

Breaking changes

• All Widgets: All arrows have been renamed to better reflect their direction and size. For instance:

  • Old

    .k-arrow-up
    .k-arrow-next
    .k-arrow-down
    .k-arrow-prev
    .k-arrow-first
    .k-arrow-last
    

  • New

    .k-i-arrow-n
    .k-i-arrow-e
    .k-i-arrow-s
    .k-i-arrow-w
    .k-i-seek-w
    .k-i-seek-e
    

    for more information check the Styling Icons demo.

• Popup: Popup based widgets nested in other Popup based widgets create their Popup container inside the Popup parent. This means that a DropDownList created inside an already initialized Menu will create its list inside the Menu item's parent Popup.

• TreeView: The TreeView widget now depends on kendo.data.js

• TreeView: Using the API methods will re-create the HTML of the nodes. In order to get the new reference to the nodes, use the return value of the methods.

  • Old

    var foo = treeviewObject.findByText("foo");
    treeviewObject.append(foo);
    // starting with 2012 Q2, foo will point to a DOM node that is removed from the document
    foo.text("bar: foo");
    

  • New

    var foo = treeviewObject.findByText("foo");
    foo = treeviewObject.append(foo);
    foo.text("bar: foo");
    

• DataViz: Refresh() no longer invokes Read() of the DataSource.

  • Old

    var chart = $("#chart").data("kendoChart");
    chart.refresh();
    

  • New

    var chart = $("#chart").data("kendoChart");
    chart.dataSource.read();
    

Breaking changes

• Data: kendo.model.js file has been removed. The content of kendo.model.js file has been consolidated with the kendo.data.js content.

• Data:Model.id is no longer a function. It is a field.

  • Old

    var model = dataSource.get(42);
    var modelId = model.id(); //42
    

  • New

    var model = dataSource.get(42);
    var modelId = model.id; //42
    

• Data: The DataSource contains ObservableObject instances instead of raw JavaScript objects.

• Grid: The Grid widget is now using the uid field of the Model instead of the id. A new uid field is introduced to the DataSource's Model, which represents its unique id. The Grid row data attribute has been changed to use this field. Note that in order to retrieve Model instance by its uid, DataSource's getByUid method should be used.

  • Old

    <tr data-id="42"><!--...--></tr>
    

  • New

    <tr data-uid=”aaaaa-bbbbb-ddddd-gggg”><!--...--></tr>
    

• DataViz: The kendo.chart(.min).js file is replaced by kendo.dataviz(.min).js

• DataViz: The axis orientation property deprecated in favor of dedicated verticalLine and verticalArea chart types
• DataViz: The suite now requires kendo.dataviz.css to be included
• DataViz: The Chart widget is now in the kendo.dataviz.ui namespace. Previously it was part of kendo.ui

• Other:dataValueField and dataTextField of DropDownList, ComboBox and AutoComplete, are set to empty string by default. In order to get your old code working, you will need to list the fields manually, like this:

  • Old

    $("#combobox").kendoComboBox([
        {text: "Item 1", value: "item1"},
        {text: "Item 2", value: "item2"}
    ]);
    

  • New

    $("#combobox").kendoComboBox({
        dataTextField: "text",
        dataValueField: "value",
        dataSource: [
            {text: "Item 1", value: "item1"},
            {text: "Item 2", value: "item2"}
        ]
    });