Upgrade / Breaking Changes

New to Telerik UI for Blazor? Download free 30-day trial

Breaking Changes in 4.0.0

Common Changes

This section applies to changes to multiple components.

Icons

Some built-in icons have been renamed. See the full list of changes in article New Icon Names in Telerik UI for Blazor 4.0.

Icon

The Icon parameter type changes from string to object to facilitate the addition of Telerik Font and Svg Icons.

To use built-in Telerik icons, register the new icon namespaces - Telerik.FontIcons and/or Telerik.SvgIcons.

To define custom icon classes inline, use Icon="@( "my-icon-class" )".

To use Telerik font icons with UI for Blazor 4.6.0 and above, register font-icons.css.

UI for Blazor 3.7.0 UI for Blazor 4.0.0 

<TelerikButton Icon="save"> Font Icon Button </TelerikButton>

<GridCommandButton Icon="save"> Font Icon Command Button </GridCommandButton>

<TelerikButton IconClass="fa fa-foo"> Custom Icon Button </TelerikButton>


<TelerikButton Icon="@SvgIcon.Save"> SVG Icon Button </TelerikButton>

<GridCommandButton Icon="@SvgIcon.Save"> SVG Icon Command Button </GridCommandButton>

<TelerikButton Icon="@( "fa fa-foo" )"> Custom Icon Button </TelerikButton>

ImageUrl

Removed the ImageUrl parameter, use the Icon parameter instead.

List of affected components:

IconClass

Removed the IconClass parameter, use the Icon parameter instead.

List of affected components:

SpriteClass

Removed the SpriteClass parameter, use the Icon parameter instead.

List of affected components:

Shape Parameter

Removed the Shape parameter from:

Stretched enum Value

Stretched enum value in UI for Blazor up to version 3.7.0 and after version 4.0.0

UI for Blazor 3.7.0 UI for Blazor 4.0.0 

<CardActions Layout="@CardActionsLayout.Stretched />


<CardActions Layout="@CardActionsLayout.Stretch" />


<TelerikDialog ButtonsLayout="@DialogButtonsLayout.Stretched" />


<TelerikDialog ButtonsLayout="@DialogButtonsLayout.Stretch" />


<GridPopupEditFormSettings ButtonsLayout="FormButtonsLayout.Stretched" />


<GridPopupEditFormSettings ButtonsLayout="FormButtonsLayout.Stretch" />


<SchedulerPopupEditFormSettings ButtonsLayout="FormButtonsLayout.Stretched" />


<SchedulerPopupEditFormSettings ButtonsLayout="FormButtonsLayout.Stretch" />


<TreeListPopupEditFormSettings ButtonsLayout="FormButtonsLayout.Stretched" />


<TreeListPopupEditFormSettings ButtonsLayout="FormButtonsLayout.Stretch" />

Async Method Suffix

Added an Async suffix to the name of asynchronous methods.

Method signatures in UI for Blazor up to version 3.7.0 and after version 4.0.0

UI for Blazor 3.7.0 UI for Blazor 4.0.0 

private TelerikGrid GridRef { get; set; }
// ...
await GridRef.SetState(desiredState);


private TelerikGrid GridRef { get; set; }
// ...
await GridRef.SetStateAsync(desiredState);


private TelerikTreeList TreeListRef { get; set; }
// ...
await TreeListRef.SetState(desiredState);


private TelerikTreeList TreeListRef { get; set; }
// ...
await TreeListRef.SetStateAsync(desiredState);

Component Changes

This section describes changes per component.

Button

  • Renamed the Hidden parameter to Visible.

Visible parameter in UI for Blazor up to version 3.7.0 and after version 4.0.0

UI for Blazor 3.7.0 UI for Blazor 4.0.0 

<TelerikButton Hidden="false"> Visible button <TelerikButton />


<TelerikButton Visible="true"> Visible button <TelerikButton />
  • Removed the OnTimerTick method.

Drawer

  • Changed the values in the DrawerPosition enum from Left and Right to Start and End.

DrawerPosition enum values in UI for Blazor up to version 3.7.0 and after version 4.0.0

UI for Blazor 3.7.0 UI for Blazor 4.0.0 

<TelerikDrawer Position="@DrawerPosition.Left">
<TelerikDrawer Position="@DrawerPosition.Right">


<TelerikDrawer Position="@DrawerPosition.Start">
<TelerikDrawer Position="@DrawerPosition.End">
  • Removed the DefaultItem parameter, use the DefaultText parameter instead.

Form

  • The Form columns can have different widths

Gantt

  • Renamed <GanttToolBar> to <GanttToolBarTemplate>.

Grid

  • FilterRow uses CompositeFilterDescriptor instead of FilterDescriptor.
  • Removed default filter descriptors in the state when the Grid FilterMode is set to FilterMenu.
  • Removed the Primary parameter from <GridCommandButton>. Use the ThemeColor parameter instead.
  • Removed ExcelExportableColumn in favor of GridExcelExportColumn for Excel export and GridCsvExportColumn for CSV export.
  • The successor of ExcelExportableColumn for CSV export(GridCsvExportColumn) does not have NumberFormat and Width.
  • Renamed <GridToolBar> to <GridToolBarTemplate>.

MaskedTextBox

  • Changed the signature of the PlaceHolder parameter to Placeholder.

Placeholder parameter in UI for Blazor up to version 3.7.0 and after version 4.0.0

UI for Blazor 3.7.0 UI for Blazor 4.0.0 

<TelerikMaskedTextBox PlaceHolder="The placeholder text" />


<TelerikMaskedTextBox Placeholder="The placeholder text" />

TextArea

  • Changed the signature of the PlaceHolder parameter to Placeholder.

Placeholder parameter in UI for Blazor up to version 3.7.0 and after version 4.0.0

UI for Blazor 3.7.0 UI for Blazor 4.0.0 

<TelerikTextArea PlaceHolder="The placeholder text" />


<TelerikTextArea Placeholder="The placeholder text" />

TextBox

  • Changed the signature of the PlaceHolder parameter to Placeholder.

Placeholder parameter in UI for Blazor up to version 3.7.0 and after version 4.0.0

UI for Blazor 3.7.0 UI for Blazor 4.0.0 

<TelerikTextBox PlaceHolder="The placeholder text" />


<TelerikTextBox Placeholder="The placeholder text" />

Toolbar

  • Changed the default value of the Adaptive parameter from false to true.

TreeList

  • Removed default filter descriptors in the state when the TreeList FilterMode is set to FilterMenu.
  • Removed Primary parameter from the <TreeListCommandButton>.
  • Renamed the <TreeListToolBar> to <TreeListToolBarTemplate>.
In this article
Related articles
Not finding the help you need? Improve this article