Ignite UI for React Changelog
All notable changes for each version of Ignite UI for React are documented on this page.
19.2.2 (October 2025)
igniteui-react-maps (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.
igniteui-react-charts (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 IgrRadialPieSeries 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 onIgrChartMouseEventArgsclass were reversed. This will change the values thatplotAreaPositionandchartPositionreturn.
igniteui-react-grids (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 IgrDataGridColumn 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 | IgrDataChart | Zoom rectangle is not positioned the same as the background rectangle |
| 30600 | IgrDoughnutChart | No textStyle property for either the chart or series (pie chart has this) |
| 31624 | IgrCategoryChart | Resizing the containing window of the IgrCategoryChart causes the chart to fail to render the series |
| 33861 | Excel Library | Adding line chart corrupts excel File for German culture |
| 37930 | IgrDataChart | Data Annotation Overlay Text Color not working |
| 38231 | IgrGrid | Unpinned column does not return to the original position if hidden columns exist |
Enhancements
IgrBulletGraph
- 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
IgrChartMouseEventArgscalledworldPositionthat 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
highlightingFadeOpacitytoIgrSeriesViewerandIgrDomainChart. This allows you to configure the opacity applied to highlighted series.Expose
CalloutLabelUpdatingevent for domain charts.
IgrDataGrid
- Added new property called
stopPropagationto DataGrid which prevents mouse events from bubbling to parent elements
IgrLinearGauge
- Added new
LabelsVisibleproperty
19.2.1 (September 2025)
Enhancements
- Added enhancement DatePicker should update calendar view on typing, as Date Range Picker 1818
Bug Fixes
| Bug Number | Control | Description |
|---|---|---|
| 1831 | Calendar | Navigation styling |
| 1833 | Card | Slotted igc-avatar size styles in supported themes |
| 1826 | Combo | Dropdown initial height |
| 1827 | Combo | Icon sizes styles for Indigo theme |
| 1834 | DatePicker, DateRangePicker | Disabled styles |
| 1820 | Input | Prefix and suffix slot styles for Bootstrap theme |
| 1824 | Input | Label and border styles for Material theme |
| 1836 | Input | Removed overridden tabindex property |
| 1827 | Select | Icon sizes styles for Indigo theme |
| 1809 | Switch | Use the new thumb hover property |
| 1837 | TileManager | Incorrect escape of internal regex |
19.2.0 (August 2025)
- Form associated custom elements now expose the ig-invalid custom state for styling with the
:state()CSS selector. See here for additional information - Form associated custom elements validity behavior. Now elements will try to mimic
:user-invalid, and won't apply invalid styles unless interacted through the UI or through a formrequestSubmit()/reset()invocation.
Bug Fixes
| Bug Number | Control | Description |
|---|---|---|
| 1786 | Input | Invalid state in readonly mode |
| 1786 | Input | Cannot style helper-text |
| 1795 | Card | Slotted igc-avatar in Indigo theme |
| 1786 | Combo | Border overlaps label text in invalid state |
| 1799 | Date Picker | Indigo elevation styles |
| 1783 | Date range picker | Return focus to main input on keyboard interactions |
| 1792 | Input | Placeholder and label alignment in Material theme |
| 1806 | Navigation drawer | Update relative positions styles and animation |
| 1786 | Select | Invalid state theming issues |
| 1797 | Textarea | Material theme interaction issues |
| 1797 | Textarea | Resizing behavior with suffix part |
| 1775 | Calendar | Vertical mode container paddings |
| 1731 | Carousel | Pause automatic rotation on pointer-initiated focus |
| 1772 | Carousel | Ensure onSlideChanged event is emitted when a slide is changed |
| 1765 | Date picker | Styling issues |
| 1764 | Date range picker | CSS borders and elevation |
| 1747 | File input | Bootstrap invalid box-shadow styles |
| 1672 | Stepper | Error when setting linear property in deferred rendering scenarios |
| 1768 | Textarea | Readonly state styles |
| 1755 | Dropdown | Icon size in Bootstrap theme |
| 1739 | Inputs | Label positioning and transition logic in Material theme |
19.1.0 (July 2025)
- Component - Date Range Picker
Breaking Changes
File Input
onChange&onCancelevents detail now returns the underlying componentfilesproperty.
Tooltip
- Tooltip events will no longer return its
anchortarget in itsdetailproperty
Behavioral Changes
Tooltip
- Behavioral change: Tooltip default
placementis 'bottom' now. - Behavioral change: Tooltip will not render an arrow indicator by default unless
with-arrowis set.
Enhancements
- Updated the readonly styles of most form associated components across all themes to better signify when a component is in a readonly state.
Bug Fixes
| Bug Number | Control | Description |
|---|---|---|
| 1710 | Calendar and Date Picker | Incorrect date rollover for in certain scenarios |
| 1728 | Combo | Case insensitive icon styles in themes |
| 1726 | Input | Replace border in fluent theme with a box-shadow |
| 1732 | Input | Focused state background color in Indigo theme |
| 1715 | Text Area | Label height and component height override |
19.0.1 (July 2025)
Bug Fixes
| Bug Number | Control | Description |
|---|---|---|
| 36448 | IgrRadialGauge | Radial label format properties do not work. (eg. Title, SubTitles) |
igniteui-react-charts (Charts)
- Add
MaximumExtentandMaximumExtentPercentageproperties for use with axis labels.
19.0.0 (April 2025)
igniteui-react-maps (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-react-charts (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.
igniteui-react-dashboards (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 ofLocalDataSource.
igniteui-react-grids
Breaking Changes
- The
DataGrid&IgrMultiColumnComboBoxare now part of the igniteui-react-data-grids package.
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 | IgrDataGrid | Summaries are only showing for first grouped child row |
| 37023 | IgrDataChart | Tooltips are cut-off/offscreen if overflow hidden is set. |
| 37244 | Excel | Custom Data Validation is not working. |
| 37685 | IgrSpreadsheet | Poor rendering of numbers formatted with Arial font. |
19.0.0 (April 2025)
[!Note]With 19.0.0 the React product introduces many breaking changes done to improve and streamline the API. Please refer to the full Update Guide.
Removed
IgrCheckboxChangeEventArgsremoved, useIgrCheckboxChangeEventArgsinstead.IgrRadioChangeEventArgsremoved, useIgrRadioChangeEventArgsinstead.IgrRangeSliderValueremoved, useIgrRangeSliderValueEventArgsinstead.ActiveStepChangingArgsremoved, useIgrActiveStepChangingEventArgsinstead.ActiveStepChangedArgsremoved, useIgrActiveStepChangedEventArgsinstead.
Enhancements
Stepper
Stepper Step's titlePosition now defaults to auto, instead of being undefined, which has the same behavior.
Tabs
igr-tab panel property is removed.
igr-tab-panel component is removed. The igr-tab now encompasses both the tab header and the tab content in a single component.
18.9.0 (April 2025)
New Components
- TileManager
Enhancements
List
- Added new property on
IgrListItemcalledselected
Accordion
- Added new events
OpenandClose
igniteui-react-grids
- All Grids
- Allow applying initial filtering through
IgrFilteringExpressionsTreeproperty
- Allow applying initial filtering through
Deprecations
- The
clickedevent of thebuttonis deprecated. Use the nativeonClickhandler.
Bug Fixes
| Bug Number | Control | Description |
|---|---|---|
| 25602 | IgrDataGrid | Loading a layout with one of the date-specific filter operators results in a TypeError console error |
| 28480 | IgrCombo | Undefined reference error is thrown when a datasource is replaced |
| 30319 | IgrDataGrid | Records are sorted despite no value changed |
| 32598 | IgrDataGrid | Multiselection is not working correctly |
| 36374 | IgrInput | A previous value was bound when a form was submitted on any touch device |
18.8.1 (March 2025)
igniteui-react-grids
The following table lists the bug fixes made for the Ignite UI for React toolset for this release:
| Bug Number | Control | Description |
|---|---|---|
| 36864 | Grids | There is wrong import path "grids/combined" for the react licensed package |
18.8.0 (March 2025)
igniteui-react-grids
- 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
igniteui-react
- Added new
allowSplitterDockproperty forDockmanagerthat allows docking directly in a split. - Added new
useFixedSizeproperty for theIgrSplitPaneofDockmanagerthat allows new resize behavior.
Enhancements
Toolbar
- Added new
groupHeaderTextStyleproperty toIgrToolbarandIgrToolPanel. If set, it will apply to allIgrToolActionGroupHeaderactions. - Added new property on
IgrToolActioncalledtitleHorizontalAlignmentwhich controls the horizontal alignment of the title text. - Added new property on
IgrToolActionSubPanelcalleditemSpacingwhich controls the spacing between items inside the panel.
Bug Fixes
The following table lists the bug fixes made for the Ignite UI for React toolset for this release:
| Bug Number | Control | Description |
|---|---|---|
| 32093 | IgrPivotGrid | PivotDateDimensionOptions are not applied to the PivotDateDimension |
| 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 |
| 30286 | IgrDataChart | Bubble Series tooltip content is switched to that of nearby bubble data in clicking a bubble |
| 32906 | IgrDataChart | IgrDataChart is showing two xAxis on the top |
| 33605 | IgrDataChart | ScatterLineSeries is not showing the color of the line correctly in the legend |
| 34053 | IgrRadialGauge | 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 |
| 34324 | IgrGrid | Column hiding through condition in the grid template is not working |
| 34678 | IgrGrid | Enum values coerced to strings, breaking expected numeric behavior in some grid properties |
| 34776 | IgrDataChart | Repeatedly showing and hiding the IgrDataChart causes memory leakage in JS Heap |
| 35495 | Excel Library | Pictures in cells are lost when a template file is loaded |
| 35496 | IgrSpreadsheet | Error when setting styles in Excel with images |
| 35498 | IgrDataChart | Tooltips for the series specified in IncludedSeries are not displayed |
| 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 |
18.7.7 (January 2025)
- Bug Fixes
igniteui-react-grids
- All Grids
- Fixed a critical memory leak when components are opened in several duplicate browser tabs.
18.7.6 (December 2024)
igniteui-react-charts (Charts)
DashboardTile
- New 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-react-charts (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.
18.7.4 (November 2024)
General
- New Carousel component.
IgrInput- Changed
changeevent argument type fromIgrComponentDataValueChangedEventArgstoIgrComponentValueChangedEventArgs
- Changed
18.7.0 (September 2024)
igniteui-react-charts (Charts)
New Data Pie Chart - The
IgrDataPieChartis a new component that renders a pie chart. This component works similarly to theIgrCategoryChart, 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
IgrDataChart, 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 IgrCheckboxListModule 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.
igniteui-react
- New Banner component.
- New DatePicker component.
- New
IgrDividercomponent. - Added support for native events to all components.
IgrIcon- 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
IgrCombo,DatePicker,IgrDialog,IgrDropdown,ExpansionPanel,IgrNavDrawer,IgrToast,IgrSnackbar, IgrSelectComponent- Toggle methods
show,hide,togglemethods return true now on success, otherwise false.
- Toggle methods
- IgrButtonComponent,
IgrIconButton,IgrCheckbox,IgrSwitch,IgrCombo,IgrDateTimeInput,IgrInput,IgrMaskInput,IgrRadio, IgrSelectComponent,IgrTextarea- Deprecated custom
focusandblurevents. Use the nativeonFocusandonBlurevents instead
- Deprecated custom
IgrRadioGroup
BREAKING CHANGES:
- Renamed old IgrDatePicker to IgrXDatePicker.
- Removed
Formcomponent. Use native form instead. - Removed
sizeproperty in favor of the--ig-sizeCSS custom property for the following components:IgrAvatar, IgrButtonComponent,IgrIconButton,IgrCalendar,IgrChip,IgrDropdown,IgrIcon,IgrInput,IgrList,IgrRating,IgrSnackbar,IgrTabs,IgrTree
IgrBadge,IgrChip,IgrLinearProgress,IgrCircularProgress- Renamed
Variantproperty type toStyleVariant.
- Renamed
IgrCalendar- Renamed
WeekStartproperty type toWeekDays.
- Renamed
IgrCheckbox,IgrSwitch- Changed
changeevent argument type fromIgrComponentBoolValueChangedEventArgstoIgrCheckboxChangeEventArgs.
- Changed
IgrCombo, IgrSelectComponent- Removed
positionStrategy,flip,sameWidthproperties.
- Removed
IgrDateTimeInput- Removed
maxValueandminValueproperties. Usemaxandmininstead.
- Removed
IgrDropdown- Removed
positionStrategyproperty.
- Removed
IgrInput- Removed old named
maxlengthandminlengthproperties. UsemaxLengthandminLength. - Removed old named
readonlyandinputmodeproperties. UsereadOnlyandinputMode. - Changed
inputModetype also tostring.
- Removed old named
IgrRadio- Changed
changeevent argument type fromIgrComponentBoolValueChangedEventArgstoIgrRadioChangeEventArgs.
- Changed
IgrRangeSlider- Removed
ariaThumbLowerandariaThumbUpperproperties. UsethumbLabelLowerandthumbLabelUpperinstead.
- Removed
IgrRating- Renamed
readonlyproperty toreadOnly.
- Renamed
igniteui-react-grids
- All Grids
- Added new
RowClickevent.
- Added new
IgrPivotGrid- Added
sortableproperty for aIgrPivotDimension. - Added horizontal layout. Can be enabled inside the new
pivotUIproperty asrowLayouthorizontal. - Added row dimension summaries for horizontal layout only. Can be enabled for each
IgrPivotDimensionby 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
IgrRowIsland- Removed
displayDensitydeprecated property. - Renamed
actualColumns,contentColumnsproperties toactualColumnListandcontentColumnList. UsecolumnsorcolumnListproperty to get all columns now. - Renamed
rowDeleteandrowAddevent argument type toIgrRowDataCancelableEventArgs. - Renamed
contextMenuevent argument type toIgrGridContextMenuEventArgs. - Removed
IgrGridEditEventArgs,IgrGridEditDoneEventArgs,IgrPinRowEventArgseventsrowIDandprimaryKeyproperties. UserowKeyinstead.
IgrPivotGrid- removed
showPivotConfigurationUIproperty. UsepivotUIand set inside it the newshowConfigurationoption.
- removed
IgrColumn- Removed
movableproperty. Use Grid'smovingproperty now. - Removed
columnChildrenproperty. UsechildColumnsinstead.
- Removed
columnGroup- Removed
childrenproperty. UsechildColumnsinstead.
- Removed
IgrPaginator- Removed
isFirstPageDisabledandisLastPageDisabledproperties. UseisFirstPageandisLastPageinstead.
- Removed
18.6.1 (June 2024)
igniteui-react
IgrInput,IgrTextarea- exposedvalidateOnlyto enable validation rules being enforced without restricting user input.IgrDropdown-IgrPositionStrategyproperty is deprecated. The dropdown now uses thePopoverAPI to render its container in the top layer of the browser viewport, making the property obsolete.IgrDockManager-IgrSplitPaneisMaximizedis 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 ofIgrTabGroupPaneand/orIgrContentPaneinstead.
igniteui-react-grids
DisplayDensitydeprecated in favor of the--ig-sizeCSS custom property. Check out the Grid Size topic for more.IgrPivotGrid- Configuration of the component can now be applied correctly.
igniteui-react-charts (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
IgrCategoryChartandIgrDataChart. 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
IgrDataChart, 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.IgrToolbar- NewIsHighlightedoption for ToolAction for outlining a border around specific tools of choice.
igniteui-react-gauges (Gauges)
IgrRadialGauge- New label for the highlight needle.
highlightLabelTextandhighlightLabelSnapsToNeedlePivotand many other styling related properties for the HighlightLabel were added.
- New label for the highlight needle.
18.6.0 (March 2024)
igniteui-react-charts
New Data Filtering via the
initialFilterproperty. Apply filter expressions to filter the chart data to a subset of records. Can be used for drill down large data.XamRadialChart- New Label Mode
The
IgrCategoryAngleAxisfor 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
igniteui-react-grids
- New [
IgrHierarchicalGrid](grids/hierarchical-grid/overview.md) component
igniteui-react-gauges
IgrRadialGauge- 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 theIgrRadialGauge. 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.
IgrLinearGauge- 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.
IgrBulletGraph- 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 completed 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
igniteui-react
- New
IgrTextareacomponent - New
IgrButtonGroupcomponent IgrDockManager- 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
IgrInput,IgrMaskInput,IgrDateTimeInput,IgrRatingReadonlyhas been renamed toreadOnly
IgrInputIgrTree- Added
toggleNodeOnClickproperty that determines whether clicking over a node will change its expanded state or not. Defaults tofalse.
- Added
IgrRatingallowResetadded. 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,IgrDropdown- exposed
selectedItem,itemsandgroupsgetters
- exposed
Deprecations
- The
Formcomponent has been deprecated. Please, use the native form element instead. - 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); } IgrDateTimeInputIgrRangeSliderAriaLabelLowerandAriaLabelUpperproperties have been deprecated. Please, usethumbLabelLowerandthumbLabelUpperinstead.
Removed
- Removed our own
dirattribute which shadowed the default one. This is a non-breaking change. IgrSlider-ariaLabelshadowed property. This is a non-breaking change.IgrCheckbox-ariaLabelledByshadowed attribute. This is a non-breaking change.IgrSwitch-ariaLabelledByshadowed attribute. This is a non-breaking change.IgrRadio-ariaLabelledByshadowed attribute. This is a non-breaking change.
18.5.0 (January 2024)
igniteui-react-charts (Charts)
- Chart Highlight Filter - The
IgrCategoryChartandIgrDataChartnow 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.
18.4.0 (December 2023)
igniteui-react-grids (Grid)
- Added New Features - State Persistence
18.3.0 (October 2023)
igniteui-react-grids - 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.Grid - This is a new fully functional cross-platform grid and includes features like filtering, sorting, templates, row selection, row grouping, row pinning and movable columns.
Deprecated Components
18.2.0 (June 2023)
New Components
- Toolbar - This 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 tool items when linked to our
IgrDataChartorIgrCategoryChartcomponents. You'll be able to create custom tools for your project allowing end users to provide changes, offering an endless amount of customization.
igniteui-react-charts (Charts)
ValueLayer - A new series type named the
IgrValueLayeris 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 theIgrCategoryChartandIgrFinancialChartby adding to the newvalueLinescollection.It is now possible to apply a dash array to the different parts of the series of the
IgrDataChart. 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.
18.1.0 (November 2022)
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-react-grids (Data Grid)
- Changed IgrColumn to
IgrDataGridColumn - Changed GridCellEventArgs to
IgrDataGridCellEventArgs - Changed GridSelectionMode to
DataGridSelectionMode - Changed SummaryOperand to
DataSourceSummaryOperand
16.16.0 (June 2022)
igniteui-react-charts (Charts)
- Added the highly-configurable DataLegend component, which works much like the
IgrLegend, 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 inIgrDataChart. 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.IgrNumericXAxis,IgrNumericYAxis,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-react-grids (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.
16.15.1 (December 2021)
igniteui-react-grids (Data Grid)
Data Grid
- Added
ValueMultiField, of type string[], in theIgrComboBoxColumnto be used when your items in the drop down contain a key that consists of multiple fields.
[!Note] The following breaking changes were introduced
- Changed
valueFieldproperty from type string[] to string.
igniteui-react-inputs (Inputs)
Date Picker
- Changed ValueChanged event to
SelectedValueChanged.
Multi-Column ComboBox
- Changed
TextChangedevent toTextValueChanged. - Changed
ValueChangedevent toSelectedValueChanged.
16.15.0 (November 2021)
[!Note] Please ensure package "lit-html": "^2.0.0" or newer is added to your project for optimal compatibility.
igniteui-react-charts (Charts)
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 inIgrFinancialChartandIgrCategoryChart - Changed
xAxisLabelLocationproperty's type to XAxisLabelLocation from AxisLabelLocation inIgrFinancialChart - Added
xAxisLabelLocationproperty toIgrCategoryChart - Added support for representing geographic series of
IgrGeographicMapin a legend - Added crosshair lines by default in
IgrFinancialChartandIgrCategoryChart - Added crosshair annotations by default in
IgrFinancialChartandIgrCategoryChart - Added final value annotation by default in
IgrFinancialChart - 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-react-grids (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
16.14.0 (April 2021)
igniteui-react-charts (Charts)
This release introduces several new and improved visual design and configuration options for all of the chart components, e.g. IgrDataChart, IgrCategoryChart, and IgrFinancialChart.
- 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
IgrPointSeries,IgrBubbleSeries,IgrScatterSeries,IgrPolarScatterSeries. You can use setmarkerFillModeproperty to Normal to undo this change - Compressed labelling for the
IgrTimeXAxisandIgrOrdinalTimeXAxis - 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
igniteui-react-maps (GeoMap)
[!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-react-grids (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-react-inputs (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
16.12.3 (November 2020)
igniteui-react-grids (Data Grid)
[!Note] These breaking changes were introduce in the grid package.
- Changed name of PropertyPath
The data grid component property propertyPath has been renamed to field. This applies to all Column types, GroupDescription, SortDescription & SummaryDescription.
<IgrTextColumn field="Name"/>
import { IgrColumnSummaryDescription, IgrColumnSortDescription, IgrColumnGroupDescription } from 'igniteui-react-data-grids'
const productCount = new IgrColumnSummaryDescription();
productCount.field = "ProductName";
const colSortDesc = new IgrColumnSortDescription();
colSortDesc.field = "UnitsInStock";
const income = new IgrColumnGroupDescription();
income.field = "Income";
16.12.2 (April 2020)
igniteui-react-grids (Data Grid)
- Changed Name of Live Grid
The data grid component and it's corresponding module's names have changed from "LiveGrid" to "DataGrid".
[!Note] These breaking changes were introduce in these packages and components only:
The new code for importing the grid and it's corresponding module is:
import { IgrDataGrid } from "igniteui-react-data-grids";
import { IgrDataGridModule } from 'igniteui-react-data-grids';
- Required Peer Dependency for Data Grid
The data grid component requires the "inputs" package.
**npm install --save igniteui-react-inputs**
16.11.7
- Changed Import Statements
Import statements have been simplified to use just package names instead of full paths to API classes and enums.
[!Note] These breaking changes were introduce in these packages and components only:
| Affected Packages | Affected Components |
|---|---|
| igniteui-react-excel | Excel Library |
| igniteui-react-spreadsheet | Spreadsheet |
| igniteui-react-maps | Geo Map, Treemap |
| igniteui-react-gauges | Bullet Graph, Linear Gauge, Radial Gauge |
| igniteui-react-charts | Category Chart, Data Chart, Donut Chart, Financial Chart], Pie Chart, Zoom Slider |
| igniteui-react-core | all classes and enums |
| igniteui-react-grids | Data Grid |
- Code After Changes
Now, you need to use just package names instead of full paths to API classes and enums.
Please also note that the name of the Data Grid component and its corresponding modules have also changed.
// gauges:
import { IgrLinearGauge } from "igniteui-react-gauges";
import { IgrLinearGaugeModule } from "igniteui-react-gauges";
import { IgrLinearGraphRange } from "igniteui-react-gauges";
import { IgrRadialGauge } from 'igniteui-react-gauges';
import { IgrRadialGaugeModule } from 'igniteui-react-gauges';
import { IgrRadialGaugeRange } from 'igniteui-react-gauges';
import { SweepDirection } from 'igniteui-react-core';
// charts:
import { IgrFinancialChart } from 'igniteui-react-charts';
import { IgrFinancialChartModule } from 'igniteui-react-charts';
import { IgrDataChart } from 'igniteui-react-charts';
import { IgrDataChartCoreModule } from 'igniteui-react-charts';
// maps:
import { IgrGeographicMap } from "igniteui-react-maps";
import { IgrGeographicMapModule } from "igniteui-react-maps";
// grids:
import { IgrLiveGrid } from "igniteui-react-data-grids";
import { IgrLiveGridModule } from 'igniteui-react-data-grids';
- Code Before Changes
Before, you had to import using full paths to API classes and enums:
// gauges:
import { IgrLinearGauge } from "igniteui-react-gauges/ES5/igr-linear-gauge";
import { IgrLinearGaugeModule } from "igniteui-react-gauges/ES5/igr-linear-gauge-module";
import { IgrLinearGraphRange } from "igniteui-react-gauges/ES5/igr-linear-graph-range";
import { IgrRadialGauge } from "igniteui-react-gauges/ES5/igr-radial-gauge";
import { IgrRadialGaugeModule } from "igniteui-react-gauges/ES5/igr-radial-gauge-module";
import { IgrRadialGaugeRange } from "igniteui-react-gauges/ES5/igr-radial-gauge-range";
import { SweepDirection } from "igniteui-react-core/ES5/SweepDirection";
// charts:
import { IgrFinancialChart } from "igniteui-react-charts/ES5/igr-financial-chart";
import { IgrFinancialChartModule } from "igniteui-react-charts/ES5/igr-financial-chart-module";
import { IgrDataChart } from "igniteui-react-charts/ES5/igr-data-chart";
import { IgrDataChartCoreModule } from "igniteui-react-charts/ES5/igr-data-chart-core-module";
// maps:
import { IgrGeographicMap } from "igniteui-react-maps/ES5/igr-geographic-map";
import { IgrGeographicMapModule } from "igniteui-react-maps/ES5/igr-geographic-map-module";
// grids:
import { IgrLiveGrid } from "igniteui-react-data-grids/ES5/igr-live-grid";
import { IgrLiveGridModule } from 'igniteui-react-data-grids/ES5/igr-live-grid-module';



