# Breaking Changes in 17.0.0

> Some of the following changes can be migrated with the KendoReact codemods. For more information, see [Available Codemods](https://www.telerik.com/kendo-react-ui/components/migration/available-codemods#kendoreact-v16-0-0-to-v17-0-0).

## Buttons

* The custom-content `startIcon` and `endIcon` properties of the `Button`, `DropDownButton`, and `SplitButton` are renamed to `prefix` and `suffix`, respectively. The `SmartPasteButton` inherits the same change from `ButtonProps`. Preserve your React content when renaming these props.
* `endIcon` now accepts a font icon name (`string`) instead of arbitrary React content. To render a custom trailing element, use `suffix`; to render a trailing SVG icon, use the new `endSvgIcon` property.
* The `SplitButton` component has been converted to a functional component. Its `ref` now exposes a [`SplitButtonHandle`](https://www.telerik.com/kendo-react-ui/components/buttons/api/splitbuttonhandle) with only `element` and `props`; class instance members and methods are no longer available through the `ref`. Type refs as `SplitButtonHandle` instead of the former class instance type. The Buttons v17 codemod migrates `SplitButton` and `SplitButtonClassComponent` ref type references.

## Map

* The `Map` component has been converted to a functional component. Its `ref` and the `target` of every Map event (`BeforeResetEvent`, `MapClickEvent`, `MarkerActivateEvent`, `MarkerClickEvent`, `MarkerCreatedEvent`, `PanEndEvent`, `PanEvent`, `ResetEvent`, `ShapeClickEvent`, `ShapeCreatedEvent`, `ShapeFeatureCreatedEvent`, `ShapeMouseEnterEvent`, `ShapeMouseLeaveEvent`, `ZoomEndEvent`, and `ZoomStartEvent`) are now a `MapHandle`. Type a Map `ref` as `MapHandle`.
* `MapHandle` exposes `element`, `props`, `mapInstance`, `layers`, `extent`, `resize`, `viewSize`, `eventOffset`, `eventToLayer`, `eventToLocation`, `eventToView`, `layerToLocation`, `locationToLayer`, `locationToView`, `viewToLocation`, and `loadMarkers`. The React class members (`state`, `setState`, `forceUpdate`, `context`, `refs`) and the internal methods (`refresh`, `trigger`, `getMapOptions`, `instantiateCoreMap`, `requiresHandlers`) are no longer available.
* The `element` property of the Map `ref` is now typed as `HTMLDivElement | null` instead of `HTMLDivElement`.

## Scheduler

* `SchedulerFormEditor.recurrenceButtonTextTemplate` and `RecurrenceButtonTextTemplateProps` are deprecated. The template is ignored: the recurrence button now uses the localized **Make recurring** and **Edit recurrence** labels. Use `recurrenceSummaryTemplate` and `RecurrenceSummaryTemplateProps` to customize the summary below the button and inside the recurrence dialog. The summary template is called only when a recurrence rule exists, and its props are no longer nullable. The v17 recurrence template codemod migrates these names; review custom templates for the changed placement and invocation.
* The `Scheduler` has a new `eventOverview` property that is enabled by default. Clicking an event, or pressing `Enter` on a focused event, now opens an overview popover with **Edit** and **Delete** actions instead of selecting the event only (with `Enter`, instead of opening the edit form). Recurring events offer occurrence and series options. Double-clicking an event still opens the edit form. Set `eventOverview={false}` to restore the previous behavior.
* The `Scheduler` has a new `quickCreate` property that is enabled by default. When `editable.add` is enabled, clicking an empty slot, or pressing `Enter` on a focused slot, now opens a popover with a title input and a **More options** action that opens the full edit form. The quick-create popover is not available in the `AgendaView`. Use the new `quickCreateForm` property and the `SchedulerQuickCreateForm` component to customize it. Set `quickCreate={false}` to restore the previous behavior.
* The overview and quick-create popovers open approximately 200 ms after a click so that a double click can still open the full edit form. Tests that click an event or a slot and immediately assert the popover need to wait for it.
* Cancelling or closing a `SchedulerForm` with modified values now shows a `DiscardChangesDialog` that asks for confirmation instead of closing the form immediately.
* Editing or removing the master event of a recurring series with custom exceptions now shows a `KeepResetCustomEventsDialog`. When the series is edited, resetting removes the exceptions and reports them in the `deleted` collection of `onDataChange`, while keeping them leaves them linked to the series. When the series is removed, resetting reports the exceptions in the `deleted` collection and keeping converts them to standalone events reported in the `updated` collection. Review `onDataChange` handlers that do not expect these additional items.
* In `DayView`, `WeekView`, and `WorkWeekView`, timed events that span multiple days now appear in the all-day row with start and end times. Review custom `viewItem` renderers, styling, or DOM queries that assume these events render in the timed grid. For the updated markup and classes, see [Scheduler rendering changes](https://www.telerik.com/kendo-react-ui/components/updates/rendering-changes/17-0-0#scheduler).

## Sortable

* The `Sortable` component has been converted to a functional component. `Sortable` is no longer a type. When using a `ref`, type it as `SortableHandle` instead of the class instance type `Sortable`.
* `SortableHandle` exposes only `element` and `props`. The React class members (`state`, `setState`, `forceUpdate`) and the internal methods of the class component are no longer available through the `ref` or the event `target`.
* `SortableOnDragStartEvent`, `SortableOnDragOverEvent`, `SortableOnDragEndEvent`, and `SortableOnNavigateEvent` have been converted from classes to interfaces. They can no longer be created with `new`, checked with `instanceof`, or extended by a class. Their `target` property is now a `SortableHandle`.

## TreeView

* Custom components passed through the `item` property no longer render inside a `.k-treeview-leaf-text` wrapper. Review custom item styling and DOM queries that depend on this wrapper. Default item rendering is unchanged. For details, see the [TreeView rendering changes](https://www.telerik.com/kendo-react-ui/components/updates/rendering-changes/17-0-0#treeview).
