Skip to content

Commit 7362104

Browse files
committed
chore(breaking-changes): add upcoming article with breaking changes
1 parent ac8b081 commit 7362104

File tree

1 file changed

+44
-0
lines changed

1 file changed

+44
-0
lines changed

upgrade/breaking-changes/3-0-0.md

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
---
2+
title: 3.0.0
3+
description: Handle the changes in the 3.0.0 release of the Telerik UI for Blazor components.
4+
page_title: Breaking Changes in 3.0.0
5+
slug: changes-in-3.0.0
6+
position: 1
7+
---
8+
9+
# Upcoming Breaking Changes in 3.0.0
10+
11+
> The 3.0.0 release will be shipped in mid January. The following list of breaking changes will be updated with detailed explanation how to migrate your project.
12+
13+
## Component Changes
14+
15+
- TileLayout - Introduce identifier of the TileLayout item. OnResize and OnReorder events will receive EventArgs that will point to the item that has been resized/reordered. This items comes from our [user voice](https://feedback.telerik.com/blazor/1489011)
16+
- TreeView - add `ExpandedItems` parameter to remove `ExpandedField`
17+
- Grid – change `OnRead` method to return the `Data`
18+
- Grid – use `IFilterDescriptor` in GridState instead of `FilterDescriptorBase`
19+
- DateInput – remove `ParsingErrorMessage` in favor of localization string for the error message
20+
- ContextMenu – add EventArgs to the OnClick event
21+
- All input elements – remove hardcoded width style in our Blazor components. In addition, the default style that comes from the themes will be updated to change the width to 100%.
22+
23+
We are still designing changes in terms of editing by going through customer feedback. So, there might be changes coming from this direction as well.
24+
25+
## Common Changes
26+
27+
- `IconName` class will be removed. All icon names should be retrieved from documentation.
28+
- `ToODataString` extension method is moved to `Telerik.Blazor.Extensions` namespace.
29+
30+
## Parameter Naming
31+
32+
We have revised our code base and found several inconsistencies that need to be fixed in order to facilitate our customers where to look for similar
33+
34+
- `UpdateInterval` Parameter of Editor is changed to `DebounceDelay`
35+
- `Content` RenderFragment Parameter of the Drawer is changed to `DrawerContent`
36+
- `IsCanceled` Parameter in StepperStepChangeEventArgs is renamed to `IsCancelled`
37+
- `IsSeparatorField` is removed in favor of `SeparatorField`
38+
39+
## Rendering & Themes
40+
41+
- `k-widget` class is removed from the components
42+
- `width:100%` is the new default width of all components instead of `12.5em`
43+
- Html classes and dom elements hierarchy will be updated for Buttons, Inputs, Selects, DatePickers Checkbox, Switch.
44+
- `k-state-focused` is renamed to `k-focus`

0 commit comments

Comments
 (0)