Ignite UI for Web Components Changelog
All notable changes for each version of Ignite UI for Web Components are documented on this page.
6.2.1 (September 2025)
igniteui-webcomponents-maps
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-webcomponents-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 IgcRadialPieSeriesComponent 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 onIgcChartMouseEventArgsclass were reversed. This will change the values thatplotAreaPositionandchartPositionreturn.
igniteui-webcomponents-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 IgcDataGridColumnComponent 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 | IgcDataChart | Zoom rectangle is not positioned the same as the background rectangle |
| 30600 | IgcDoughnutChart | No textStyle property for either the chart or series (pie chart has this) |
| 31624 | IgcCategoryChart | Resizing the containing window of the IgcCategoryChart causes the chart to fail to render the series |
| 33861 | Excel Library | Adding line chart corrupts excel File for German culture |
| 37930 | IgcDataChart | Data Annotation Overlay Text Color not working |
| 38231 | IgcGrid | 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
IgcChartMouseEventArgscalledworldPositionthat 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
highlightingFadeOpacitytoIgcSeriesViewerComponentandIgcDomainChartComponent. This allows you to configure the opacity applied to highlighted series.Expose
CalloutLabelUpdatingevent for domain charts.
IgcDataGrid
- Added new property called
stopPropagationto DataGrid which prevents mouse events from bubbling to parent elements
IgcLinearGauge
- Added new
LabelsVisibleproperty
6.2.0 (August 2025)
Enhancements
- 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 igcSlideChanged 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 |
6.1.0 (July 2025)
- Component - Date Range Picker
Breaking Changes
File Input
igcChange&igcCancelevents 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 |
6.0.1 (July 2025)
Bug Fixes
| Bug Number | Control | Description |
|---|---|---|
| 36448 | IgcRadialGauge | Radial label format properties do not work. (eg. Title, SubTitles) |
igniteui-webcomponents-charts
- Add
MaximumExtentandMaximumExtentPercentageproperties for use with axis labels.
6.0.0 (June 2025)
igniteui-webcomponents-maps
[!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-webcomponents-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-webcomponents-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-webcomponents-grids
Breaking Changes
- The
DataGrid&IgcMultiColumnComboBoxComponentare now part of the igniteui-webcomponents-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 | IgcDataGrid | Summaries are only showing for first grouped child row |
| 37023 | IgcDataChart | Tooltips are cut-off/offscreen if overflow hidden is set. |
| 37244 | Excel | Custom Data Validation is not working. |
| 37685 | IgcSpreadsheet | Poor rendering of numbers formatted with Arial font. |
5.4.0 (April 2025)
igniteui-webcomponents-grids
- All Grids
- Allow applying initial filtering through
filteringExpressionsTreeproperty
- Allow applying initial filtering through
Bug Fixes
| Bug Number | Control | Description |
|---|---|---|
| 25602 | IgcDataGrid | Loading a layout with one of the date-specific filter operators results in a TypeError console error |
| 28480 | IgcCombo | Undefined reference error is thrown when a datasource is replaced |
| 30319 | IgcDataGrid | Records are sorted despite no value changed |
| 32598 | IgcDataGrid | Multiselection is not working correctly |
| 36374 | IgcInput | A previous value was bound when a form was submitted on any touch device |
5.3.0 (February 2025)
Enhancements
Toolbar
- Added new
GroupHeaderTextStyleproperty totoolbarandIgcToolPanelComponent. If set, it will apply to allIgcToolActionGroupHeaderComponentactions. - Added new property on
IgcToolActionComponentcalledtitleHorizontalAlignmentwhich controls the horizontal alignment of the title text. - Added new property on
IgcToolActionSubPanelComponentcalleditemSpacingwhich controls the spacing between items inside the panel.
Bug Fixes
The following table lists the bug fixes made for the Ignite UI for Web Components toolset for this release:
| Bug Number | Control | Description |
|---|---|---|
| 26218 | Excel Library | Chart's plot area right margin becomes narrower and fill pattern and fill foreground are gone just by loading an Excel file |
| 30286 | IgcDataChart | Bubble Series tooltip content is switched to that of nearby bubble data in clicking a bubble |
| 32906 | IgcDataChart | IgcDataChart is showing two xAxis on the top |
| 33605 | IgcDataChart | ScatterLineSeries is not showing the color of the line correctly in the legend |
| 34053 | IgcRadialGauge | 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 |
| 34776 | IgcDataChart | Repeatedly showing and hiding the IgcDataChart causes memory leakage in JS Heap |
| 35495 | Excel Library | Pictures in cells are lost when a template file is loaded |
| 35496 | IgcSpreadsheet | Error when setting styles in Excel with images |
| 35498 | IgcDataChart | 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 |
5.2.0 (January 2025)
- Bug Fixes
igniteui-webcomponents-grids
- All Grids
- Fixed a critical memory leak when components are opened in several duplicate browser tabs.
5.1.1 (December 2024)
igniteui-webcomponents-charts
- Dashboard Tile component is a container control that analyzes and visualizes a bound ItemsSource collection or single point and returns an appropriate data visualization based on the schema and count of the data. This control utilizes a built-in Toolbar component to allow you to make changes to the visualization at runtime, allowing you to see many different visualizations of your data with minimal code.
igniteui-webcomponents-charts
- Color Editor can be used as a standalone color picker and is now integrated into ToolAction of Toolbar component to update visualizations at runtime.
5.0.0 (September 2024)
igniteui-webcomponents-charts
New Data Pie Chart - The
IgcDataPieChartComponentis a new component that renders a pie chart. This component works similarly to theIgcCategoryChartComponent, 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
IgcDataChartComponent, 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 IgcCheckboxListModule 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-webcomponents-grids
- All Grids
- Added new
RowClickevent.
- Added new
IgcPivotGridComponent- Added
sortableproperty for aIgcPivotDimension. - Added horizontal layout. Can be enabled inside the new
pivotUIproperty asrowLayouthorizontal. - Added row dimension summaries for horizontal layout only. Can be enabled for each
IgcPivotDimensionby 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
IgcRowIslandComponent- Removed
displayDensitydeprecated property. - Renamed
actualColumns,contentColumnsproperties toactualColumnListandcontentColumnList. UsecolumnorcolumnListproperty to get all columns now. - Renamed
rowDeleteandrowAddevent argument type toIgcRowDataCancelableEventArgs. - Renamed
contextMenuevent argument type toIgcGridContextMenuEventArgs. - Removed
IgcGridEditEventArgs,IgcGridEditDoneEventArgs,IgcPinRowEventArgseventsrowIDandprimaryKeyproperties. UserowKeyinstead.
IgcPivotGridComponent- removed
showPivotConfigurationUIproperty. UsepivotUIand set inside it the newshowConfigurationoption.
- removed
IgcColumnComponent- Removed
movableproperty. Use Grid'smovingproperty now. - Removed
columnChildrenproperty. UsechildColumnsinstead.
- Removed
columnGroup- Removed
childrenproperty. UsechildColumnsinstead.
- Removed
IgcPaginatorComponent- Removed
isFirstPageDisabledandisLastPageDisabledproperties. UseisFirstPageandisLastPageinstead.
- Removed
4.8.1 (June 2024)
igniteui-webcomponents
IgcInputComponent,IgcTextareaComponent- exposedvalidateOnlyto enable validation rules being enforced without restricting user input.IgcDropdownComponent-IgcPositionStrategyproperty is deprecated. The dropdown now uses thePopoverAPI to render its container in the top layer of the browser viewport, making the property obsolete.IgcDockManagerComponent-IgcSplitPaneisMaximizedis 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 ofIgcTabGroupPaneand/orIgcContentPaneinstead.
igniteui-webcomponents-grids
DisplayDensitydeprecated in favor of the--ig-sizeCSS custom property. Check out the Grid Size topic for more regarding the Grid.
igniteui-webcomponents-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
IgcCategoryChartComponentandIgcDataChartComponent. 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
IgcDataChartComponent, to enable creating pie charts in the allowing robust visualizations using all the added power of the data chart.Treemap Highlighting - Now exposes a
highlightingModeproperty that allows you to configure the mouse-over highlighting of the items in the tree map. This property takes two options:Brightenwhere the highlight will apply to the item that you hover the mouse over only, andFadeOtherswhere the highlight of the hovered item will remain the same, but everything else will fade out. This highlight is animated, and can be controlled using thehighlightingTransitionDurationproperty.Treemap Percent-based Highlighting - New percent-based highlighting, allowing nodes to represent progress or subset of a collection. The appearance is shown as a fill-in of its backcolor up to a specific value either by a member on your data item or by supplying a new
highlightedDataSource. Can be toggled viahighlightedValuesDisplayModeand styled viaFillBrushes.toolbar- NewIsHighlightedoption for ToolAction for outlining a border around specific tools of choice.
igniteui-webcomponents-gauges
IgcRadialGaugeComponent- New label for the highlight needle.
highlightLabelTextandhighlightLabelSnapsToNeedlePivotand many other styling related properties for the HighlightLabel were added.
- New label for the highlight needle.
4.8.0 (March 2024)
igniteui-webcomponents-grids
- New [
IgcHierarchicalGridComponent](grids/hierarchical-grid/overview.md) component.
igniteui-webcomponents-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
IgcCategoryAngleAxisComponentfor 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-webcomponents-gauges
IgcRadialGaugeComponent- 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 theIgcRadialGaugeComponent. 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.
IgcLinearGaugeComponent- 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.
IgcBulletGraphComponent- 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
4.7.0 (January 2024)
igniteui-webcomponents-charts
- Chart Highlight Filter - The
IgcCategoryChartComponentandIgcDataChartComponentnow 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.
4.6.0 (December 2023)
igniteui-webcomponents-grids
- Added New Features (Grid) - State Persistence.
4.3.2 (October 2023)
igniteui-webcomponents-layouts
- 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.
4.3.0 (June 2023)
igniteui-webcomponents-layouts
- 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
IgcDataChartComponentorIgcCategoryChartComponentcomponents. You'll be able to create custom tools for your project allowing end users to provide changes, offering an endless amount of customization.
igniteui-webcomponents-charts
ValueLayer - A new series type named the
IgcValueLayerComponentis 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 theIgcCategoryChartComponentandIgcFinancialChartComponentby adding to the newvalueLinescollection.It is now possible to apply a dash array to the different parts of the series of the
IgcDataChartComponent. 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.
4.2.5 (April 2023)
igniteui-webcomponents-grids
A new argument
primaryKeyhas been introduced toIgcRowDataEventArgs, and part of the event arguments that are emitted by theRowAddedandRowDeletedevents. When the grid has a primary key attribute added, then the emitted primaryKey event argument represents the row ID, otherwise it defaults to undefined.RowSelectionChangingevent arguments are changed. Now, theOldSelection,NewSelection,AddedandRemovedcollections no longer consist of the row keys of the selected elements when the grid has set a primaryKey, but now in any case the row data is emitted.When the grid is working with remote data and a primary key has been set, the selected rows that are not currently part of the grid view will be emitted for a partial row data object.
When selected row is deleted from the grid component
RowSelectionChangingevent will no longer be emitted.The
OnGroupingDoneevent has been renamed toGroupingDoneto not violate the no on-prefixed outputs convention.The
OnDensityChangedevent has been renamed toDensityChangedto not violate the no on-prefixed outputs convention. All components exposing this event are affected.IgcPivotGridComponent: TheIgcPivotDateDimensionpropertiesInBaseDimensionandInOptionhave been deprecated and renamed tobaseDimensionandoptionsrespectively.
igniteui-webcomponents-inputs
IgcDateTimeInputComponent, the StepDownAsync(DateTimeInputDatePart.Date, SpinDelta.Date) is now trimmed down to DatePart instead of DateTimeInputDatePartIgcRadioComponentandIgcRadioGroupComponent, added component validation along with styles for invalid stateMask, added the capability to escape mask pattern literals.IgcBadgeComponentadded ashapeproperty that controls the shape of the badge and can be eitherSquareorRounded. The default shape of the badge is rounded.IgcAvatarComponent, theRoundShapeproperty has been deprecated and will be removed in a future version. Users can control the shape of the avatar by the newly addedshapeattribute that can beSquare,RoundedorCircle. The default shape of the avatar isSquare.
4.0.4 (December 2022)
igniteui-webcomponents-grids
- New Pivot Grid component.
4.0.0 (November 2022)
igniteui-webcomponents-grids
- New Grid component.
- New Tree Grid component.
DataGrid:- Changed IgcColumn to
IgcDataGridColumnComponent - Changed GridCellEventArgs to
IgcDataGridCellEventArgs - Changed GridSelectionMode to
DataGridSelectionMode - Changed SummaryOperand to
DataSourceSummaryOperand
- Changed IgcColumn to
igniteui-webcomponents-charts
- Added significant improvements to default behaviors, and refined the Category Chart API to make it easier to use. These new chart improvements include:
- Responsive layouts for horizontal label rotation based on browser / screen size.
- Enhanced rendering for rounded labels on all platforms.
- Added marker properties to StackedFragmentSeries.
- Added
shouldPanOnMaximumZoomproperty. - New Category Axis Properties:
- ZoomMaximumCategoryRange
- ZoomMaximumItemSpan
- ZoomToCategoryRange
- ZoomToItemSpan
- New Chart Aggregation API for Grouping, Sorting and Summarizing Category string and numeric values, eliminating the need to pre-aggregate or calculate chart data:
- InitialSortDescriptions
- InitialSorts
- SortDescriptions
- InitialGroups
- InitialGroupDescriptions
- GroupDescriptions
- InitialSummaries
- InitialSummaryDescriptions
- SummaryDescriptions
- InitialGroupSortDescriptions
- GroupSorts
- GroupSortDescriptions
[!Note] Chart Aggregation will not work when using
includedProperties|excludedProperties. These properties on the chart are meant for non-aggregated data. Once you attempt to aggregate data these properties should no longer be used. The reason it does not work is because aggregation replaces the collection that is passed to the chart for render. The include/exclude properties are designed to filter in/out properties of that data and those properties no longer exist in the new aggregated collection.
3.2.1 (June 2022)
igniteui-webcomponents-grids
DataGrid:- Added New Feature - Row Paging which is used to split a large set of data into a sequence of pages that have similar content. With pagination, data can be displayed in a set number of rows, letting users “scroll” through their data, without needing a scroll bar. The UI for table pagination usually includes things like the current page, total pages, and clickable Previous and Next arrows/buttons that let users flip through the pages of data.
igniteui-webcomponents-charts
- Added the highly-configurable DataLegend component, which works much like the
Legend, but it shows values of series and provides many configuration properties for filtering series rows and values columns, styling and formatting values. - Added the highly-configurable DataToolTip which displays values and titles of series as well as legend badges of series in a tooltip. This is now the default tooltip for all chart types.
- Added animation and transition-in support for Stacked Series. Animations can be enabled by setting the
isTransitionInEnabledproperty to true. From there, you can set thetransitionInDurationproperty to determine how long your animation should take to complete and thetransitionInModeto determine the type of animation that takes place. - Added
AssigningCategoryStyleevent, is now available to all series inIgcDataChartComponent. 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.IgcNumericXAxisComponent,IgcNumericYAxisComponent,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.
1.4.2 (December 2021)
igniteui-webcomponents-grids
DataGrid:- Added
ValueMultiField, of type string[], in theIgcComboBoxColumnComponentto be used when your items in the drop down contain a key that consists of multiple fields.
- Added
[!Note] The following breaking changes were introduced: Changed
valueFieldproperty from type string[] to string.
igniteui-webcomponents-inputs
- Date Picker:
- Changed ValueChanged event to
SelectedValueChanged.
- Changed ValueChanged event to
- Multi-Column ComboBox:
- Changed
TextChangedevent toTextValueChanged. - Changed
ValueChangedevent toSelectedValueChanged.
- Changed
1.4.1 (November 2021)
igniteui-webcomponents-grids
DataGrid:- 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
[!Note] Please ensure package "lit-html": "^2.0.0" or newer is added to your project for optimal compatibility.
igniteui-webcomponents-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 inIgcFinancialChartComponentandIgcCategoryChartComponent - Changed
xAxisLabelLocationproperty's type to XAxisLabelLocation from AxisLabelLocation inIgcFinancialChartComponent - Added
xAxisLabelLocationproperty toIgcCategoryChartComponent - Added support for representing geographic series of
IgcGeographicMapComponentin a legend - Added crosshair lines by default in
IgcFinancialChartComponentandIgcCategoryChartComponent - Added crosshair annotations by default in
IgcFinancialChartComponentandIgcCategoryChartComponent - Added final value annotation by default in
IgcFinancialChartComponent - 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 |
1.3.0 (April 2021)
igniteui-webcomponents-grids
DataGrid:- 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.
- Added
igniteui-webcomponents-charts
- 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
igniteui-webcomponents-maps
[!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-webcomponents-charts
This release introduces several new and improved visual design and configuration options for all of the chart components, e.g. IgcDataChartComponent, IgcCategoryChartComponent, and IgcFinancialChartComponent.
- 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
IgcPointSeriesComponent,IgcBubbleSeriesComponent,IgcScatterSeriesComponent,IgcPolarScatterSeriesComponent. You can use setmarkerFillModeproperty to Normal to undo this change - Compressed labelling for the
IgcTimeXAxisComponentandIgcOrdinalTimeXAxisComponent - 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
1.1.3 (November 2020)
igniteui-webcomponents-grids
DataGrid:
[!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.
<igc-text-column field="Name"></igc-text-column>
import { IgcColumnSummaryDescription, IgcColumnSortDescription, IgcColumnGroupDescription} from 'igniteui-webcomponents-data-grids'
const productCount = new IgcColumnSummaryDescription();
productCount.field = "ProductName";
const colSortDesc = new IgcColumnSortDescription();
colSortDesc.field = "UnitsInStock";
const income = new IgcColumnGroupDescription();
income.field = "Income";
1.1.2 (April 2020)
igniteui-webcomponents-grids
DataGrid: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 { IgcDataGrid } from "igniteui-webcomponents-data-grids";
import { IgcDataGridModule } from 'igniteui-webcomponents-data-grids';
- Required Peer Dependency for
DataGrid
The data grid component requires the "inputs" package.
**npm install --save igniteui-webcomponents-inputs**
1.0.6
All Packages
- 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-webcomponents-excel | Excel Library |
| igniteui-webcomponents-spreadsheet | Spreadsheet |
| igniteui-webcomponents-maps | Geo Map, Treemap |
| igniteui-webcomponents-gauges | Bullet Graph, Linear Gauge, Radial Gauge |
| igniteui-webcomponents-charts | Category Chart, Data Chart, Donut Chart, Financial Chart], Pie Chart, Zoom Slider |
| igniteui-webcomponents-core | all classes and enums |
| igniteui-webcomponents-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 { IgcLinearGaugeComponent } from "igniteui-webcomponents-gauges";
import { IgcLinearGaugeModule } from "igniteui-webcomponents-gauges";
import { IgcLinearGraphRange } from "igniteui-webcomponents-gauges";
import { IgcRadialGaugeComponent } from 'igniteui-webcomponents-gauges';
import { IgcRadialGaugeModule } from 'igniteui-webcomponents-gauges';
import { IgcRadialGaugeRange } from 'igniteui-webcomponents-gauges';
import { SweepDirection } from 'igniteui-webcomponents-core';
// charts:
import { IgcFinancialChartComponent } from "igniteui-webcomponents-charts";
import { IgcFinancialChartModule } from "igniteui-webcomponents-charts";
import { IgcDataChartComponent } from "igniteui-webcomponents-charts";
import { IgcDataChartCoreModule } from "igniteui-webcomponents-charts";
// maps:
import { IgcGeographicMapComponent } from "igniteui-webcomponents-maps";
import { IgcGeographicMapModule } from "igniteui-webcomponents-maps";
// grids:
import { IgcDataGridComponent } from "igniteui-webcomponents-data-grids";
import { IgcDataGridModule } from "igniteui-webcomponents-data-grids";
- Code Before Changes
Before, you had to import using full paths to API classes and enums:
// gauges:
import { IgcLinearGaugeComponent } from 'igniteui-webcomponents-gauges/ES5/igc-linear-gauge-component';
import { IgcLinearGaugeModule } from 'igniteui-webcomponents-gauges/ES5/igc-linear-gauge-module';
import { IgcLinearGraphRange } from 'igniteui-webcomponents-gauges/ES5/igc-linear-graph-range';
import { IgcRadialGaugeComponent } from "igniteui-webcomponents-gauges/ES5/igc-radial-gauge-component";
import { IgcRadialGaugeModule } from "igniteui-webcomponents-gauges/ES5/igc-radial-gauge-module";
import { IgcRadialGaugeRange } from "igniteui-webcomponents-gauges/ES5/igc-radial-gauge-range";
import { SweepDirection } from "igniteui-webcomponents-core/ES5/SweepDirection";
// charts:
import { IgcFinancialChartComponent } from "igniteui-webcomponents-charts/ES5/igc-financial-chart-component";
import { IgcFinancialChartModule } from "igniteui-webcomponents-charts/ES5/igc-financial-chart-module";
import { IgcDataChartComponent } from "igniteui-webcomponents-charts/ES5/igc-data-chart-component";
import { IgcDataChartCoreModule } from "igniteui-webcomponents-charts/ES5/igc-data-chart-core-module";
// maps:
import { IgcGeographicMapComponent } from "igniteui-webcomponents-maps/ES5/igc-geographic-map-component";
import { IgcGeographicMapModule } from "igniteui-webcomponents-maps/ES5/igc-geographic-map-module";
// grids:
import { IgcLiveGridModule } from 'igniteui-webcomponents-data-grids/ES5/igc-live-grid-module';
import { IgcLiveGridComponent } from 'igniteui-webcomponents-data-grids/ES5/igc-live-grid-component';
igniteui-webcomponents
5.1.0 (October 2024)
Added
- New Carousel component.
5.0.0 (August 2024)
IgcIconComponent- 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
IgcRadioGroupComponent- Added
nameandvalueproperties.
- Added
BREAKING CHANGES:
- Removed
Formcomponent. Use native form instead. - Removed
sizeproperty in favor of the--ig-sizeCSS custom property for the following components: - Removed custom
igcFocusandigcBlurevents. Use the nativefocusandblurevents instead for the following components: IgcCheckboxComponent,IgcSwitchComponent,IgcRadioComponent- Changed
igcChangeevent arguments fromCustomEvent<boolean>toCustomEvent<{ checked: boolean; value: string | undefined }>
- Changed
IgcComboComponent, IgcSelectComponent- Removed
positionStrategy,flip,sameWidthproperties.
- Removed
IgcDialogComponent- Renamed The
closeOnEscapeproperty tokeepOpenOnEscape.
- Renamed The
IgcDropdownComponent- Removed
positionStrategyproperty.
- Removed
IgcInputComponent- Removed
maxlengthandminlengthproperties. Use the nativemaxLengthandminLengthproperties ormaxandmininstead. - Renamed
readonlyandinputmodeproperties toreadOnlyandinputMode.
- Removed
IgcRangeSliderComponent- Renamed
ariaThumbLower/ariaThumbUpperproperties tothumbLabelLower/thumbLabelUpper.
- Renamed
IgcRatingComponent- Renamed
readonlyproperty toreadOnly.
- Renamed
4.11.1 (July 2024)
Changed
IgcStepperComponent- Design changes in vertical mode.
4.11.0 (July 2024)
Changed
IgcToastComponent,IgcRatingComponent,IgcStepperComponent- Styling changes in Indigo Theme.
4.10.0 (July 2024)
Added
- New Banner component
- New Divider component
- New DatePicker component
IgcRadioGroupComponent- Bind underlying radio components name and checked state through the radio group.
Deprecated
IgcInputComponentInputmodeproperty. Aligned with the nativeinputModeDOM property instead.
Fixed
IgcInputComponent,IgcTextareaComponent- passingundefinedto value sets the underlying input value to undefined.IgcMaskInputComponent- after a formresetcall correctly update underlying input value and placeholder state.IgcTreeComponent- setting--ig-sizeon the itemindicatorCSS Part will now change the size of the icon.IgcDateTimeInputComponent- double emit ofigcChangein certain scenarios.IgcNavDrawerComponent- mini variant is not initially rendered when not in an open state.IgcComboComponent:- Selecting an entry using the ENTER key now correctly works in single selection mode.
- Turning on the
disableFilteringoption now clears any previously entered search term. - Entering a search term in single selection mode that already matches the selected item now works correctly.
4.9.0 (April 2024)
Added
IgcButtonGroupComponent- now allows resetting the selection state via theselectedItemsproperty.IgcInputComponent,IgcTextareaComponent- exposedvalidateOnlyto enable validation rules being enforced without restricting user input.
Changed
IgcComboComponent,selectandIgcDropdownComponent- now use the nativePopoverAPI.
Deprecated
IgcDropdownComponent-IgcPositionStrategyproperty is deprecated. The dropdown now uses thePopoverAPI to render its container in the top layer of the browser viewport, making the property obsolete.
Fixed
IgcDateTimeInputComponent- Label in Material theme is broken when component is in read-only mode.
4.8.2 (April 2024)
Fixed
IgcTextareaComponent- resize handle position for non-suffixed textarea.IgcTabsComponent- error when dynamically creating and adding a tab group and tabs in a single call stack.IgcCheckboxComponent/IgcSwitchComponent- participate in form submission when initially checked.IgcDialogComponent-igcClosedfired before the component was actually closed/hidden.
4.8.1 (April 2024)
Fixed
IgcDateTimeInputComponent-inputFormatis not applied to an already set value.IgcCheckboxComponent,IgcRadioComponent,IgcSwitchComponent- apply form validation synchronously.select,IgcDropdownComponent- Unable to select item when clicking on a wrapping element inside the dropdown/select item slot.IgcTreeComponent- active state is correctly applied to the correct tree node on click.
4.8.0 (March 2024)
Added
IgcComboComponentcan now setgroupSortingto none which shows the groups in the order of the provided data.IgcButtonComponent/IgcIconButtonComponent- updated visual looks across themes, new states.NavBar- added border in Bootstrap theme.
Changed
- Grouping in
IgcComboComponentno longer sorts the data.groupSortingproperty now affects the sorting direction only of the groups. Behavioral change: In previous release the sorting directions of the groups sorted the items as well. If you want to achieve this behavior you can pass already sorted data to theIgcComboComponent.
Deprecated
IgcSliderComponent-aria-label-upperandaria-label-lowerare deprecated and will be removed in the next major release. Usethumb-label-upperandthumb-label-lowerinstead.
Fixed
IgcButtonComponent- Slotted icon size.IgcButtonGroupComponent- Updated Fluent theme look.
- Disabled state in Safari.
IgcComboComponent/select- Style issues.IgcSliderComponent- Clicks on the slider track now use the track element width as a basis for the calculation.
- Input events are no longer emitted while continuously dragging the slider thumb and exceeding upper/lower bounds.
- When setting
upper-bound/lower-boundbeforemin/max, the slider will no longer overwrite the bound properties with the previous values ofmin/max. - The
aria-labelbound to the slider thumb is no longer reset on consequent renders.
IgcInputComponent- Default validators are run synchronously.
- Style issues.
IgcDateTimeInputComponent-setRangeText()updates underlying value.
4.7.0 (January 2024)
Added
IgcTreeComponent- AddedtoggleNodeOnClickproperty that determines whether clicking over a node will change its expanded state or not. Defaults tofalse.IgcRatingComponent-allowResetadded. 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.
Changed
- Improved WAI-ARIA compliance for
IgcAvatarComponent,IgcBadgeComponentandIgcComboComponent.
Fixed
- Active item visual styles for
IgcDropdownComponent,selectandIgcComboComponent. IgcNavDrawerComponent- mini variant broken visual style.
4.6.0 (December 2023)
Added
actionslot added toIgcSnackbarComponent.indicator-expandedslot added toIgcExpansionPanelComponent.toggle-icon-expandedslot added toselect.select,IgcDropdownComponent- exposedselectedItem,itemsandgroupsgetters.
Changed
- Updated the package to Lit v3.
- Components dark variants are now bound to their shadow root.
- Components implement default sizes based on current theme.
IgcButtonGroupComponent- changed events to non-cancellable.- Optimized components CSS and reduced bundle size.
- WAI-ARIA improvements for
IgcIconComponent,select,IgcDropdownComponentandIgcListComponent.
Fixed
IgcTextareaComponentmissing styling parts.IgcTreeItemComponentdisabled styles.IgcSnackbarComponentremoved unnecessary styles.IgcTreeItemComponenthover state visual design.IgcCalendarComponentnot keeping focus state when switching views.
4.5.0 (October 2023)
Added
- New Text Area component.
- New Button Group component.
- New
IgcToggleButtonComponent. IgcNavDrawerComponentnow supports CSS transitions.- Position attribute for
IgcToastComponentandIgcSnackbarComponent.
Deprecated
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 IgcAvatarComponent component to small:
igc-avatar {
--ig-size: var(--ig-size-small);
}
Fixed
- Combo items position in Safari.
- Calendar navigation buttons in RTL context.
- Export
IgcComboChangeEventArgstype. - Combo value and selection states with lazy data binding.
- Various style and theming fixes and adjustments.
4.4.0 (August 2023)
Added
- The following components are now Form Associated Custom Elements. They are automatically associated with a parent
<form>and behave like a browser-provided control: IgcStepperComponentnow supports animations.
Changed
IgcRatingComponentfluent theme colors.IgcStepperComponentindicator styles and color schemas.
Deprecated
Formcomponent is deprecated.IgcInputComponent:minlengthproperty is deprecated and will be removed in the next major version. UseminLengthinstead.maxlengthproperty is deprecated and will be removed in the next major version. UsemaxLengthinstead.readonlyproperty is deprecated and will be removed in the next major version. UsereadOnlyinstead.
IgcMaskInputComponent:readonlyproperty is deprecated and will be removed in the next major version. UsereadOnlyinstead.
IgcDateTimeInputComponent:readonlyproperty is deprecated and will be removed in the next major version. UsereadOnlyinstead.minValueproperty is deprecated and will be removed in the next major version. Usemininstead.maxValueproperty is deprecated and will be removed in the next major version. Usemaxinstead.
IgcRatingComponent:readonlyproperty is deprecated and will be removed in the next major version. UsereadOnlyinstead.
Removed
- Removed our own
dirattribute which shadowed the default one. This is a non-breaking change. IgcSliderComponent-ariaLabelshadowed property. This is a non-breaking change.IgcCheckboxComponent-ariaLabelledByshadowed attribute. This is a non-breaking change.IgcSwitchComponent-ariaLabelledByshadowed attribute. This is a non-breaking change.IgcRadioComponent-ariaLabelledByshadowed attribute. This is a non-breaking change.
Fixed
IgcInputComponent- outlined variant styling issues and indigo theme issues.select- outlined variant styling issuesIgcDateTimeInputComponent-spinUp/spinDowncalls moving the caret when the input is focused.
4.3.1 (August 2023)
Added
IgcTreeComponent- component animations.- Components border radius is consumed from their schemas.
Changed
IgcComboComponent,IgcInputComponent,select- schema colors.IgcDropdownComponent- schema colors.IgcIconComponent- updated theming styles and size.
Fixed
IgcComboComponent- single selection not working in certain scenarios.IgcDropdownComponent- various styling fixes.IgcIconButtonComponent- border radius with ripple.IgcIconButtonComponent- fixed wrong color in Fluent theme.IgcInputComponent- various styling fixes.IgcTreeItemComponent- assign closest igc-tree-item ancestor as a parent.IgcTabsComponent- internal hidden styles and custom display property.
4.3.0 (June 2023)
Added
IgcComboComponent:matchDiacriticsto the filtering options property. Defaults to false. If set to true the filter distinguishes between accented letters and their base letters. Otherwise strings are normalized and then matched.selectionproperty which returns the current selection as an array of data objects.
IgcCardComponent: Support explicit heightIgcDialogComponent: Added animationsIgcSnackbarComponent: Added animationsIgcToastComponent: Added animations
Changed
IgcComboComponent:valueis no longer readonly and can be explicitly set. The value attribute also supports declarative binding, accepting a valid JSON stringified array.valuetype changed fromstring[]toComboValue<T>[]where
ComboValue<T> = T | T[keyof T]igcChangeevent object properties are also changed to reflect the newvaluetype:
interface IgcComboChangeEventArgs<T> { newValue: ComboValue<T>[]; items: T[]; type: ComboChangeType; }
Deprecated
select: DeprecatedsameWidth,positionStrategyandflip. They will be removed in the next major release.
Fixed
select:prefix/suffix/helper-textslots not being rendered.IgcTabsComponent: Nested tabs selection.IgcDialogComponent: Backdrop doesn't overlay elements.IgcDropdownComponent: Listbox position on initial open state.IgcStepperComponent: Stretch vertically in parent container.IgcNavbarComponent: Wrong colors in fluent theme.- Animation player throws errors when height is unspecified.
IgcDateTimeInputComponent: Intl.DateTimeFormat issues in Chromium based browsers.
4.2.3 (April 2023)
Deprecated
IgcDialogComponent- PropertycloseOnEscapeis deprecated in favor of new propertykeepOpenOnEscape.
Fixed
IgcRadioComponent- colors in selected focus state.IgcIconButtonComponent- set icon size to match other design system products.IgcChipComponent- removed outline styles for Fluent and Material themes.IgcCalendarComponent- navigation to date on set value.IgcTabsComponent- not taking the full height of their parents.
4.2.2 (March 2023)
Deprecated
IgcButtonComponent- Theprefix/suffixslots are no longer needed and will be removed in the next major release.
Fixed
IgcButtonComponent- UI inconsistencies.IgcCalendarComponent- Fluent theme inconsistencies.IgcComboComponent- Selection via API doesn't work on a searched list.IgcDialogComponent- Fluent theme inconsistency.IgcInputComponent- UI inconsistencies.IgcToastComponent- Fluent theme inconsistency.- Components missing in defineAllComponents.
- Wrong host sizes for
IgcAvatarComponent,IgcBadgeComponent,IgcButtonComponentandIgcIconButtonComponent.
4.2.1 (February 2023)
Fixed
IgcComboComponent- Matching item not activated on filtering in single selection mode.
4.2.0 (January 2023)
Added
IgcComboComponent- Single Selection mode via thesingle-selectattribute.
Fixed
IgcInputComponent- UI inconsistencies.IgcBadgeComponent- Doesn't correctly renderigc-iconand font icons.IgcRadioComponent- UI inconsistencies.IgcNavDrawerComponent- Can't override item margin.
4.1.1 (January 2023)
Fixed
IgcInputComponent- position label based on component size.
- material themes don't match design.
- do not cache the underlying input.
- Card - color discrepancy between WC and Angular.
- Theme - update stale
--igc-*variables to--ig-*. - Removed dangling references after element disconnect.
4.1.0 (December 2022)
Added
- New Stepper component.
- New Combo component.
IgcMaskInputComponent- Skip literal positions when deleting symbols in the component
Fixed
IgcMaskInputComponent- Validation state on user input.
4.0.0 (November 2022)
Changed
- Themes
- Build - Utilize Ignite UI Theming package when building themes.
- Sizing - Introduced CSS variables that allow runtime CSS configuration of the size for all or individual components.
- Spacing - Introduced CSS variables that allow runtime CSS configuration of the internal spacing (padding/margin) of components.
- Scrollbars - Added the ability to style application-level scrollbars by setting the
ig-scrollbarCSS class on any element.
3.4.2 (November 2022)
Fixed
- Resolved importing error for
DateRangeType.
3.4.1 (September 2022)
Changed
IgcSliderComponent- updated theme with the latest fluent spec.IgcCalendarComponent- updated weekend days color.
Fixed
IgcTabsComponentselectedattribute breaks content visibility on init.
3.4.0 (September 2022)
Added
Fixed
IgcCalendarComponent- range selection a11y improvements.IgcRangeSliderComponent- a11y improvements for choosing range values.IgcRatingComponent- improved a11y with assistive software now reading the total number of items.IgcToastComponent- addedrole="alert"to the message container for assistive software to read it without the need of focusing.IgcChipComponent- made remove button accessible with the keyboard.IgcButtonComponentprefix/suffixdoes not align icons to the button text.
3.3.1 (August 2022)
Changed
IgcTreeComponent- Removed theme-specified height.
Fixed
IgcDropdownComponent- Dispose of top-level event listeners.IgcLinearProgressComponent- Indeterminate animation in Safari.IgcRadioGroupComponent- Child radio components auto-registration.
3.3.0 (July 2022)
Added
- New DateTimeInput component.
- New Tabs component.
- New Accordion component.
- Typography styles in themes.
Changed
IgcRatingComponent- Added support for single selection and empty symbols.IgcSliderComponent- Improved slider steps rendering.- Components will now auto register their dependencies when they are registered in
defineComponents
import { IgcDropdownComponent, defineComponents } from 'igniteui-webcomponents';
// will automatically register the dropdown item & group elements
// as well as their dependencies if any
defineComponents(IgcDropdownComponent);
Check the official documentation for more information.
Fixed
- Remove input helper text container when it is empty.
IgcIconComponentnot showing in Safari.IgcCheckboxComponentnot showing in Safari.IgcButtonComponentstretches correctly in flex containers.- Various theming issues.
IgcDropdownComponent- bug fixes and improvements.
3.2.0 (May 2022)
Added
- New MaskInput component.
- New ExpansionPanel component.
- New Tree component.
IgcRatingComponent- AddedselectedCSS part and exposed CSS variable to control symbol sizes.IgcIconButtonComponent- Allow slotted content.
Fixed
IgcNavDrawerComponent- Various styles fixes.- Buttons - Vertical align and focus management.
IgcInputComponent- Overflow forsuffix/prefix.IgcSwitchComponent- Collapse with small sizes.IgcListComponent- Overflow behavior.
3.1.0 (April 2022)
Added
IgcChipComponent: Addedprefixandsuffixslots.IgcSnackbarComponent: Addedtogglemethod.
Deprecated
IgcChipComponent: Previously exposedstartandendslots are replaced byprefixandsuffix. They remain active, but are now deprecated and will be removed in a future version.
Fixed
IgcChipComponent:- Auto load internal icons.
- Selected chip is misaligned.
- Package: ESM internal import paths.
3.0.0 (April 2022)
Changed
- Breaking Change: All dropdown related classes renamed from
DropDown*toDropdown*
2.2.0 (April 2022)
Added
- New DropDown component.
IgcCalendarComponent: Active date can be set via an attribute.
2.1.1 (March 2022)
Added
- Control border radius and elevation from
--igc-radius-factorand--igc-elevation-factor:
Example:
/* Make all components square and remove all shadows */
:root {
--igc-radius-factor: 0;
--igc-elevation-factor: 0;
}
2.1.0 (March 2022)
Added
- New LinearProgress component.
- New CircularProgress component.
- New Chip component.
- New Snackbar component.
- New Toast component.
- New Rating component.
- Component themes can be changed at runtime by calling the
configureTheme(theme: Theme)function
2.0.0 (February 2022)
Added
- Dark Themes
- New Slider component.
- New RangeSlider component.
- Support
requiredproperty inIgcRadioComponentcomponent.
Changed
- Fix checkbox/switch validity status
- Split
IgcCalendarComponent'svalue: Date | Date[]property into two properties -value: Dateandvalues: Date[] - Replaced
IgcCalendarComponent'shasHeaderproperty &has-headerattribute withhideHeader&hide-headerrespectively. - Replaced
IgcCardComponent'soutlinedproperty withelevated.
Removed
- Removed
igcOpening,igcOpened,igcClosingandigcClosedevents fromIgcNavDrawerComponentcomponent.
1.0.0 (November 2021)
Initial release of Ignite UI Web Components
Added
- Avatar component
- Badge component
- Button component
- Calendar component
- Card component
- Checkbox component
- Form component
- Icon component
- IconButton component
- Input component
- List component
- Navigation bar component
- Navigation drawer component
- Radio group component
- Radio component
- Ripple component
- Switch component
igniteui-dockmanager
1.14.4
Deprecated
IgcSplitPaneisMaximizedis 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 ofIgcTabGroupPaneand/orIgcContentPaneinstead.
1.14.3
Fixed
- Dock manager throws errors with Vite-based builds.
- Docking to edge in an empty root split pane throws errors.
1.14.2
Fixed
- Constraining panels inside the dock manager boundaries with quick drags.
1.14.1
Fixed
- Proximity dock rtl check
1.14.0
New features
- Add
showPaneHeadersproperty. - Add
proximityDockproperty. - Add
containedInBoundariesproperty.
Enhancements
- Add
contentIdof elements as CSS parts.
Fixed
- Maximizing and unpinning panes leads to unclickable panes.
- Center dock is possible in a pane that has
acceptsInnerDockset to true if theAllowInnerDockofIgcDockManagerComponentis set to false.
1.13.0
New features
- Add
focusPanemethod. - Add
allowInnerDockandAcceptsInnerDockproperties.
Enhancements
- Save pane maximized state in layout.
Fixed
- Tab selection order is not preserved.
1.12.5
New features
- Add
paneScrollevent.
Fixed
- ТabGroupPane: Pinning one of several unpinned panes results in all the panes getting pinned.
- Context menu not positioning correctly in RTL mode.
- Active pane is not retained when docking with keyboard.
1.12.4
Fixed
- Active pane incorrectly set when more than one Tab Group Pane is within a Floating Pane.
1.12.3
Fixed
- Error is thrown when dropping pane in a separate window.
1.12.2
Enhancements
- Add
tabs-more-menu-contentandtabs-more-menu-itemCSS parts.
Fixed
- Docking indicator left/right arrows positions are reversed in RTL mode.
- Context menu not positioning correctly.
- Missing overloads for
addEventListenerandremoveEventListener.
1.12.1
Enhancements
- Include pane information in
splitterResizeStartandsplitterResizeEndevents. IgcDockManagerComponentis now exported as class.
Fixed
- Contents in slots with
unpinnedHeaderIdare not updated correctly.
1.12.0
Fixed
- Docking not working with
allowFloating: false. - Flyout pane closing while active.
- Focusable elements does not receive focus.
- Navigating with pane navigator does not bring selected floating window on top.
- Event
splitterResizeStartcan't be cancelled. - Tabs context menu not positioning correctly.
1.11.3
New features
- Add
contextMenuPositionproperty - Add
selectedoption fortab-header-close-buttonCSS part
1.11.2
New features
- Add
hoveredoption fortab-header-close-buttonCSS part
1.11.1
Fixed
- CSS part fixes for
tab-header
1.11.0
New features
- Add options for
showHeaderIconOnHoverproperty for different buttons - Add
horizontalandverticaloptions forsplitter-handleCSS part - Add
header-titleCSS part - Add
hoveroption fortab-header-close-buttonCSS part in active/inactive states - Add
paneHeaderCloseButtonandtabHeaderCloseButtonslots
1.10.0
New features
- Add
showHeaderIconOnHoverproperty.
Fixed
- Active pane is not retained on float/dock.
- Splitter styles are not applied.
clickevent on customized header buttons is not working.- Removed erroneous dock indicators while dragging over splitter.
1.9.0
Fixed
- Styles not applied.
- Resize in RTL mode.
1.8.0
New features
- Customize dock manager buttons.
LayoutChangeevent which fires when the layout updates.
1.7.0
New features
- Customizable floating pane header.
disabledproperty per pane.DocumentOnlyproperty which allows content pane to be docked only inside a document host.AllowEmptyproperty for split and tab group panes which allows displaying empty areas.disableKeyboardNavigationproperty on the dock manager.
Fixed
- Docking indicators appear over the currently dragged floating pane.
1.6.0
New features
- Customize dock manager panes and tabs.
Fixed
- A floating pane is draggable outside of the page.
1.5.0
New features
allowMaximizeproperty per pane.
Fixed
- Unpinned pane is closing automatically upon clicking on its content.
- Panes selected from the overflow menu are not activated if there is an unpinned pane from the same tab group.
1.4.1
Fixed
- Pane with
allowPinning: falseplaced inside tab group can be unpinned. - Normalize a maximized pane when navigating away from it via the keyboard.
1.4.0
New features
- Reorder tabs without creating floating pane.
- Keyboard navigation.
- Pane navigator.
- Enable/disable floating pane resizing.
- Events for floating pane resizing.
Fixed
- Select pane when activated.
- Flyout unpinned pane when activated.
- Error thrown when hosting external popup inside pane.
- Tab selection is lost with nested Dock Manager components.
- Floating pane containing panes with disabled floating and docking cannot be moved.
- Exception thrown when docking floating pane inside empty dock manager.
1.3.0
New features
- More tabs menu appears when there is not enough space to display all tab headers.
- Hide pane without removing it from the layout using its
hiddenproperty. - Header slot properties for tab and unpinned pane -
tabHeaderIdandunpinnedHeaderId.
1.2.0
New features
- Active pane.
- Localization support.
Fixed
- Errors thrown when dragging the last document host tab and there is unpinned pane.
- Tabs content disappears after docking a pane with
allowFloating: false. - Exception thrown when quickly switching between docking indicators.
1.1.0
New features
- Maximizing panes.
- Docking preview shadow.
- ARIA support.
- API for external drag/drop support.
- Properties and events for user interactions such as closing, pinning, dragging.
- Support for ng update for Angular projects.
1.0.3
Enhancements
- Resize splitter using the keyboard.
1.0.2
Fixed
- Pane goes out of view when resized to its minimum size.
1.0.1
Enhancements
- Add active color css variable.
- Add keyboard support for context menu.
Fixed
- Selection is not working on first click when context menu is opened.
- Single tab is not rendered correctly after pinning/unpinning its sibling.
1.0.0
Initial release of Ignite UI Dock Manager.



