Ignite UI for React Changelog

All notable changes for each version of Ignite UI for React are documented on this page.

19.6.0 (June 2026)

igniteui-react-charts

New Features

• Added Checkmark option to the MarkerType enum. Use MarkerType.Checkmark on a series to display a V-shaped checkmark icon inside a circle. The new MarkerAutomaticBehavior.Checkmark enum value allows applying the checkmark shape to all series in the chart, and the SeriesViewer.CheckmarkMarkerTemplate property can be used to customize its template.
• Added MarkerSize support on marker-enabled chart series to control marker dimensions in device-independent pixels and reset to template-based sizing with NaN.

igniteui-react

Changed

• IgrDockManager: Updated to use the latest igniteui-dockmanager@2.1.0 with new minResizeWidth and minResizeHeight properties, paneFlyoutToggle event; additional layoutChange event detail and fixes. See the full changelog.
• Updated to use the latest igniteui-webcomponents@7.1.0 including new IgrSplitter and IgrHighlight container components and fixes. See the full changelog.

New Features

• AI-Assisted Development - Agent Skills

  • Structured knowledge files that teach AI coding assistants (GitHub Copilot, Cursor, Windsurf, Claude, JetBrains AI, etc.) how to work with Ignite UI for React.
  • The skill files are included in the igniteui-react package and also live in the skills/ directory:
    • components - Identify the right React components (Igr*) for a UI pattern, then install, import, and use them — JSX patterns, events, refs, forms, etc.
    • customize-theme - Customize styling using CSS custom properties, Sass, and the theming system in React, including using Ignite UI Theming MCP server.
    • optimize-bundle-size - Reduce bundle size with granular imports, tree-shaking, and lazy loading.
  • These skills are automatically discovered when placed in the agent’s skills path (e.g. .agents/skills or .claude/skills).

19.5.2 (March 2026)

Bug Fixes

Enhancements

igniteui-react-charts

• Added RangeBarSeries support for horizontal range rendering in IgrDataChart.

19.5.1 (February 2026)

igniteui-react

New Features

• AI-Assisted Development - Copilot Skills

  • Four end-user skills are now shipped with the igniteui-react package under the skills/ directory providing step-by-step guidance to GitHub Copilot and other LLM agents for common tasks:
    • igniteui-wc-choose-components - Identify the right component for a given UI pattern.
    • igniteui-wc-integrate-with-framework - Set up and use components in React, Angular, Vue, or vanilla JS.
    • igniteui-wc-customize-component-theme - Apply custom styles via CSS custom properties, parts, and the theming system.
    • igniteui-wc-optimize-bundle-size - Reduce production bundle size through selective imports and lazy loading.

• Chat

  • adoptRootStyles can now be toggled on/off at runtime.

Breaking Changes

• Themes

  • Changed global prefixes for CSS custom properties for component themes to align with other Ignite UI component libraries.

• Chat

  • Removed the typingIndicator template renderer. Use the typing-indicator slot instead.

• Tooltip

  • Removed the disableArrow deprecated property.

• Library

  • Minimum Node version required is now >= 22.

  Bug Fixes

igniteui-react-grids (Grids)

• IgrGrid, IgrTreeGrid, IgrHierarchicalGrid, IgrPivotGrid
  • Improved performance by dynamically adjusting the scroll throttle based on the data displayed in grid.

Breaking Changes

• IgrGrid, IgrTreeGrid, IgrHierarchicalGrid, IgrPivotGrid
  • Original data array mutations (like adding/removing/moving records in the original array) are no longer detected automatically. Components need an array reference change for the change to be detected.

Localization(i18n)

• IgrGrid, IgrTreeGrid, IgrHierarchicalGrid, IgrPivotGrid, IgrCombo, IgrDatePicker, IgrDateRangePicker, IgrCalendar, IgrCarousel, IgrChip, IgrInput, IgrTree
  • New Intl implementation for the grid components that format and render data like dates and numbers. Updated Intl implementation for IgrCalendar, IgrDatePicker, and IgrDateRangePicker.
  • New localization implementation for the currently supported languages for all components that have resource strings in the currently supported languages.
  • New public localization API and package named igniteui-i18n-resources containing the new resources that are used in conjunction.

PDF export

• Added PDF export functionality allowing users to export grid data to PDF format.

Popover API

• Dropdown menus and dialogs are now using HTML Popover API to provide better positioning and accessibility.

19.3.2 (February 2026)

Enhancements

igniteui-react-charts

Added OthersCategoryBrush and OthersCategoryOutline to DataPieChart and ProportionalCategoryAngleAxis

Bug Fixes

19.3.1 (December 2025)

Bug Fixes

Enhancements

Charts

• Added LabelFormatOverride event to TimeXAxisLabelFormat so you can now override the formatting with an event at all time-formatting levels on the TimeXAxis.

• Adjusted the schema generation to account for more items to make it more likely to find valid values for properties.

19.3.0 (November 2025)

igniteui-react-charts (Charts)

Preview User Annotations

In Ignite UI for React, you can now annotate the IgrDataChart with slice, strip, and point annotations at runtime using the new user annotations feature. This allows the end user to add more details to the plot such as calling out single important events such as company quarter reports by using the slice annotation or events that have a duration by using the strip annotation. You can also call out individual points on the plotted series by using the point annotation or any combination of these three.

This is directly integrated with the available tools of the Toolbar.

Preview Collision Detection for Axis Annotations

Ability for axis annotations to automatically detect collisions and truncate to fit better. To enable this feature you must set the following properties:

• ShouldAvoidAnnotationCollisions
• ShouldAutoTruncateAnnotations

igniteui-react-maps (Geographic Map)

• Azure Map Imagery is now RTM.

Bug Fixes

19.3.0 (October 2025)

New Components

• Added IgrChat component

igniteui-react-grids (Grids)

• IgrGrid, IgrTreeGrid, IgrHierarchicalGrid

• Introduced a new cell merging feature that allows you to configure and merge cells in a column based on same data or other custom condition, into a single cell.

  It can be enabled on the individual columns:

        <IgrColumn field="field" merge={true}></IgrColumn>

The merging can be configured on the grid level to apply either:

• onSort - only when the column is sorted.
• always - always, regardless of data operations.

        <IgrGrid cellMergeMode="always">
        </IgrGrid>

The default cellMergeMode is onSort.

The functionality can be modified by setting a custom mergeStrategy on the grid, in case some other merge conditions or logic is needed for a custom scenario.

It’s possible also to set a mergeComparer on the individual columns, in case some custom handling is needed for a particular data field.

• Added ability to pin individual columns to a specific side (start or end of the grid), so that you can now have pinning from both sides. This can be done either declaratively by setting the pinningPosition property on the column:

        <IgrColumn field="Col1" pinned={true} pinningPosition="pinningPosition">
        </IgrColumn>

pinningPosition = ColumnPinningPosition.End;

Or with the API, via optional parameter:

grid.pinColumn('Col1', 0, ColumnPinningPosition.End);
grid.pinColumn('Col2', 0, ColumnPinningPosition.Start);

If property pinningPosition is not set on a column, the column will default to the position specified on the grid’s pinning options for columns.

• Sorting improvements
  • Improved sorting algorithm efficiency using Schwartzian transformation. This is a technique, also known as decorate-sort-undecorate, which avoids recomputing the sort keys by temporarily associating them with the original data records.
  • Refactored sorting algorithms from recursive to iterative.
• Groupby improvements
  • Refactored grouping algorithm from recursive to iterative.
  • Optimized grouping operations.

Bug Fixes

19.2.2 (October 2025)

igniteui-react-maps (Geographic Map)

Preview Azure Map Imagery Support

The IgrIgbGeographicMap 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)

Preview New Axis Label Events

The following events have been added to the IgrIgbDataChart to allow you to detect different operations on the axis labels:

• LabelMouseDown
• LabelMouseUp
• LabelMouseEnter
• LabelMouseLeave
• LabelMouseMove
• LabelMouseClick

Preview 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.

Preview 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 PlotAreaPosition and ChartPosition properties on IgrChartMouseEventArgs class were reversed. This will change the values that PlotAreaPosition and ChartPosition return.

igniteui-react-grids (Grids)

Preview 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:

• SuffixText
• SuffixTextColor
• SuffixTextFont
• SuffixIconName
• SuffixIconCollectionName
• SuffixIconStroke
• SuffixIconFill
• SuffixIconViewBoxLeft
• SuffixIconViewBoxTop
• SuffixIconViewBoxWidth
• SuffixIconViewBoxHeight
• TextDecoration

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

Enhancements

IgrBulletGraph

• Preview Added new LabelsVisible property

Charts

• New properties added to the DataToolTipLayer, ItemToolTipLayer, and CategoryToolTipLayer to aid in styling: ToolTipBackground, ToolTipBorderBrush, and ToolTipBorderThickness

• New properties added to the DataLegend to aid in styling: ContentBackground, ContentBorderBrush, and ContentBorderThickness. The ContentBorderBrush and ContentBorderThickness default to transparent and 0 respectively, so in order to see these borders, you will need to set these properties.

• Added a new property to IgrChartMouseEventArgs called WorldPosition that 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 HighlightingFadeOpacity to IgrSeriesViewer and IgrDomainChart. This allows you to configure the opacity applied to highlighted series.

• Expose CalloutLabelUpdating event for domain charts.

IgrDataGrid

• Added new property called stopPropagation to DataGrid which prevents mouse events from bubbling to parent elements

IgrLinearGauge

• Preview Added new LabelsVisible property

19.2.1 (September 2025)

Enhancements

• Added enhancement DatePicker should update calendar view on typing, as Date Range Picker 1818

Bug Fixes

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 form requestSubmit()/reset() invocation.

Bug Fixes

19.1.0 (July 2025)

• New Component - Date Range Picker

Breaking Changes

File Input

• onChange & onCancel events detail now returns the underlying component files property.

Tooltip

• Tooltip events will no longer return its anchor target in its detail property

Behavioral Changes

Tooltip

• Behavioral change: Tooltip default placement is ‘bottom’ now.
• Behavioral change: Tooltip will not render an arrow indicator by default unless with-arrow is 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

19.0.1 (July 2025)

Bug Fixes

igniteui-react-charts (Charts)

• Add New MaximumExtent and MaximumExtentPercentage properties for use with axis labels.

19.0.0 (April 2025)

igniteui-react-maps (Geographic Map)

Microsoft Bing Blogs

igniteui-react-charts (Charts)

• Added Preview 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 Preview LayoutMode property that you can use to layout the contents of the tooltip or legend in a table or vertical layout structure.

• Preview The DefaultInteraction property of the charts has been updated to include a new enumeration - DragSelect in which the dragged preview Rect will select the points contained within.

• Preview The ValueOverlay and ValueLayer, in addition to the Preview Chart Data Annotations listed above now expose an OverlayText property 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, the OverlayTextBrush property will configure the color of the overlay text.

• New 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 IgrDashboardTile now 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 the IgrDataSource of the IgrDashboardTile to an instance of IgrLocalDataSource.

igniteui-react-grids

Breaking Changes

• The IgrDataGrid & IgrMultiColumnComboBox are 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

19.0.0 (April 2025)

Update Guide

Removed

• IgrCheckboxChangeEventArgs removed, use IgrCheckboxChangeEventArgs instead.
• IgrRadioChangeEventArgs removed, use IgrRadioChangeEventArgs instead.
• IgrRangeSliderValue removed, use IgrRangeSliderValueEventArgs instead.
• ActiveStepChangingArgs removed, use IgrActiveStepChangingEventArgs instead.
• ActiveStepChangedArgs removed, use IgrActiveStepChangedEventArgs instead.

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 IgrListItem called Selected

Accordion

• Added new events Open and Close

igniteui-react-grids

• All Grids
  • Allow applying initial filtering through FilteringExpressionsTree property

Deprecations

• The clicked event of the Button is deprecated. Use the native onClick handler.

Bug Fixes

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:

18.8.0 (February 2025)

igniteui-react-grids

• All Grids
  • Added new disabledSummaries for the columns of the grid, allowing the developers to skip some of the summaries
  • Encapsulate internal grid action button

igniteui-react

• Added new allowSplitterDock property for Dockmanager that allows docking directly in a split.
• Added new useFixedSize property for the IgrSplitPane of Dockmanager that allows new resize behavior.

Enhancements

Toolbar

• Added new groupHeaderTextStyle property to Toolbar and IgrToolPanel. If set, it will apply to all IgrToolActionGroupHeader actions.
• Added new property on IgrToolAction called TitleHorizontalAlignment which controls the horizontal alignment of the title text.
• Added new property on IgrToolActionSubPanel called itemSpacing which 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:

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 Preview

• 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)

• Preview Color Editor can be used as a standalone color picker and is now integrated into Preview ToolAction of Toolbar component to update visualizations at runtime.

18.7.4 (November 2024)

General

• New Carousel component.
• IgrInput
  • Changed change event argument type from IgrComponentDataValueChangedEventArgs to IgrComponentValueChangedEventArgs

18.7.0 (September 2024)

igniteui-react-charts (Charts)

• New Data Pie Chart - The IgrDataPieChart is a new component that renders a pie chart. This component works similarly to the IgrCategoryChart, 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.

• Toolbar

  • 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 IgrDivider component.
• Added support for native events to all components.
• IgrIcon
  • Added setIconRef method. 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.
• IgrCombo, IgrDatePicker, IgrDialog, IgrDropdown, IgrExpansionPanel, IgrNavDrawer, IgrToast, IgrSnackbar, IgrSelectComponent
  • Toggle methods show, hide, toggle methods return true now on success, otherwise false.
• IgrButtonComponent, IgrIconButton, IgrCheckbox, IgrSwitch, IgrCombo, IgrDateTimeInput, IgrInput, IgrMaskInput, IgrRadio, IgrSelectComponent, IgrTextarea
  • Deprecated custom focus and blur events. Use the native onFocus and onBlur events instead
• IgrRadioGroup
  • Added Name and Value properties.

Breaking Changes

• Renamed old IgrDatePicker to IgrXDatePicker.
• Removed Form component. Use native form instead.
• Removed size property in favor of the --ig-size CSS custom property for the following components:
  • IgrAvatar, IgrButtonComponent, IgrIconButton, IgrCalendar, IgrChip, IgrDropdown, IgrIcon, IgrInput, IgrList, IgrRating, IgrSnackbar, IgrTabs, IgrTree
• IgrBadge, IgrChip, IgrLinearProgress, IgrCircularProgress
  • Renamed Variant property type to StyleVariant.
• IgrCalendar
  • Renamed WeekStart property type to WeekDays.
• IgrCheckbox, IgrSwitch
  • Changed change event argument type from IgrComponentBoolValueChangedEventArgs to IgrCheckboxChangeEventArgs.
• IgrCombo, IgrSelectComponent
  • Removed positionStrategy, flip, sameWidth properties.
• IgrDateTimeInput
  • Removed maxValue and minValue properties. Use max and min instead.
• IgrDropdown
  • Removed positionStrategy property.
• IgrInput
  • Removed old named maxlength and minlength properties. Use maxLength and minLength.
  • Removed old named readonly and inputmode properties. Use readOnly and inputMode.
  • Changed inputMode type also to string.
• IgrRadio
  • Changed change event argument type from IgrComponentBoolValueChangedEventArgs to IgrRadioChangeEventArgs.
• IgrRangeSlider
  • Removed ariaThumbLower and ariaThumbUpper properties. Use thumbLabelLower and thumbLabelUpper instead.
• IgrRating
  • Renamed readonly property to readOnly.

igniteui-react-grids

• All Grids
  • Added new RowClick event.
• IgrPivotGrid
  • Added sortable property for a IgrPivotDimension.
  • Added horizontal layout. Can be enabled inside the new pivotUI property as rowLayout horizontal.
  • Added row dimension summaries for horizontal layout only. Can be enabled for each IgrPivotDimension by setting horizontalSummary to true.
  • Added horizontalSummariesPosition property to the pivotUI, configuring horizontal summaries position.
  • Added row headers for the row dimensions. Can be enabled inside the new pivotUI property as showHeaders true.
  • 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.

Breaking Changes

• All Grids
  • IgrRowIsland
  • Removed displayDensity deprecated property.
  • Renamed actualColumns, contentColumns properties to actualColumnList and contentColumnList. Use columns or columnList property to get all columns now.
  • Renamed rowDelete and rowAdd event argument type to IgrRowDataCancelableEventArgs.
  • Renamed contextMenu event argument type to IgrGridContextMenuEventArgs.
  • Removed IgrGridEditEventArgs, IgrGridEditDoneEventArgs, IgrPinRowEventArgs events rowID and primaryKey properties. Use rowKey instead.
• IgrPivotGrid
  • removed showPivotConfigurationUI property. Use pivotUI and set inside it the new showConfiguration option.
• IgrColumn
  • Removed movable property. Use Grid’s moving property now.
  • Removed columnChildren property. Use childColumns instead.
• IgrColumnGroup
  • Removed children property. Use childColumns instead.
• IgrPaginator
  • Removed isFirstPageDisabled and isLastPageDisabled properties. Use isFirstPage and isLastPage instead.

18.6.1 (June 2024)

igniteui-react

• IgrInput, IgrTextarea - exposed ValidateOnly to enable validation rules being enforced without restricting user input.
• IgrDropdown - IgrPositionStrategy property is deprecated. The dropdown now uses the Popover API to render its container in the top layer of the browser viewport, making the property obsolete.
• IgrDockManager - IgrSplitPane IsMaximized is 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 the IsMaximized property of IgrTabGroupPane and/or IgrContentPane instead.

igniteui-react-grids

• DisplayDensity deprecated in favor of the --ig-size CSS 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 GroupRowVisible toggles grouping with each series opting in can assign group text via the DataLegendGroup property. 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 IgrCategoryChart and IgrDataChart. 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. Also SelectedSeriesItemsChanged event and SelectedSeriesItems are 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 HighlightingMode property that allows you to configure the mouse-over highlighting of the items in the tree map. This property takes two options: Brighten where the highlight will apply to the item that you hover the mouse over only, and FadeOthers where 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 the HighlightingTransitionDuration property.

• 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 HighlightedItemsSource. Can be toggled via HighlightedValuesDisplayMode and styled via FillBrushes.

• Toolbar - New IsHighlighted option for ToolAction for outlining a border around specific tools of choice.

igniteui-react-gauges (Gauges)

• IgrRadialGauge
  • New label for the highlight needle. HighlightLabelText and HighlightLabelSnapsToNeedlePivot and many other styling related properties for the HighlightLabel were added.

18.6.0 (March 2024)

igniteui-react-charts

• New 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.

• RadialChart

  • New Label Mode The IgrCategoryAngleAxis for the now exposes a LabelMode property that allows you to further configure the location of the labels. This allows you to toggle between the default mode by selecting the Center enum, or use the new mode, ClosestPoint, which will bring the labels closer to the circular plot area.

igniteui-react-grids

• New IgrHierarchicalGrid component

igniteui-react-gauges

• IgrRadialGauge
  • New title/subtitle properties. TitleText, SubtitleText will appear near the bottom the gauge. In addition, the various title/subtitle font properties were added such as TitleFontSize, TitleFontFamily, TitleFontStyle, TitleFontWeight and TitleExtent. Finally, the new TitleDisplaysValue will allow the value to correspond with the needle’s position.
  • New OpticalScalingEnabled and OpticalScalingSize properties for the IgrRadialGauge. 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 in this topic
  • New highlight needle was added. HighlightValue and HighlightValueDisplayMode when both are provided a value and ‘Overlay’ setting, this will make the main needle to appear faded and a new needle will appear.
• IgrLinearGauge
  • New highlight needle was added. HighlightValue and HighlightValueDisplayMode when both are provided a value and ‘Overlay’ setting, this will make the main needle to appear faded and a new needle will appear.
• IgrBulletGraph
  • The Performance bar will now reflect a difference between the value and new HighlightValue when the HighlightValueDisplayMode is 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.

igniteui-react

• New IgrTextarea component
• New IgrButtonGroup component
• IgrDockManager
  • New ProximityDock property. 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 ContainedInBoundaries property. Determines whether the floating panes are kept inside the Dock Manager boundaries. Defaults to false.
  • New ShowPaneHeaders property. Determines whether pane headers are only shown on hover or always visible. Defaults to always.
• IgrInput, IgrMaskInput, IgrDateTimeInput, IgrRating
  • Readonly has been renamed to ReadOnly
• IgrInput
  • Maxlength has been renamed to MaxLength
  • Minlength has been renamed to MinLength
• IgrTree
  • Added toggleNodeOnClick property that determines whether clicking over a node will change its expanded state or not. Defaults to false.
• IgrRating
  • allowReset added. 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 set allowReset if you need to keep this behavior in your application.
• Select, IgrDropdown
  • exposed selectedItem, items and groups getters

Deprecations

• The Form component has been deprecated. Please, use the native form element instead.

• The size property and attribute have been deprecated for all components. Use the --ig-size CSS custom property instead. The following example sets the size of the avatar component to small:

  .avatar {
      --ig-size: var(--ig-size-small);
  }

• IgrDateTimeInput
  • MinValue and MaxValue properties have been deprecated. Please, use Min and Max instead.
• IgrRangeSlider
  • AriaLabelLower and AriaLabelUpper properties have been deprecated. Please, use ThumbLabelLower and ThumbLabelUpper instead.

Removed

• Removed our own dir attribute which shadowed the default one. This is a non-breaking change.
• IgrSlider - ariaLabel shadowed property. This is a non-breaking change.
• IgrCheckbox - ariaLabelledBy shadowed attribute. This is a non-breaking change.
• IgrSwitch - ariaLabelledBy shadowed attribute. This is a non-breaking change.
• IgrRadio - ariaLabelledBy shadowed attribute. This is a non-breaking change.

18.5.0 (January 2024)

igniteui-react-charts (Charts)

• Chart Highlight Filter - The IgrCategoryChart and IgrDataChart now 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 - Preview

• 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 Orientation property. 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 renderImageFromText method, 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

DataGrid - The DataGrid is deprecated, please use Grid

18.2.0 (June 2023)

New Components

• Preview 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 IgrDataChart or IgrCategoryChart components. 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 IgrValueLayer is 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 the IgrCategoryChart and IgrFinancialChart by adding to the new ValueLines collection.

• 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 ShouldPanOnMaximumZoom property.
• 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

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 IgrDataGridSelectionMode
• Changed SummaryOperand to DataSourceSummaryOperand

16.16.0 (June 2022)

igniteui-react-charts (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 IsTransitionInEnabled property to true. From there, you can set the TransitionInDuration property to determine how long your animation should take to complete and the TransitionInMode to determine the type of animation that takes place.
• Added AssigningCategoryStyle event, is now available to all series in IgrDataChart. This event is handled when you want to conditionally configure aspects of the series items such as Fill background-color and highlighting.
• New AllowedPositions enumeration 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 example TopLeft, TopRight, BottomLeft or BottomRight.
• 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.
  • CalloutCornerRadius for CalloutLayer
  • AxisAnnotationBackgroundCornerRadius for FinalValueLayer
  • XAxisAnnotationBackgroundCornerRadius and YAxisAnnotationBackgroundCornerRadius for CrosshairLayer
• New HorizontalViewScrollbarMode and VerticalViewScrollbarMode enumeration to enable scrollbars in various ways. When paired with IsVerticalZoomEnabled or IsHorizontalZoomEnabled, 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 IsSplineShapePartOfRange determines 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 using XAxisGap. 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 using XAxisGap to 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 the IgrComboBoxColumn to be used when your items in the drop down contain a key that consists of multiple fields.

• Changed ValueField property from type string[] to string.

igniteui-react-inputs (Inputs)

Date Picker

• Changed ValueChanged event to SelectedValueChanged.

Multi-Column ComboBox

• Changed TextChanged event to TextValueChanged.
• Changed ValueChanged event to SelectedValueChanged.

16.15.0 (November 2021)

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 YAxisLabelLocation property’s type to YAxisLabelLocation from AxisLabelLocation in IgrFinancialChart and IgrCategoryChart
• Changed XAxisLabelLocation property’s type to XAxisLabelLocation from AxisLabelLocation in IgrFinancialChart
• Added XAxisLabelLocation property to IgrCategoryChart
• Added support for representing geographic series of IgrGeographicMap in a legend
• Added crosshair lines by default in IgrFinancialChart and IgrCategoryChart
• Added crosshair annotations by default in IgrFinancialChart and IgrCategoryChart
• Added final value annotation by default in IgrFinancialChart
• Added new properties in Category Chart and Financial Chart:
  • CrosshairsLineThickness and other properties for customizing crosshairs lines
  • CrosshairsAnnotationXAxisBackground and other properties for customizing crosshairs annotations
  • FinalValueAnnotationsBackground and other properties for customizing final value annotations
  • AreaFillOpacity that allow changing opacity of series fill (e.g. Area chart)
  • MarkerThickness that allows changing thickness of markers
• Added new properties in Category Chart, Financial Chart, Data Chart, and Geographic Map:
  • MarkerAutomaticBehavior that allows which marker type is assigned to multiple series in the same chart
  • LegendItemBadgeShape for setting badge shape of all series represented in a legend
  • LegendItemBadgeMode for setting badge complexity on all series in a legend
• Added new properties in Series in Data Chart and Geographic Map:
  • LegendItemBadgeShape for setting badge shape on specific series represented in a legend
  • LegendItemBadgeMode for 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 MarkerAutomaticBehavior property to SmartIndexed enum value
• Simplified shapes of series in chart’s legend to display only circle, line, or square. This can be reverted by setting chart’s LegendItemBadgeMode property to MatchSeries enum value
• Changed color palette of series and markers displayed in all charts to improve accessibility

igniteui-react-grids (Data Grid)

• New Features Added:
  • Filter Row
  • Load/Save Layout Customizations
  • GroupBy Area for column grouping
  • Cell Merging
• New API:
  • Added SelectionChanged event. Used to detect changes on selection interactions e.g. Multiple row selection.
• Breaking Changes:
  • Changed grid’s SummaryScope property’s type to SummaryScope from DataSourceSummaryScope
  • Changed GroupHeaderDisplayMode property’s type to GroupHeaderDisplayMode from DataSourceSectionHeaderDisplayMode

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’ NegativeBrush and NegativeOutline properties 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 set MarkerFillMode property to Normal to undo this change
• Compressed labelling for the IgrTimeXAxis and IgrOrdinalTimeXAxis
• New Marker Properties:
  • series.MarkerFillMode - Can be set to MatchMarkerOutline so the marker depends on the outline
  • series.MarkerFillOpacity - Can be set to a value 0 to 1
  • series.MarkerOutlineMode - Can be set to MatchMarkerBrush so the marker’s outline depends on the fill brush color
• New Series Property:
  • series.OutlineMode - Can be set to toggle the series outline visibility. Note, for Data Chart, the property is on the 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 a Double to 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
• 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.
• 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:

for example:

Chart Legend

• Added horizontal Orientation property to ItemLegend that can be used with Bubble, Donut, and Pie Chart
• Added LegendHighlightingMode property - Enables series highlighting when hovering over legend items

igniteui-react-maps (GeoMap)

• 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 EditOnKeyPress aka Excel-style Editing, instantly begin editing when typing.
• Added EditModeClickAction property - By default double-clicking is required to enter edit mode. This can be set to SingleClick to allow for edit mode to occur when selecting a new cell.
• Added IgrEnterKeyBehaviors property - 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 IgrEnterKeyBehaviorAfterEdit property - 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 GridSelectionMode property 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 GridSelectionMode property set to MultipleRow or SingleRow
• Added Column Summaries to Column Options Dialog.

igniteui-react-inputs (Inputs)

Date Picker

• ShowTodayButton - Toggles Today button visibility
• Label - Adds a label above the date value
• Placeholder property - adds custom text when no value is selected
• FormatString - Customize input date string e.g. (yyyy-MM-dd)
• DateFormat - Specifies whether to display selected dates as LongDate or ShortDate
• FirstDayOfWeek - Specifies first day of week
• FirstWeekOfYear - Specifies when to display first week of the year, e.g. (First Full Week, First Four day Week)
• ShowWeekNumbers - Toggles Week number visibility
• MinDate & MaxDate - Date limits, specifying a range of available selectable dates.
• Added Accessibility

16.12.3 (November 2020)

igniteui-react-grids (Data Grid)

• 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”.

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.

• 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';