Ignite UI for Blazor Changelog

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

    24.1.46 (September 2024)

    IgniteUI.Blazor (Charts)

    • New Data Pie Chart - The IgbDataPieChart is a new component that renders a pie chart. This component works similarly to the IgbCategoryChart, in that it will automatically detect the properties on your underlying data model while allowing selection, highlighting, animation and legend support via the ItemLegend component.

    • New Proportional Category Angle Axis - New axes for the Radial Pie Series in the IgbDataChart, to plot slices similar to a pie chart, a type of data visualization where data points are represented as segments within a circular graph.

    • 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 IgbCheckboxListModule to be registered.

      • New Filtering Support

      • Axis Field Changes New default IconMenu in Toolbar when targeting CategoryChart. Label fields are mapped to the X-axis and Value fields are mapped to the Y-axis. Target chart reacts in realtime to changes made. IconMenu is hidden when chart has no ItemsSource set.

    General

    BREAKING CHANGES:

    IgniteUI.Blazor

    • All Grids
      • Added GetColumns / GetColumnsAsync methods, which return the grid columns collection.
      • Added new RowClick event.
    • IgbPivotGrid
      • Added Sortable property for a IgbPivotDimension.
      • 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 IgbPivotDimension 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:

    23.2.257 (June 2024)

    General

    IgniteUI.Blazor

    • DisplayDensity deprecated in favor of the --ig-size CSS custom property. Check out the Grid Size topic for more.
    • IgbPivotGrid - The type of Columns, Rows, Filters from PivotConfiguration option is now array of IgbPivotDimension - PivotDimension[], it was PivotDimensionCollection previously.

    The type of Values from PivotConfiguration option is now array of IgbPivotValue - PivotValue[], it was PivotValueCollection previously.

    IgniteUI.Blazor (Charts)

    • Data Legend Grouping & Data Tooltip Grouping - New grouping feature added. The property 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 IgbCategoryChart and IgbDataChart. 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 dataitem. 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 IgbDataChart, to enable creating pie charts in the allowing robust visualizations using all the added power of the data chart.

    • Treemap Highlighting - Now exposes a 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 HighlightedDataSource. 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.Blazor (Gauges)

    23.2.204 (March 2024)

    IgniteUI.Blazor (Charts)

    Data Filtering via the InitialFilter property. Apply filter expressions to filter the chart data to a subset of records. Can be used for drill down large data.

    • IgbBulletGraph
      • The Performance bar will now reflect a difference between the value and new HighlightValue when the HighlightValueDisplayMode is applied to the 'Overlay' setting. The highlight value will show a filtered/subset measured percentage as a filled in color while the remaining bar's appearance will appear faded to the assigned value, illustrating the performance in real-time.
    • IgbLinearGauge
      • 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.
    • IgbRadialGauge
      • 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.

    23.2.191 (April 2024)

    • Bug Fixes

    23.2.189 (March 2024)

    New Components

    New Features

    • IgbDockManager
      • 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.
    • IgbTree
      • Added toggleNodeOnClick property that determines whether clicking over a node will change its expanded state or not. Defaults to false.
    • IgbRating
      • 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, IgbDropdown
      • exposed selectedItem, items and groups getters
    • IgbRadialGauge
      • 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 IgbRadialGauge. 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. 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.
    • XamRadialChart
      • New Label Mode The IgbCategoryAngleAxis 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.

    General

    Deprecations

    • 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);
}
    • IgbDateTimeInput
      • MinValue and MaxValue properties have been deprecated. Please, use Min and Max instead.
    • IgbRangeSlider

    Removed

    • Removed our own dir attribute which shadowed the default one. This is a non-breaking change.
    • IgbSlider - ariaLabel shadowed property. This is a non-breaking change.
    • IgbCheckbox - ariaLabelledBy shadowed attribute. This is a non-breaking change.
    • IgbSwitch - ariaLabelledBy shadowed attribute. This is a non-breaking change.
    • IgbRadio - ariaLabelledBy shadowed attribute. This is a non-breaking change.

    23.2.110 (January 2024)

    .NET 8.0 support

    IgniteUI.Blazor (Charts)

    • Chart Highlight Filter - The IgbCategoryChart and IgbDataChart 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.

    23.2.97 (December 2023)

    IgniteUI.Blazor (Toolbar - Beta)

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

    IgniteUI.Blazor (Grid)

    23.1.37 (June 2023)

    New Components

    • Toolbar - Beta. 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 tools when linked to our IgbDataChart or IgbCategoryChart components, but it also gives you the ability to create custom tools for your project.

    IgniteUI.Blazor (Charts)

    • ValueLayer - A new series type named the IgbValueLayer 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 IgbCategoryChart and IgbFinancialChart 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 IgbDataChart. You can apply this to the series plotted in the chart, the gridlines of the chart, and the trendlines of the series plotted in the chart.

    22.2.65 (April 2023)

    New Components

    New Components

    IgniteUI.Blazor (Data Grid)

    • A new argument PrimaryKey has been introduced to IgbRowDataEventArgs from Detail, and part of the event arguments that are emitted by the RowAdded and RowDeleted events. When the grid has a primary key attribute added, then the emitted primaryKey event argument represents the row ID, otherwise it defaults to null.
    • RowSelectionChanging event arguments are changed. Now, the OldSelection, NewSelection, Added and Removed collections 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 RowSelectionChanging event will no longer be emitted.
    • The OnGroupingDone event has been renamed to GroupingDone to not violate the no on-prefixed outputs convention.
    • The OnDensityChanged event has been renamed to DensityChanged to not violate the no on-prefixed outputs convention. All components exposing this event are affected.

    IgniteUI.Blazor (Pivot Grid)

    IgniteUI.Blazor (Inputs)

    • IgbDateTimeInput, the StepDownAsync(DateTimeInputDatePart.Date, SpinDelta.Date) is now trimmed down to DatePart instead of DateTimeInputDatePart
    • IgbRadio and IgbRadioGroup, added component validation along with styles for invalid state
    • Mask, added the capability to escape mask pattern literals.
    • IgbBadge added a Shape property that controls the shape of the badge and can be either Square or Rounded. The default shape of the badge is rounded.
    • IgbAvatar, the RoundShape property has been deprecated and will be removed in a future version. Users can control the shape of the avatar by the newly added Shape attribute that can be Square, Rounded or Circle. The default shape of the avatar is Square.

    IgniteUI.Blazor (DockManager)

    • Dock Manager's Panes collection now has a protected setter; requires you to call Add rather than set panes in a nested structure when creating them.

    22.2.50 (December 2022)

    New Components

    22.1.76 (November 2022)

    New Components

    IgniteUI.Blazor (Charts)

    Added significant improvements to default behaviors, and refined the Category Chart API to make it easier to use. These new chart improvements include:

    • Responsive layouts for horizontal label rotation based on browser / screen size.
    • Enhanced rendering for rounded labels on all platforms.
    • Added marker properties to StackedFragmentSeries.
    • Added 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

    [!Note] Chart Aggregation will not work when using IncludedProperties | ExcludedProperties. These properties on the chart are meant for non-aggregated data. Once you attempt to aggregate data these properties should no longer be used. The reason it does not work is because aggregation replaces the collection that is passed to the chart for render. The include/exclude properties are designed to filter in/out properties of that data and those properties no longer exist in the new aggregated collection.

    IgniteUI.Blazor (Data Grid)

    22.1.41 (June 2022)

    IgniteUI.Blazor (Charts)

    • Added the highly-configurable DataLegend component, which works much like the Legend, but it shows values of series and provides many configuration properties for filtering series rows and values columns, styling and formatting values.
    • Added the highly-configurable DataToolTip which displays values and titles of series as well as legend badges of series in a tooltip. This is now the default tooltip for all chart types.
    • Added animation and transition-in support for Stacked Series. Animations can be enabled by setting the 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 IgbDataChart. 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.
    • 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. IgbNumericXAxis, IgbNumericYAxis, 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.Blazor (Data Grid)

    Added New Feature - Row Paging which is used to split a large set of data into a sequence of pages that have similar content. With pagination, data can be displayed in a set number of rows, letting users “scroll” through their data, without needing a scroll bar. The UI for table pagination usually includes things like the current page, total pages, and clickable Previous and Next arrows/buttons that let users flip through the pages of data.

    IgniteUI.Blazor (Dock Manager)

    • The Blazor Dock Manager is now in "Preview" state, that provides a way to manage a complex layout using different type of panes with various sizes, positions, and behaviors, and that can be docked to various locations within an app. The Dock Manager allows your end-users to customize it further by pinning, resizing, moving, floating, and hiding panes.

    New Components

    21.2.52 (December 2021)

    [!Note] The following breaking changes were introduced

    IgniteUI.Blazor (Data Grid)

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

    IgniteUI.Blazor (Inputs)

    • A new ValueChanged event supports 2-way binding and should only be handled if you have not bound the Value property. In order to read the Value field from the control without databinding the ValueChanged event should be handled, otherwise if your data is not bound you should use GetCurrentValueAsync to read the controls Value.

    Date Picker

    • Changed ValueChanged event to SelectedValueChanged.

    Multi-Column ComboBox

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

    21.2.22 (November 2021)

    [!Note] The Igb prefix is now required for the Ignite UI for Blazor components and nested elements within each component. This API change was necessary to avoid ambiguity between Infragistics controls and 3rd party controls.

    For example, <CategoryChart/> instead of <CategoryChart/>

    New Components

    Chart and Map Improvements

    This release introduces a few improvements and simplifications to visual design and configuration options for the geographic map and all chart components.

    Old brushes/outlines New outline/brushes
    #8BDC5C
    #8B5BB1
    #6DB1FF
    #F8A15F
    #EE5879
    #735656
    #F7D262
    #8CE7D9
    #E051A9
    #A8A8B7    		 #8BDC5C
    #8961A9
    #6DB1FF
    #82E9D9
    #EA3C63
    #735656
    #F8CE4F
    #A8A8B7
    #E051A9
    #FF903B

    IgniteUI.Blazor (Data Grid)

    • New Features Added:
    • New API:
      • Added 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

    21.1.52 (April 2021)

    New Visual Designs

    Charts & Maps

    This release introduces several new and improved visual design and configuration options for all of the chart components, e.g. IgbDataChart, IgbCategoryChart, and IgbFinancialChart.

    • Changed Bar/Column/Waterfall series to have square corners instead of rounded corners
    • Changed Scatter High Density series’ colors for heat min property from #8a5bb1 to #000000
    • Changed Scatter High Density series’ colors for heat max property from #ee5879 to #ee5879
    • Changed Financial/Waterfall series’ 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 IgbPointSeries, IgbBubbleSeries, IgbScatterSeries, IgbPolarScatterSeries. You can use set MarkerFillMode property to Normal to undo this change
    • Compressed labelling for the IgbTimeXAxis and IgbOrdinalTimeXAxis
    • 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:
    • 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:
    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 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

    Geographic Map

    [!Note] These features are CTP

    • Added support for wrap around display of the map (scroll infinitely horizontally)
    • Added support for shifting display of some map series while wrapping around the coordinate origin
    • Added support for highlighting of the shape series
    • Added support for some annotation layers for the shape series

    IgniteUI.Blazor (Data Grid)

    • Added 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 EnterKeyBehaviors 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 EnterKeyBehaviorAfterEdit 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 up/down 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.Blazor (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