Ignite UI for Blazor Changelog
All notable changes for each version of Ignite UI for Blazor are documented on this page.
- As of version 2024.2, the Ignite UI for Blazor toolset supports .NET 9. For more information on .NET 9 please refer to this article on Microsoft's site.
25.1.82 (September 2025)
IgniteUI.Blazor (Geographic Map)
Breaking Changes
AzureMapsMapImagerywas renamed toIgbAzureMapsImageryAzureMapsImageryStyle.Imagerywas renamed toAzureMapsImageryStyle.Satellite- The following
AzureMapsImageryStyleenum values were renamed to include the Overlay suffix:TerraOverlay,LabelsRoadOverlayLabelsDarkGreyOverlayHybridRoadOverlayHybridDarkGreyOverlayWeatherRadarOverlayWeatherInfraredOverlayTrafficAbsoluteOverlayTrafficRelativeOverlayTrafficRelativeDarkOverlayTrafficDelayOverlayTrafficReducedOverlay
IgniteUI.Blazor (Charts)
New Axis Label Events
The following events have been added to the DataChart to allow you to detect different operations on the axis labels:
LabelMouseDownLabelMouseUpLabelMouseEnterLabelMouseLeaveLabelMouseMoveLabelMouseClick
Companion Axis
Added CompanionAxis properties to the X and Y axis that allow you to quickly create a clone of an existing axis. When enabled using the CompanionAxisEnabled property, this will default the cloned axis to the opposite position of the chart and you can then configure that axes' properties.
RadialPieSeries Inset Outlines
There is a new property called UseInsetOutlines to control how outlines on the IgbRadialPieSeries are rendered. Setting this value to true will inset the outlines within the slice shape, whereas a false (default) value will place the outlines half-in half-out along the edge of the slice shape.
Breaking Changes
- A fix was made due to an issue where the
PlotAreaPositionandChartPositionproperties onIgbChartMouseEventArgsclass were reversed. This will change the values thatPlotAreaPositionandChartPositionreturn.
IgniteUI.Blazor (Grids)
Cell Suffix Content
Added support for suffix content within the cells that allows you to add additional text or icons to the end of the cell value and style it. The full list of added properties for the cell suffix content is listed below and is available on the IgbDataGridColumn and CellInfo class:
SuffixTextSuffixTextColorSuffixTextFontSuffixIconNameSuffixIconCollectionNameSuffixIconStrokeSuffixIconFillSuffixIconViewBoxLeftSuffixIconViewBoxTopSuffixIconViewBoxWidthSuffixIconViewBoxHeightTextDecoration
Please note that the maximum size available for the icons is 24x24. You can provide an icon that is larger or smaller than this, but you will need to configure the viewbox settings in order to properly scale it to fit in the 24x24 space so it is fully visible.
Bug Fixes
| Bug Number | Control | Description |
|---|---|---|
| 27304 | IgbDataChart | Zoom rectangle is not positioned the same as the background rectangle |
| 30600 | IgbDoughnutChart | No textStyle property for either the chart or series (pie chart has this) |
| 31624 | IgbCategoryChart | Resizing the containing window of the IgxCategoryChart causes the chart to fail to render the series |
| 33861 | Excel Library | Adding line chart corrupts excel File for German culture |
| 37307 | IgbCheckBox | JS Heap, Nodes, and Listeners leakage on IgbCheckBox |
| 37930 | IgbDataChart | Data Annotation Overlay Text Color not working |
| 38231 | IgbGrid | Unpinned column does not return to the original position if hidden columns exist |
Enhancements
IgbBulletGraph
- Added new
LabelsVisibleproperty
Charts
New properties added to the DataToolTipLayer, ItemToolTipLayer, and CategoryToolTipLayer to aid in styling:
ToolTipBackground,ToolTipBorderBrush, andToolTipBorderThicknessNew properties added to the DataLegend to aid in styling:
ContentBackground,ContentBorderBrush, andContentBorderThickness. TheContentBorderBrushandContentBorderThicknessdefault to transparent and 0 respectively, so in order to see these borders, you will need to set these properties.Added a new property to
IgbChartMouseEventArgscalledWorldPositionthat provides the world relative position of the mouse. This position will be a value between 0 and 1 for both the X and Y axis within the axis space.Added
HighlightingFadeOpacitytoIgbSeriesViewerandIgbDomainChart. This allows you to configure the opacity applied to highlighted series.
IgbDataGrid
- Added new property called
stopPropagationto DataGrid which prevents mouse events from bubbling to parent elements
IgbLinearGauge
- Added new
LabelsVisibleproperty
25.1.63 (August 2025)
IgniteUI.Blazor (Geographic Map)
Azure Map Imagery Support
The GeographicMap now supports Azure-based map imagery, allowing developers to display detailed, dynamic maps across multiple application types. You can combine multiple map layers, visualize geographic data, and create interactive mapping experiences with ease.
Note: Support for Bing Maps imagery is being phased out. Existing enterprise keys can still be used to access Bing Maps, ensuring your current applications continue to function while you transition to Azure maps.
Explore some of the publicly available Azure maps here.
Bug Fixes
| Bug Number | Control | Description |
|---|---|---|
| 26952 | IgbTabs | e.Detail is null in Change event in Razor/JS |
| 26953 | IgbTabs | Marking a tab selected won't apply on subsequent attempts |
| 31910 | IgbXDatePicker | An error will happen when I bind a value using the "@bind-Value" syntax and click the clear button |
| 31323 | IgbDataChart, IgbGrid, IgbCombo | A NullReferenceException happens when the data type has a collection-type property, and the 1st element of that collection is null |
| 38903 | IgbTabs | Dropdown list is not displaying in the correct location for components inside the tab |
| 139 | IgbDatePicker, IgbDateTimeInput | Date picker and data time input do not support nullable values |
General
The following properties of these components are now nullable:
IgbButton:FormIgbCalendar:SpecialDates,DisabledDatesIgbCombo:ValueKey,DisplayKey,GroupKeyDatePicker:Value,Min,MaxDateTimePicker:Value,Min,MaxIgbDropdown:SelectedItemIgbInput:Pattern,MinLength,MaxLength,Min,Max,StepSelect:Value,SelectedItemIgbTile:ColStart,RowStartIgbTileManager:MinColumnWidth,MinRowHeight,Gap
25.1.46 (July 2025)
Bug Fixes
| Bug Number | Control | Description |
|---|---|---|
| 36448 | IgbRadialGauge | Radial label format properties do not work. (eg. Title, SubTitles) |
| 37718 | IgbTab | Unexpected scrolling occurred when a new row was added to a grid that is in a tab panel |
| 37855 | IgbGrid | Crypto.randomUID not found error is thrown if a grid contains HeaderTemplate and the page is accessed using unsecured(http) protocol |
IgniteUI.Blazor (Charts)
- Added
MaximumExtentandMaximumExtentPercentageproperties for use with axis labels.
25.1.19 (June 2025)
IgniteUI.Blazor (Geographic Map)
[!Note] As of June 30, 2025 all Microsoft Bing Maps for Enterprise Basic (Free) accounts will be retired. If you're still using an unpaid Basic Account and key, now is the time to act to avoid service disruptions. Bing Maps for Enterprise license holders can continue to use Bing Maps in their applications until June 30,2028. For more details please visit:
IgniteUI.Blazor (Charts)
Added Chart Data Annotations layers:
- Data Annotation Band Layer
- Data Annotation Line Layer
- Data Annotation Rect Layer
- Data Annotation Slice Layer
- Data Annotation Strip Layer
The Data Tooltip and Data Legend expose
LayoutModeproperty that you can use to layout the contents of the tooltip or legend in a table or vertical layout structure.The
DefaultInteractionproperty of the charts has been updated to include a new enumeration -DragSelectin which the dragged preview Rect will select the points contained within.The ValueOverlay and ValueLayer, in addition to the Chart Data Annotations listed above now expose an
OverlayTextproperty that can be used to overlay additional annotation text in the plot area. These appearance of these annotations can be configured by using the many OverlayText-prefixed properties. For example, theOverlayTextBrushproperty will configure the color of the overlay text.Trendline Layer series type that allows you to apply a single trend line per trend line layer to a particular series. This allows the usage of multiple trend lines on a single series since you can have multiple TrendlineLayer series types in the chart.
General
-
IgbTooltipcomponent provides a way to display a tooltip for a specific element. To use, set content as desired and link via theAnchorproperty to the target element's id:
The tooltip can be further customized with<IgbButton id="target-button">Hover me</IgbButton> <IgbTooltip Anchor="target-button"> You've hovered the button! 🎉 </IgbTooltip>Show/HideDelay,Placementaround the target and customizableShow/HideTriggersevents.
Changes
A number of enumerations have been renamed and/or merged with others. Renames (with affected components):
BaseAlertLikePosition(IgbSnackbarandIgbToast) has been renamed toAbsolutePositionButtonGroupAlignment(IgbButtonGroup),CalendarOrientation(IgbCalendar),CardActionsOrientation(IgbCardActions),DatePickerOrientation(DatePicker),RadioGroupAlignment(IgbRadioGroup) have been merged and renamed toContentOrientationCalendarBaseSelection(IgbCalendar) has been renamed toCalendarSelectionCarouselAnimationType(IgbCarousel) andStepperHorizontalAnimation(IgbStepper) have been merged and renamed toHorizontalTransitionAnimationCheckboxBaseLabelPosition(IgbCheckboxandIgbSwitch) andRadioLabelPosition(IgbRadio) have been merged and renamed toToggleLabelPositionDatePickerMode(DatePicker) has been renamed toPickerModeDatePickerHeaderOrientation(DatePicker) has been renamed to/merged withCalendarHeaderOrientationDropdownPlacement(IgbDropdownandSelect) has been renamed toPopoverPlacementDropdownScrollStrategy(IgbDropdown) andSelectScrollStrategy(Select) have been merged and renamed toPopoverScrollStrategySliderBaseTickOrientation(IgbSliderandIgbRangeSlider) has been renamed toSliderTickOrientationTickLabelRotation(IgbSliderandIgbRangeSlider) has been renamed toSliderTickLabelRotation
-
Simplified configuration by removing the need to define separate panel and linking the panel and tab header. The
Panelproperty and theTabPanelitself have been removed. Content can be now assigned directly to theIgbTaband header text can be set conveniently via the newLabelproperty or by projecting an element toslot="label"for more involved customization. Before:<IgbTabs Alignment=@TabAlignment> <IgbTab Panel="basics">Basics</IgbTab> <IgbTab Panel="details">Details</IgbTab> <IgbTab Panel="favorite"> <IgbIcon IconName="favorite" Collection="material"/> </IgbTab> <IgbTab Panel="disabled" Disabled=true>Disabled</IgbTab> <IgbTabPanel id="basics">Basics tab content</IgbTabPanel> <IgbTabPanel id="details">Details tab content</IgbTabPanel> <IgbTabPanel id="favorite">Favorite tab content</IgbTabPanel> <IgbTabPanel id="disabled">Disabled tab content will not be displayed</IgbTabPanel> </IgbTabs>After:
<IgbTabs Alignment=@TabAlignment> <IgbTab Label="Basics"> Basics tab content </IgbTab> <IgbTab Label="Details"> Details tab content </IgbTab> <IgbTab> <IgbIcon slot="label" IconName="favorite" Collection="material"/> Favorite tab content </IgbTab> <IgbTab Disabled="true" Label="Disabled"> Disabled tab content will not be displayed </IgbTab> </IgbTabs> -
ActiveStepChangingArgsEventArgshas been renamed toIgbActiveStepChangingEventArgsActiveStepChangedArgsEventArgshas been renamed toIgbActiveStepChangedEventArgsStepperTitlePositionnow defaults toAutoto correctly reflect the default behavior
-
TreeSelectionChangeEventArgshas been renamed toIgbTreeSelectionEventArgs
-
Autocapitalize&InputModeare nowstringproperties instead of explicit enums
IgniteUI.Blazor (Grids)
IgbColumn- Added events:
HiddenChange,ExpandedChange,WidthChange,PinnedChange
- Added events:
Grid- Added events:
GroupingExpressionsChange,GroupingExpansionStateChange
- Added events:
IgbRowIsland- Added new parameter
ParentRowDatainIgbGridCreatedEventArgsDetailargs forGridCreatedevent
- Added new parameter
Grid,IgbHierarchicalGrid,IgbTreeGrid- Added property -
ExpansionStates- represents a list of key-value pairs [row ID, expansion state]. - Added event:
ExpansionStatesChange - Type of
Renderedevent is changed fromVoidHandlertoComponentBoolValueChangedEventHandler - Type of DataChanging event is changed from
ForOfDataChangingEventHandlertoForOfDataChangeEventHandler - Type of DataChanged event is changed from
VoidHandlertoForOfDataChangeEventHandler
- Added property -
IgbPivotDataSelector- Added events:
ColumnsExpandedChange,RowsExpandedChange,FiltersExpandedChange,ValuesExpandedChange
- Added events:
IgniteUI.Blazor (Dashboards)
- The
DashboardTilenow supports propagating the aggregations from its DataGrid view to the chart visualization such as sorting, grouping, filtering and selection. This is currently supported by binding theDataSourceof theDashboardTileto an instance ofIgbLocalDataSource.
Enhancements
Toolbar
- Value layers added from the toolbar now appear on the legend.
- The zoom reset tool has been moved to the zoom drop-down.
Data Pie Chart
- The chart now exposes a
GetOthersContext()method. This will return the contents of the "others" slice.
Bug Fixes
| Bug Number | Control | Description |
|---|---|---|
| 25997 | IgbDataGrid | Summaries are only showing for first grouped child row |
| 37023 | IgbDataChart | Tooltips are cut-off/offscreen if overflow hidden is set. |
| 37244 | Excel | Custom Data Validation is not working |
24.2.122 (May 2025)
Bug Fixes
| Bug Number | Control | Description |
|---|---|---|
| 37271 | IgbHierarchicalGrid | ParentRowData included to IGridCreatedEventArgs |
| 37681 | IgbDataChart | Category Chart - values labels are should appear above columns when there is adequate space |
| 37244 | Excel | Custom Data Validation is not working |
24.2.111 (April 2025)
New Components
- IgbTileManager
Enhancements
List
- Added new property on
IgbListItemcalledSelected
Accordion
- Added new events
OpenandClose
IgniteUI.Blazor
- All Grids
- Allow applying initial filtering through
FilteringExpressionsTreeproperty
- Allow applying initial filtering through
Bug Fixes
| Bug Number | Control | Description |
|---|---|---|
| 25602 | IgbDataGrid | Loading a layout with one of the date-specific filter operators results in a TypeError console error |
| 28480 | IgbCombo | Undefined reference error is thrown when a datasource is replaced |
| 32598 | IgbDataGrid | Multiselection is not working correctly |
| 36374 | IgbInput | A previous value was bound when a form was submitted on any touch device |
| 37214 | General | Intermittent error in Blazor's WebCallback.Register() |
24.2.92 (March 2025)
IgniteUI.Blazor
- All Grids
- Added new
DisabledSummariesfor the columns of the grid, allowing the developers to skip some of the summaries - Encapsulate internal grid action button
- Added new
Bug Fixes
| Bug Number | Control | Description |
|---|---|---|
| 35497 | IgbDialog | When ShowAsync and HideAsync Are Called, the Subsequent Code Is Not Executed |
24.2.85 (February 2025)
Enhancements
Toolbar
- Added new
GroupHeaderTextStyleproperty toToolbarandIgbToolPanel. If set, it will apply to allIgbToolActionGroupHeaderactions. - Added new property on
IgbToolActioncalledTitleHorizontalAlignmentwhich controls the horizontal alignment of the title text. - Added new property on
IgbToolActionSubPanelcalledItemSpacingwhich controls the spacing between items inside the panel.
Bug Fixes
The following table lists the bug fixes made for the Ignite UI for Blazor toolset for this release:
| Bug Number | Control | Description |
|---|---|---|
| 26218 | Excel Library | Chart's plot area right margin becomes narrower and fill pattern and fill foreground are gone just by loading an Excel file |
| 29998 | IgbCombo | The Change event callback was fired multiple times in .NET 8 |
| 30286 | IgbDataChart | Bubble Series tooltip content is switched to that of nearby bubble data in clicking a bubble |
| 31344 | IgbGrid | Two way binding for the SelectedRows doesn't work |
| 32906 | IgbDataChart | IgbDataChart is showing two xAxis on the top |
| 33605 | IgbDataChart | ScatterLineSeries is not showing the color of the line correctly in the legend |
| 34053 | IgbRadialGauge | The position of the scale label is shifted |
| 34083 | Excel Library | TextOperatorConditionalFormat's is not loaded/saved properly if the text contains = in a template Excel file |
| 34149 | IgbGrid | Repeatedly showing and hiding the IgbGrid causes memory leakage in JS Heap |
| 34224 | IgbGrid | 'There are multiple .NET runtimes present' error is thrown when the app changes from Server mode to WebAssembly mode if 'InteractiveAuto' is used for the rendermode |
| 34654 | IgbGrid | NullReferenceException is thrown if a data contains an empty list |
| 34776 | IgbDataChart | Repeatedly showing and hiding the IgbDataChart causes memory leakage in JS Heap |
| 35439 | IgbGrid | CPU usage and Memory consumption are abnormally high when the app is opened in multiple tabs |
| 35495 | Excel Library | Pictures in cells are lost when a template file is loaded |
| 35498 | IgbDataChart | Tooltips for the series specified in IncludedSeries are not displayed |
| 36024 | IgbGrid | The JS heap size never reduced when moving back and forth between two pages with IgbGrid component |
| 36176 | Excel Library | Exception occurs when loading an Excel workbook that has a LET function |
| 36379 | Excel Library | Colors with any alpha channel in an excel workbook fail to load |
24.2.71 (January 2025)
- Bug Fixes
IgniteUI.Blazor
- All Grids
- Fixed a critical memory leak when components are opened in several duplicate browser tabs.
24.2.52 (December 2024)
IgniteUI.Blazor (Charts)
- Dashboard Tile component is a container control that analyzes and visualizes a bound ItemsSource collection or single point and returns an appropriate data visualization based on the schema and count of the data. This control utilizes a built-in Toolbar component to allow you to make changes to the visualization at runtime, allowing you to see many different visualizations of your data with minimal code.
IgniteUI.Blazor (Inputs)
- Color Editor can be used as a standalone color picker and is now integrated into ToolAction of Toolbar component to update visualizations at runtime.
Breaking Changes
- With the release of version 2024.2 and per the Microsoft .NET lifecycle, we no longer support .NET 3.1, .NET 5, or .NET 7.
24.2.19 (November 2024)
General
- New Carousel component.
IgbInput- Changed
changeevent argument type fromIgbComponentDataValueChangedEventArgstoIgbComponentValueChangedEventArgs
- Changed
24.1.46 (September 2024)
IgniteUI.Blazor (Charts)
New Data Pie Chart - The
IgbDataPieChartis a new component that renders a pie chart. This component works similarly to theIgbCategoryChart, in that it will automatically detect the properties on your underlying data model while allowing selection, highlighting, animation and legend support via the ItemLegend component.New Proportional Category Angle Axis - New axes for the Radial Pie Series in the
IgbDataChart, to plot slices similar to a pie chart, a type of data visualization where data points are represented as segments within a circular graph.-
New ToolActionCheckboxList A new CheckboxList ToolAction that displays a collection of items with checkboxes for selecting. A grid inside ToolAction CheckboxList grows in height up to 5 items, then a scrollbar is displayed. Requires IgbCheckboxListModule to be registered.
New Filtering Support
Axis Field Changes New default IconMenu in Toolbar when targeting CategoryChart. Label fields are mapped to the X-axis and Value fields are mapped to the Y-axis. Target chart reacts in realtime to changes made. IconMenu is hidden when chart has no ItemsSource set.
General
- New Banner component.
- New DatePicker component.
- New
IgbDividercomponent. IgbIcon- Added
SetIconRefmethod. This allows to register and replace icons by SVG files. - All components now use icons by reference internally so that it's easy to replace them without explicitly providing custom templates.
- Added
IgbCombo,DatePicker,IgbDialog,IgbDropdown,IgbExpansionPanel,IgbNavDrawer,IgbToast,IgbSnackbar, IgbSelectComponent- Toggle methods
Show,Hide,Togglemethods return true now on success. Otherwise false.
- Toggle methods
IgbRadioGroup
BREAKING CHANGES:
- Renamed old IgbDatePicker to IgbXDatePicker.
- Removed
Formcomponent. Use native form instead. - Removed
sizeproperty in favor of the--ig-sizeCSS custom property for the following components: IgbBadge,IgbChip,IgbLinearProgress,IgbCircularProgress- Renamed
Variantproperty type toStyleVariant.
- Renamed
IgbCalendar- Renamed
WeekStartproperty type toWeekDays.
- Renamed
IgbCheckbox,IgbSwitch- Changed
Changeevent argument type fromIgbComponentBoolValueChangedEventArgstoIgbCheckboxChangeEventArgs.
- Changed
IgbCombo- The
IgbCombois now of generic type and theValuetype is now of typeT[]. This means that either you need to specifyTor it will be inferred by the assignedValuetype. - Removed
IgbPositionStrategy,Flip,SameWidthproperties.
- The
- IgbSelectComponent
- Removed
IgbPositionStrategy,Flip,SameWidthproperties.
- Removed
IgbDateTimeInputIgbDropdown- Removed
IgbPositionStrategyproperty.
- Removed
IgbInputIgbRadio- Changed
Changeevent argument type fromIgbComponentBoolValueChangedEventArgstoIgbRadioChangeEventArgs.
- Changed
IgbRangeSlider- Removed
AriaThumbLowerandAriaThumbUpperproperties. UseThumbLabelLowerandThumbLabelUpperinstead.
- Removed
IgbRating- Renamed
Readonlyproperty toReadOnly.
- Renamed
IgniteUI.Blazor
- All Grids
- Added
GetColumns/GetColumnsAsyncmethods, which return the grid columns collection. - Added new
RowClickevent.
- Added
IgbPivotGrid- Added
Sortableproperty for aIgbPivotDimension. - Added horizontal layout. Can be enabled inside the new
PivotUIproperty asRowLayoutHorizontal. - Added row dimension summaries for horizontal layout only. Can be enabled for each
IgbPivotDimensionby settingHorizontalSummaryto true. - Added
HorizontalSummariesPositionproperty to thePivotUI, configuring horizontal summaries position. - Added row headers for the row dimensions. Can be enabled inside the new
PivotUIproperty asShowHeaderstrue. - Keyboard navigation now can move in to row headers back and forth from any row dimension headers or column headers.
- Added keyboard interactions for row dimension collapse using ALT + ↑ ↓ ← → arrows and row headers sorting using CTRL + ↑ ↓ arrows.
- Added
BREAKING CHANGES:
- All Grids
IgbRowIsland- Removed
DisplayDensitydeprecated property. - Renamed
Columns,ActualColumns,ContentColumnsproperties toColumnList,ActualColumnListandContentColumnList. Recommended to use the newGetColumnsmethod instead. - Renamed
RowDeleteandRowAddevent argument type toIgbRowDataCancelableEventArgs. - Renamed
ContextMenuevent argument type toIgbGridContextMenuEventArgs. - Removed
IgbGridEditEventArgs,IgbGridEditDoneEventArgs,IgbPinRowEventArgseventsRowIDandPrimaryKeyproperties. UseRowKeyinstead.
IgbPivotGrid- removed
ShowPivotConfigurationUIproperty. UsePivotUIand set inside it the newShowConfigurationoption.
- removed
IgbColumn- Removed
Movableproperty. Use Grid'sMovingproperty now. - Removed
ColumnChildrenproperty. UseChildColumnsinstead.
- Removed
IgbColumnGroup- Removed
Childrenproperty. UseChildColumnsinstead.
- Removed
IgbPaginator- Removed
IsFirstPageDisabledandIsLastPageDisabledproperties. UseIsFirstPageandIsLastPageinstead.
- Removed
23.2.257 (June 2024)
General
IgbInput,IgbTextarea- exposedValidateOnlyto enable validation rules being enforced without restricting user input.IgbDropdown-IgbPositionStrategyproperty is deprecated. The dropdown now uses thePopoverAPI to render its container in the top layer of the browser viewport, making the property obsolete.IgbDockManager-IgbSplitPaneIsMaximizedis deprecated. Having isMaximized set to true on a split pane level has no real effect as split panes serve as containers only, meaning they have no actual content to be shown maximized. Use theIsMaximizedproperty ofIgbTabGroupPaneand/orIgbContentPaneinstead.
IgniteUI.Blazor
DisplayDensitydeprecated in favor of the--ig-sizeCSS custom property. Check out the Grid Size topic for more.IgbPivotGrid- The type of Columns, Rows, Filters fromPivotConfigurationoption is now array of IgbPivotDimension -PivotDimension[], it wasPivotDimensionCollectionpreviously.
The type of Values from PivotConfiguration option is now array of IgbPivotValue - PivotValue[], it was PivotValueCollection previously.
IgniteUI.Blazor (Charts)
- Data Legend Grouping & Data Tooltip Grouping - New grouping feature added. The property
GroupRowVisibletoggles grouping with each series opting in can assign group text via theDataLegendGroupproperty. If the same value is applied to more than one series then they will appear grouped. Useful for large datasets that need to be categorized and organized for all users.
Chart Selection - New series selection styling. This is adopted broadly across all category, financial and radial series for
IgbCategoryChartandIgbDataChart. Series can be clicked and shown a different color, brightened or faded, and focus outlines. Manage which items are effected through individual series or entire data item. Multiple series and markers are supported. Useful for illustrating various differences or similarities between values of a particular data item. AlsoSelectedSeriesItemsChangedevent andSelectedSeriesItemsare available for additional help to build out robust business requirements surrounding other actions that can take place within an application such as a popup or other screen with data analysis based on the selection.Proportional Category Angle Axis - New axes for the Radial Pie Series in the
IgbDataChart, to enable creating pie charts in the allowing robust visualizations using all the added power of the data chart.Treemap Highlighting - Now exposes a
HighlightingModeproperty that allows you to configure the mouse-over highlighting of the items in the tree map. This property takes two options:Brightenwhere the highlight will apply to the item that you hover the mouse over only, andFadeOtherswhere the highlight of the hovered item will remain the same, but everything else will fade out. This highlight is animated, and can be controlled using theHighlightingTransitionDurationproperty.Treemap Percent-based Highlighting - New percent-based highlighting, allowing nodes to represent progress or subset of a collection. The appearance is shown as a fill-in of its backcolor up to a specific value either by a member on your data item or by supplying a new
HighlightedDataSource. Can be toggled viaHighlightedValuesDisplayModeand styled viaFillBrushes.Toolbar- NewIsHighlightedoption for ToolAction for outlining a border around specific tools of choice.
IgniteUI.Blazor (Gauges)
IgbRadialGauge- New label for the highlight needle.
HighlightLabelTextandHighlightLabelSnapsToNeedlePivotand many other styling related properties for the HighlightLabel were added.
- New label for the highlight needle.
23.2.204 (March 2024)
IgniteUI.Blazor (Charts)
Data Filtering via the InitialFilter property. Apply filter expressions to filter the chart data to a subset of records. Can be used for drill down large data.
IgbBulletGraph- The Performance bar will now reflect a difference between the value and new
HighlightValuewhen theHighlightValueDisplayModeis applied to the 'Overlay' setting. The highlight value will show a filtered/subset measured percentage as a filled in color while the remaining bar's appearance will appear faded to the assigned value, illustrating the performance in real-time.
- The Performance bar will now reflect a difference between the value and new
IgbLinearGauge- New highlight needle was added.
HighlightValueandHighlightValueDisplayModewhen both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear.
- New highlight needle was added.
IgbRadialGauge- New highlight needle was added.
HighlightValueandHighlightValueDisplayModewhen both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear.
- New highlight needle was added.
23.2.191 (April 2024)
- Bug Fixes
23.2.189 (March 2024)
New Components
- Hierarchical Grid component
- Text Area component
- Button Group component
New Features
IgbDockManager- New
ProximityDockproperty. If enabled, docking indicators are not visible and the end user can dock the dragged pane by dragging it close to the target pane edges. - New
ContainedInBoundariesproperty. Determines whether the floating panes are kept inside the Dock Manager boundaries. Defaults tofalse. - New
ShowPaneHeadersproperty. Determines whether pane headers are only shown on hover or always visible. Defaults toalways.
- New
IgbTree- Added
toggleNodeOnClickproperty that determines whether clicking over a node will change its expanded state or not. Defaults tofalse.
- Added
IgbRatingallowResetadded. When enabled selecting the same value will reset the component. Behavioral change - In previous releases this was the default behavior of the rating component. Make sure to setallowResetif you need to keep this behavior in your application.
Select,IgbDropdown- exposed
selectedItem,itemsandgroupsgetters
- exposed
IgbRadialGauge- New title/subtitle properties.
TitleText,SubtitleTextwill appear near the bottom the gauge. In addition, the various title/subtitle font properties were added such asTitleFontSize,TitleFontFamily,TitleFontStyle,TitleFontWeightandTitleExtent. Finally, the newTitleDisplaysValuewill allow the value to correspond with the needle's position. - New
OpticalScalingEnabledandOpticalScalingSizeproperties for theIgbRadialGauge. This new feature will manage the size at which labels, titles, and subtitles of the gauge have 100% optical scaling. You can read more about this new feature here - New highlight needle was added.
HighlightValueandHighlightValueDisplayModewhen both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear.
- New title/subtitle properties.
XamRadialChart- New Label Mode
The
IgbCategoryAngleAxisfor the now exposes aLabelModeproperty that allows you to further configure the location of the labels. This allows you to toggle between the default mode by selecting theCenterenum, or use the new mode,ClosestPoint, which will bring the labels closer to the circular plot area.
- New Label Mode
The
General
IgbInput,IgbMaskInput,IgbDateTimeInput,IgbRatingReadonlyhas been renamed toReadOnly
IgbInput
Deprecations
- The
sizeproperty and attribute have been deprecated for all components. Use the--ig-sizeCSS custom property instead. The following example sets the size of the avatar component to small:.avatar { --ig-size: var(--ig-size-small); } IgbDateTimeInputIgbRangeSliderAriaLabelLowerandAriaLabelUpperproperties have been deprecated. Please, useThumbLabelLowerandThumbLabelUpperinstead.
Removed
- Removed our own
dirattribute which shadowed the default one. This is a non-breaking change. IgbSlider-ariaLabelshadowed property. This is a non-breaking change.IgbCheckbox-ariaLabelledByshadowed attribute. This is a non-breaking change.IgbSwitch-ariaLabelledByshadowed attribute. This is a non-breaking change.IgbRadio-ariaLabelledByshadowed attribute. This is a non-breaking change.
23.2.110 (January 2024)
.NET 8.0 support
- 2023.2 release now support .NET 8. For more information on .NET 8 please refer to this article on Microsoft's site .
IgniteUI.Blazor (Charts)
- Chart Highlight Filter - The
IgbCategoryChartandIgbDataChartnow expose a way to highlight and animate in and out of a subset of data. The display of this highlight depends on the series type. For column and area series, the subset will be shown on top of the total set of data where the subset will be colored by the actual brush of the series, and the total set will have a reduced opacity. For line series, the subset will be shown as a dotted line.
23.2.97 (December 2023)
IgniteUI.Blazor - Toolbar -
- Save tool action has been added to save the chart to an image via the clipboard.
- Vertical orientation has been added via the toolbar's
Orientationproperty. By default the toolbar is horizontal, now the toolbar can be shown in vertical orientation where the tools will popup to the left/right respectfully. - Custom SVG icons support was added via the toolbar's
renderImageFromTextmethod, further enhancing custom tool creation.
IgniteUI.Blazor (Grid)
- Added New Features - State Persistence
23.1.37 (June 2023)
New Components
- Toolbar - component is a companion container for UI operations to be used primarily with our charting components. The toolbar will dynamically update with a preset of properties and tools when linked to our
IgbDataChartorIgbCategoryChartcomponents, but it also gives you the ability to create custom tools for your project.
IgniteUI.Blazor (Charts)
ValueLayer - A new series type named the
IgbValueLayeris now exposed which can allow you to render an overlay for different focal points of the plotted data such as Maximum, Minimum, and Average. This is applied to theIgbCategoryChartandIgbFinancialChartby adding to the newValueLinescollection.It is now possible to apply a dash array to the different parts of the series of the
IgbDataChart. You can apply this to the series plotted in the chart, the gridlines of the chart, and the trendlines of the series plotted in the chart.
22.2.65 (April 2023)
New Components
New Components
IgniteUI.Blazor (Data Grid)
- A new argument
PrimaryKeyhas been introduced toIgbRowDataEventArgsfromDetail, and part of the event arguments that are emitted by theRowAddedandRowDeletedevents. When the grid has a primary key attribute added, then the emitted primaryKey event argument represents the row ID, otherwise it defaults to null. RowSelectionChangingevent arguments are changed. Now, theOldSelection,NewSelection,AddedandRemovedcollections no longer consist of the row keys of the selected elements when the grid has set a primaryKey, but now in any case the row data is emitted.- When the grid is working with remote data and a primary key has been set, the selected rows that are not currently part of the grid view will be emitted for a partial row data object.
- When selected row is deleted from the grid component
RowSelectionChangingevent will no longer be emitted. - The
OnGroupingDoneevent has been renamed toGroupingDoneto not violate the no on-prefixed outputs convention. - The
OnDensityChangedevent has been renamed toDensityChangedto not violate the no on-prefixed outputs convention. All components exposing this event are affected.
IgniteUI.Blazor (Pivot Grid)
- The
IgbPivotDateDimensionpropertiesInBaseDimensionandInOptionhave been deprecated and renamed toBaseDimensionandOptionsrespectively.
IgniteUI.Blazor (Inputs)
IgbDateTimeInput, the StepDownAsync(DateTimeInputDatePart.Date, SpinDelta.Date) is now trimmed down to DatePart instead of DateTimeInputDatePartIgbRadioandIgbRadioGroup, added component validation along with styles for invalid stateMask, added the capability to escape mask pattern literals.IgbBadgeadded aShapeproperty that controls the shape of the badge and can be eitherSquareorRounded. The default shape of the badge is rounded.IgbAvatar, theRoundShapeproperty has been deprecated and will be removed in a future version. Users can control the shape of the avatar by the newly addedShapeattribute that can beSquare,RoundedorCircle. The default shape of the avatar isSquare.
IgniteUI.Blazor (DockManager)
- Dock Manager's Panes collection now has a protected setter; requires you to call Add rather than set panes in a nested structure when creating them.
22.2.50 (December 2022)
New Components
- Combo
- Pivot Grid
- .NET 7.0
22.1.76 (November 2022)
New Components
IgniteUI.Blazor (Charts)
Added significant improvements to default behaviors, and refined the Category Chart API to make it easier to use. These new chart improvements include:
- Responsive layouts for horizontal label rotation based on browser / screen size.
- Enhanced rendering for rounded labels on all platforms.
- Added marker properties to StackedFragmentSeries.
- Added
ShouldPanOnMaximumZoomproperty. - New Category Axis Properties:
- ZoomMaximumCategoryRange
- ZoomMaximumItemSpan
- ZoomToCategoryRange
- ZoomToItemSpan
- New Chart Aggregation API for Grouping, Sorting and Summarizing Category string and numeric values, eliminating the need to pre-aggregate or calculate chart data:
- InitialSortDescriptions
- InitialSorts
- SortDescriptions
- InitialGroups
- InitialGroupDescriptions
- GroupDescriptions
- InitialSummaries
- InitialSummaryDescriptions
- SummaryDescriptions
- InitialGroupSortDescriptions
- GroupSorts
- GroupSortDescriptions
[!Note] Chart Aggregation will not work when using
IncludedProperties|ExcludedProperties. These properties on the chart are meant for non-aggregated data. Once you attempt to aggregate data these properties should no longer be used. The reason it does not work is because aggregation replaces the collection that is passed to the chart for render. The include/exclude properties are designed to filter in/out properties of that data and those properties no longer exist in the new aggregated collection.
IgniteUI.Blazor (Data Grid)
- Changed IgbColumn to
IgbDataGridColumn - Changed GridCellEventArgs to
IgbDataGridCellEventArgs - Changed GridSelectionMode to
DataGridSelectionMode - Changed SummaryOperand to
DataSourceSummaryOperand
22.1.41 (June 2022)
IgniteUI.Blazor (Charts)
- Added the highly-configurable DataLegend component, which works much like the
Legend, but it shows values of series and provides many configuration properties for filtering series rows and values columns, styling and formatting values. - Added the highly-configurable DataToolTip which displays values and titles of series as well as legend badges of series in a tooltip. This is now the default tooltip for all chart types.
- Added animation and transition-in support for Stacked Series. Animations can be enabled by setting the
IsTransitionInEnabledproperty to true. From there, you can set theTransitionInDurationproperty to determine how long your animation should take to complete and theTransitionInModeto determine the type of animation that takes place. - Added
AssigningCategoryStyleevent, is now available to all series inIgbDataChart. This event is handled when you want to conditionally configure aspects of the series items such asFillbackground-color and highlighting. - New
AllowedPositionsenumeration for CalloutLayer. Used to limit where the callouts are to be placed within the chart. By default, the callouts are intelligently placed in the best place but this used to force for exampleTopLeft,TopRight,BottomLeftorBottomRight. - New corner radius properties added for Annotation Layers; used to round-out the corners of each of the callouts. Note, a corner radius has now been added by default.
CalloutCornerRadiusfor CalloutLayerAxisAnnotationBackgroundCornerRadiusfor FinalValueLayerXAxisAnnotationBackgroundCornerRadiusandYAxisAnnotationBackgroundCornerRadiusfor CrosshairLayer
- New
HorizontalViewScrollbarModeandVerticalViewScrollbarModeenumeration to enable scrollbars in various ways. When paired withIsVerticalZoomEnabledorIsHorizontalZoomEnabled, you'll be able to persist or fade-in and out the scrollbars along the axes to navigate the chart. - New
FavorLabellingScaleEnd, determines whether the axis should favor emitting a label at the end of the scale. Only compatible with numeric axes (e.g.IgbNumericXAxis,IgbNumericYAxis,PercentChangeAxis). - New
IsSplineShapePartOfRangedetermines whether to include the spline shape in the axis range requested of the axis. - New
XAxisMaximumGap, determines the maximum allowed value for the plotted series when usingXAxisGap. The gap determines the amount of space between columns or bars of plotted series. - New
XAxisMinimumGapSize, determines the minimum allowed pixel-based value for the plotted series when usingXAxisGapto ensure there is always some spacing between each category.
IgniteUI.Blazor (Data Grid)
Added New Feature - Row Paging which is used to split a large set of data into a sequence of pages that have similar content. With pagination, data can be displayed in a set number of rows, letting users “scroll” through their data, without needing a scroll bar. The UI for table pagination usually includes things like the current page, total pages, and clickable Previous and Next arrows/buttons that let users flip through the pages of data.
IgniteUI.Blazor (Dock Manager)
- The Blazor Dock Manager is now in state, that provides a way to manage a complex layout using different type of panes with various sizes, positions, and behaviors, and that can be docked to various locations within an app. The Dock Manager allows your end-users to customize it further by pinning, resizing, moving, floating, and hiding panes.
New Components
21.2.52 (December 2021)
[!Note] The following breaking changes were introduced
IgniteUI.Blazor (Data Grid)
- Changed
ValueFieldproperty from type string[] to string.
IgniteUI.Blazor (Inputs)
- A new
ValueChangedevent supports 2-way binding and should only be handled if you have not bound theValueproperty. In order to read the Value field from the control without data binding theValueChangedevent should be handled, otherwise if your data is not bound you should use GetCurrentValueAsync to read the controls Value.
Date Picker
- Changed
ValueChangedevent toSelectedValueChanged.
Multi-Column ComboBox
- Changed
TextChangedevent toTextValueChanged. - Changed
ValueChangedevent toSelectedValueChanged.
21.2.22 (November 2021)
[!Note] The Igb prefix is now required for the Ignite UI for Blazor components and nested elements within each component. This API change was necessary to avoid ambiguity between Infragistics controls and 3rd party controls.
For example,
<CategoryChart/>instead of<CategoryChart/>
New Components
- Avatar
- Badge
- Button & Icon Button
- Card
- Checkbox
- Form
- Icon
- List
- Navigation Bar
- Navigation Drawer
- Radio & Radio Group
- Ripple
- Switch
Chart and Map Improvements
This release introduces a few improvements and simplifications to visual design and configuration options for the geographic map and all chart components.
- Changed
YAxisLabelLocationproperty's type to YAxisLabelLocation from AxisLabelLocation inIgbFinancialChartandIgbCategoryChart - Changed
XAxisLabelLocationproperty's type to XAxisLabelLocation from AxisLabelLocation inIgbFinancialChart - Added
XAxisLabelLocationproperty toIgbCategoryChart - Added support for representing geographic series of
IgbGeographicMapin a legend - Added crosshair lines by default in
IgbFinancialChartandIgbCategoryChart - Added crosshair annotations by default in
IgbFinancialChartandIgbCategoryChart - Added final value annotation by default in
IgbFinancialChart - Added new properties in Category Chart and Financial Chart:
CrosshairsLineThicknessand other properties for customizing crosshairs linesCrosshairsAnnotationXAxisBackgroundand other properties for customizing crosshairs annotationsFinalValueAnnotationsBackgroundand other properties for customizing final value annotationsAreaFillOpacitythat allow changing opacity of series fill (e.g. Area chart)MarkerThicknessthat allows changing thickness of markers
- Added new properties in Category Chart, Financial Chart, Data Chart, and Geographic Map:
MarkerAutomaticBehaviorthat allows which marker type is assigned to multiple series in the same chartLegendItemBadgeShapefor setting badge shape of all series represented in a legendLegendItemBadgeModefor setting badge complexity on all series in a legend
- Added new properties in Series in Data Chart and Geographic Map:
LegendItemBadgeShapefor setting badge shape on specific series represented in a legendLegendItemBadgeModefor setting badge complexity on specific series in a legend
- Changed default vertical crosshair line stroke from #000000 to #BBBBBB in category chart and series
- Changed shape of markers to circle for all series plotted in the same chart. This can be reverted by setting chart's
MarkerAutomaticBehaviorproperty toSmartIndexedenum value - Simplified shapes of series in chart's legend to display only circle, line, or square. This can be reverted by setting chart's
LegendItemBadgeModeproperty toMatchSeriesenum value - Changed color palette of series and markers displayed in all charts to improve accessibility
| Old brushes/outlines | New outline/brushes |
|---|---|
| #8BDC5C #8B5BB1 #6DB1FF #F8A15F #EE5879 #735656 #F7D262 #8CE7D9 #E051A9 #A8A8B7 |
#8BDC5C #8961A9 #6DB1FF #82E9D9 #EA3C63 #735656 #F8CE4F #A8A8B7 #E051A9 #FF903B |
IgniteUI.Blazor (Data Grid)
- New Features Added:
- New API:
- Added
SelectionChangedevent. Used to detect changes on selection interactions e.g. Multiple row selection.
- Added
- Breaking Changes:
- Changed grid's SummaryScope property's type to SummaryScope from
DataSourceSummaryScope - Changed GroupHeaderDisplayMode property's type to GroupHeaderDisplayMode from
DataSourceSectionHeaderDisplayMode
- Changed grid's SummaryScope property's type to SummaryScope from
21.1.52 (April 2021)
New Visual Designs
Charts & Maps
This release introduces several new and improved visual design and configuration options for all of the chart components, e.g. IgbDataChart, IgbCategoryChart, and IgbFinancialChart.
- Changed Bar/Column/Waterfall series to have square corners instead of rounded corners
- Changed Scatter High Density series’ colors for heat min property from #8a5bb1 to #000000
- Changed Scatter High Density series’ colors for heat max property from #ee5879 to #ee5879
- Changed Financial/Waterfall series’
NegativeBrushandNegativeOutlineproperties from #C62828 to #ee5879 - Changed marker's thickness to 2px from 1px
- Changed marker's fill to match the marker's outline for
IgbPointSeries,IgbBubbleSeries,IgbScatterSeries,IgbPolarScatterSeries. You can use setMarkerFillModeproperty to Normal to undo this change - Compressed labelling for the
IgbTimeXAxisandIgbOrdinalTimeXAxis - New Marker Properties:
- series.
MarkerFillMode- Can be set toMatchMarkerOutlineso the marker depends on the outline - series.
MarkerFillOpacity- Can be set to a value 0 to 1 - series.
MarkerOutlineMode- Can be set toMatchMarkerBrushso the marker's outline depends on the fill brush color
- series.
- New Series Property:
- series.
OutlineMode- Can be set to toggle the series outline visibility. Note, for Data Chart, the property is on the series
- series.
- New chart properties that define bleed over area introduced into the viewport when the chart is at the default zoom level. A common use case is to provide space between the axes and first/last data points. Note, the
ComputedPlotAreaMarginMode, listed below, will automatically set the margin when markers are enabled. The others are designed to specify aDoubleto represent the thickness, where PlotAreaMarginLeft etc. adjusts the space to all four sides of the chart:- chart.
PlotAreaMarginLeft - chart.
PlotAreaMarginTop - chart.
PlotAreaMarginRight - chart.
PlotAreaMarginBottom - chart.
ComputedPlotAreaMarginMode
- chart.
- New Highlighting Properties
- chart.
HighlightingMode- Sets whether hovered or non-hovered series to fade, brighten - chart.
HighlightingBehavior- Sets whether the series highlights depending on mouse position e.g. directly over or nearest item - Note, in previous releases the highlighting was limited to fade on hover.
- chart.
- Added Highlighting Stacked, Scatter, Polar, Radial, and Shape series:
- Added Annotation layers to Stacked, Scatter, Polar, Radial, and Shape series:
- Added support for overriding the data source of individual stack fragments within a stacked series
- Added custom style events to Stacked, Scatter, Range, Polar, Radial, and Shape series
- Added support to automatically sync the vertical zoom to the series content
- Added support to automatically expanding the horizontal margins of the chart based on the initial labels displayed
- Redesigned color palette of series and markers:
| Old brushes/outlines | New outline/brushes |
|---|---|
| #7446B9 #9FB328 #F96232 #2E9CA6 #DC3F76 #FF9800 #3F51B5 #439C47 #795548 #9A9A9A |
#8bdc5c #8b5bb1 #6db1ff #f8a15f #ee5879 #735656 #f7d262 #8ce7d9 #e051a9 #a8a8b7 |
for example:
![]() |
![]() |
![]() |
![]() |
Chart Legend
- Added horizontal
Orientationproperty to ItemLegend that can be used with Bubble, Donut, and Pie Chart - Added
LegendHighlightingModeproperty - Enables series highlighting when hovering over legend items
Geographic Map
[!Note] These features are CTP
- Added support for wrap around display of the map (scroll infinitely horizontally)
- Added support for shifting display of some map series while wrapping around the coordinate origin
- Added support for highlighting of the shape series
- Added support for some annotation layers for the shape series
IgniteUI.Blazor (Data Grid)
- Added
EditOnKeyPressaka Excel-style Editing, instantly begin editing when typing. - Added
EditModeClickActionproperty - By default double-clicking is required to enter edit mode. This can be set toSingleClickto allow for edit mode to occur when selecting a new cell. - Added
EnterKeyBehaviorsproperty - aka Excel-style Navigation (Enter Behavior) – controls the behavior of the enter key, e.g. Options are (none, edit, move up, down, left, right) - Added
EnterKeyBehaviorAfterEditproperty - While in edit-mode, this property controls when enter is pressed, e.g. Options are (moves to the cell below, above, right, left) - Added
SelectAllRows- method. - Added Row Range Selection - With
GridSelectionModeproperty set to MultipleRow the following new functionality is now included:- Click and drag to select rows
- SHIFT and click to select multiple rows.
- SHIFT and press the ↑ + ↓ arrow keys to select multiple rows.
- Pressing space bar toggles selection of active row via
GridSelectionModeproperty set to MultipleRow or SingleRow - Added Column Summaries to Column Options Dialog.
IgniteUI.Blazor (Inputs)
Date Picker
ShowTodayButton- Toggles Today button visibilityLabel- Adds a label above the date valuePlaceholderproperty - adds custom text when no value is selectedFormatString- Customize input date string e.g. (yyyy-MM-dd)DateFormat- Specifies whether to display selected dates as LongDate or ShortDateFirstDayOfWeek- Specifies first day of weekFirstWeekOfYear- Specifies when to display first week of the year, e.g. (First Full Week, First Four day Week)ShowWeekNumbers- Toggles Week number visibilityMinDate&MaxDate- Date limits, specifying a range of available selectable dates.- Added Accessibility



