Repository navigation
General
- Browser support - The minimum supported browser versions are now documented: Chrome and Edge 131, Firefox 151, and Safari 18 on macOS and iOS. The component styles rely on CSS container style queries and relative colors, so older browsers, including Firefox ESR 140, are not supported. See the Browser Support section of the README.
IgxHierarchicalGridComponent- Deprecation - The
schemainput has been deprecated and will be removed in a future version. Define the columns and the row islands of the grid instead, the advanced filtering schema is generated from them. Aschemathat is set is still used as before.
- Deprecation - The
New Functionality
IgxTabsComponent- Added the
headerPositioninput, which places the tab headers above the content (top, the default) or in a column before (start) or after (end) it in the text direction, sostartis on the right in right-to-left layouts. In a column, the headers are navigated with the Up and Down arrow keys and scroll when they do not fit in the height of the tabs.<igx-tabs headerPosition="start">...</igx-tabs>
- Added the
IgxCalendarComponent- Added the
igxCalendarDaytemplate directive and thedayTemplateinput to customize the content of the day cells, e.g. to show event indicators, availability or prices. The template receives the date and the day states (selected,disabled,special,today,weekend,currentMonth,activeand the range states) through theIgxCalendarDayTemplateContext. The day cells keep their selection, keyboard navigation, ARIA attributes and theme styling.IgxDatePickerComponentandIgxDateRangePickerComponentpass anigxCalendarDaytemplate to their calendar.
- Added the
IgxGridComponent,IgxTreeGridComponent,IgxHierarchicalGridComponent- Added the
validationTooltipTriggerinput, which controls when the validation error tooltip of an invalid cell is displayed. With the defaultactivevalue the tooltip is shown when an invalid cell becomes active and on error icon hover, as before. Withhoverit is shown only while hovering the error icon, while the invalid state, the error icon and the invalid styles are kept.<igx-grid [data]="data" validationTooltipTrigger="hover"></igx-grid>
- Added the
IgxDragDirective- Added
cancelDrag()method that cancels the drag in progress without dropping. The element returns to where it was before the drag, and a drop area under the dragged element receives only aleaveevent. - Added
cancelOnEscapeinput (defaultfalse). When set totrue, pressingEscapewhile dragging cancels the drag. IDragBaseEventArgshas a newcancelledproperty, which istruefor thedragEndandtransitionedevents of a canceled drag. If your app moves or reorders items in adragEndortransitionedhandler, checkcancelledthere and restore the original state instead. CalltransitionToOrigin()in thedragEndhandler to animate the element back.
- Added
IgxChipComponent,IgxChipsAreaComponent- For a canceled chip drag (e.g. with
chip.dragDirective.cancelDrag()),originalEvent.cancelledof themoveEndevent istrue.
- For a canceled chip drag (e.g. with
IgxQueryBuilderComponent- Pressing
Escapewhile dragging a condition with the mouse now cancels the drag. The condition stays where it was and is not dropped when the mouse button is released.
- Pressing
Themes
- Breaking Change - Updated to Ignite UI Theming 30.0.0. The
palette()function builds palettes with the newfittedgenerator by default, which places every shade by contrast and emits it as a fixed color. The predefined palettes and the pre-built themes keep thelegacygenerator and are unchanged.ng updateadds$generator: 'legacy'to existingpalette()calls, so they keep the colors they produced before. Remove the argument to switch a palette to thefittedgenerator.- The deprecated
light-theme,dark-theme, and the other deprecated theme wrapper mixins build their palettes with thelegacygenerator.
- Breaking Change - Component themes take their background from the
basesurface role,--ig-surface-base, instead of--ig-surface-500. Override the surface roles (--ig-surface-base,--ig-surface-raised,--ig-surface-overlay,--ig-surface-sunken,--ig-surface-container) instead of--ig-surface-500to change the surface at runtime.- The numbered surface shades, such as
--ig-surface-500, are deprecated and will be removed in a future release. Palettes still emit them under both generators, and in afittedpalette--ig-surface-500points to--ig-surface-base.
- The numbered surface shades, such as
- Behavioral Change -
tokens($theme, $mode: 'scoped')included inside a selector no longer declares the component tokens on that selector itself, unless it is the component. The tokens go on the component inside the selector and, through:where(), on the selector when it also matches the component, so.my-avataron anigx-avatarelement is still themed with the same specificity. Previously the selector always received the tokens, and generic tokens such as--backgroundwere inherited by every element below it.- To override a component's tokens for a whole section of a page, use the default global mode instead:
.promo { @include tokens(tooltip-theme($background: red)); }only declares--ig-tooltip-*tokens, which no other component reads. - Section tokens don't reach the components rendered inside a Grid, Query Builder, Excel Filtering, Column Actions, Paginator or Grid Toolbar. These derive the tokens of their inner components (checkboxes, chips, buttons, inputs, tooltips, etc.) from their own theme and declare them on their host. Each inner component follows one or more of the parent's
$background,$foregroundand$accent-color, sogrid-theme($accent-color: red)recolors the grid's checkboxes, badges and buttons, but not its tooltips, which follow$foreground. To change one inner component, target it:.promo .igx-tooltip { @include tokens(tooltip-theme($background: red)); }.
- To override a component's tokens for a whole section of a page, use the default global mode instead:
- Including the theme inside a class (
.dark-theme { @include theme(...); }) now produces the same styles as including it at the root:- The cascade layer order (
@layer ig.reset, ig.base, ig.<theme>, ig.derived;) is declared at the stylesheet root. Inside the class, browsers dropped it and the layers were ordered by first appearance. - The tooltip, button, icon button, ripple, label, overlay, highlight, rating, dock manager, watermark and chart tokens are no longer declared on the class itself. Previously every element in the class inherited them, so, for example, the grid and its toolbar took the tooltip background.
- The cascade layer order (
- Fixed components losing styles when a theme they depend on is excluded through
$exclude. For example, excludingigx-labelno longer leaves the label of a textarea input group stuck to its top border. Such themes are now kept when a component you still include needs them, with a warning that tells you which one.igx-simple-comboandigx-accordioncan also be excluded now. - The grid, grid toolbar, paginator, column actions, Excel-style filtering and query builder themes no longer pick up
--background,--foregroundor--accent-colordeclared on an ancestor or on:root, for example by the application's own CSS. Their themes now declare these tokens on the component, without a value unless one is passed to the theme function.
Behavioral Changes
IgxCarouselComponentstop()is now a no-op when the carousel is not playing, socarouselPausedis no longer emitted for an already stopped carousel, for example on everymouseenteror when navigating with the keyboard past the first or last slide of a non-looping carousel.- The carousel starts playing automatically only once, when its slides are initialized. Adding or removing slides no longer resumes a carousel that was stopped, unless its automatic rotation ended on the last slide of a non-looping carousel.
- The
aria-liveregion of the slides is nowoffonly while the carousel is rotating automatically. Previously it stayedoffwhenever anintervalwas set, even afterstop()was called or a non-looping carousel reached its last slide. - The automatic rotation of a non-looping carousel now ends on its last slide also when
pauseisfalse:isPlayingbecomesfalseandcarouselPausedis emitted. Previously the carousel kept playing on the last slide. - Touch gestures now follow the carousel orientation: a vertical carousel sets
touch-action: pan-xinstead ofpan-y, drags across the carousel axis are left to the browser for scrolling and no longer resume a carousel paused by a tap, and a pan starts only after the touch moves at least 5px, the distance below which it is recognized as a tap.
IgxSplitterComponent- Arrow keys combined with
Shift,AltorMeta, andCtrl+ arrow keys combined with another modifier, no longer resize or collapse the panes. The splitter bar ignores them, and the browser default runs. Previously the splitter bar ignored the extra modifiers and handled these keys as the plain arrow keys orCtrl+ arrow keys. - Resizing panes with the arrow keys now updates the pane
sizeand emitsresizeStart,resizingandresizeEndfor each key press, as a pointer drag does. Previously only a temporary size was applied,resizeEndwas not emitted and percentage orautosized panes no longer adjusted to the splitter size.
- Arrow keys combined with
IgxStepperComponent- In linear mode, the steps after the first invalid step that is not
optionalordisabledare disabled, wherever the active step is, as in the Ignite UI for Web Components stepper. Previously only the active step and the steps after it were checked, so an invalidoptionalactive step disabled the steps after it, and an invalid step before the active one did not. The disabled steps are also recalculated when theoptionalstate of a step changes, and the step activated withnavigateToor itsactiveproperty is no longer displayed as disabled. - The vertical animations now use the default
animationDurationof320milliseconds instead of350.animationDurationalso falls back to320instead of350when it is set to a value that is not a positive number.
- In linear mode, the steps after the first invalid step that is not
IgxTabsComponent- A selected tab header that is wider than the visible area of the headers is now scrolled so that its start is visible. Previously it was scrolled so that its end was visible.
IgxTimePickerComponent- When
localeis not set, the picker now follows the global locale set withsetCurrentI18nand updates its default formats and resource strings when it changes, as the date picker does. Previously it kept the locale it was created with. clear()with aDatevalue now assigns a newDatewith its time reset to00:00:00and notifiesngModeland reactive form controls. Previously it changed the boundDateobject in place, so forms were not updated or re-validated.
- When
Bug Fixes
- Forms
IgxSnackbarComponent- The default action button now renders withtype="button". Previously, when the snackbar was inside aform(for example as part of a grid), it became the default button of the form, so pressing Enter in any input of the form clicked it, which triggered the snackbar action and submitted the form.IgxQueryBuilderComponent- The add expression and the group (AND/OR) buttons now render withtype="button". Previously, clicking them inside aformsubmitted it. Pressing Enter in the query builder inputs also no longer submits a surroundingform.IgxGridComponent,IgxTreeGridComponent,IgxHierarchicalGridComponent,IgxPivotGridComponent- Pressing Enter in the grid UI, such as the filtering row, cell and row editors, the toolbar column hiding and pinning, Excel-style filtering and advanced filtering, as well as selecting a date in their date pickers with Enter, no longer submits a surroundingform.IgxAdvancedFilteringDialogComponent,IgxColumnActionsComponent,IgxPivotDataSelectorComponent- Pressing Enter in their inputs no longer submits a surroundingformwhen they are rendered outside of the grid, e.g. used standalone, or the advanced filtering dialog opened with custom overlay settings.
IgxAccordionComponent- When
singleBranchExpandis set initially and the panels are rendered with@for, the panels collapsed on init no longer keeparia-expanded="true"and noExpressionChangedAfterItHasBeenCheckedErroris thrown in development mode.
- When
IgxCarouselComponent- After slides are added or removed, the
aria-labelledbyof the slides now references the matching indicator. - Destroying the carousel right after it is created no longer leaves an auto-play interval running.
- Enabling
gesturesSupportafter the carousel is initialized now enables the touch gestures. - Touch pans no longer leave slides partially moved or visible behind the current slide, for example when a pan is cancelled, reversed past the first or last slide of a non-looping carousel, released as a tap, or interrupted by removing slides or changing
gesturesSupportorvertical. - Panning a carousel without slides no longer throws an error, and panning a carousel with a single slide no longer moves the slide against itself.
- A slide activated through its
activeproperty now animates in the direction of its position, or in its owndirectionwhen one is set.
- After slides are added or removed, the
IgxCircularProgressBarComponent,IgxLinearProgressBarComponent- In Safari, the initial animation no longer overshoots the value and then crawls back to it. The initial fill and later value changes now use the same transition, so a value that changes while the bar is still animating goes straight to the new value in every browser. The Bootstrap circular bar now also animates its initial fill in RTL.
IgxCsvExporterService- Exporting a grid with summaries no longer adds an extra
GRID_LEVEL_COLcolumn with the nesting level of each record. Only the grid's columns are exported, as with the Excel and PDF exporters.
- Exporting a grid with summaries no longer adds an extra
IgxDatePickerComponent- Opening the calendar from the default icon no longer briefly selects the input value in the
inputFormat(e.g.09/15/2026). As withigx-picker-toggle, the icon click no longer propagates to the picker's ancestors. - The calendar receives the focus as soon as it starts opening instead of after the opening animation.
- The default browser action of
Alt + Arrow DownandAlt + Arrow Up, which open and close the calendar, is now prevented. - Destroying the picker while its calendar is open no longer logs
igxOverlay.detach was called with wrong idin the console. In the grid, this happened whenever a date cell edit ended while the calendar was open.
- Opening the calendar from the default icon no longer briefly selects the input value in the
IgxDateRangePickerComponentAlt + Arrow DownandAlt + Arrow Up, which open and close the calendar, no longer scroll the page. Previously their default browser action was not prevented.- Destroying the picker while its calendar is open no longer logs
igxOverlay.detach was called with wrong idin the console.
IgxDragDirectivetransitionToOrigin()with a start location equal to the origin location no longer animates. Previously the vertical start position was compared with the horizontal origin.transitionToOrigin()andtransitionTo()now emittransitionedright away when the element is already at the target or there is no ghost to animate (e.g. its creation was canceled inghostCreate). Previously notransitionedwas emitted and the next drag did not start correctly.
IgxExpansionPanelComponentAlt + Arrow DownandAlt + Arrow Upno longer expand or collapse the panel when its header is disabled.
IgxFilterDirective,IgxFilterPipe- When filtering by multiple keys, an item matched by any of the keys is no longer hidden when the last key does not match, and
metConditionFn/overdueConditionFnare called once per item instead of once per key. - Items whose
keyproperty has a falsy value, such as0orfalse, are now matched by that value instead of the item's text content. - The directive now filters the items again when the
inputValuechanges toundefined, so all items are shown when the input is cleared. A custommatchFnnow always receives a string, with an empty string passed wheninputValueisnullorundefined. TheIgxFilterOptions.inputValuetype now includesnullandundefined. - The pipe now returns the items as they are, instead of
undefined, when they are empty,nullorundefined, or when no options are provided. Thefilteredevent now emits an emptyfilteredItemsarray for empty items.
- When filtering by multiple keys, an item matched by any of the keys is no longer hidden when the last key does not match, and
IgxFocusTrapDirective,IgxDialogComponent- Tab and Shift+Tab no longer get stuck on elements that cannot receive focus. Hidden inputs, elements that are not rendered or are invisible, elements with a negative
tabindex, and elements inside a disabledfieldsetor aninertcontainer are now skipped. Thesummaryof adetailselement andcontenteditableediting hosts are now focused. - When the focused element is not part of the tab order (e.g. an element with
tabindex="-1"or a focused shadow host), Tab and Shift+Tab now move focus to the next or previous focusable element instead of the first or last one. - The keydown listener is now removed when the directive is destroyed.
- Tab and Shift+Tab no longer get stuck on elements that cannot receive focus. Hidden inputs, elements that are not rendered or are invisible, elements with a negative
IgxForOfDirective- Growing the container of a virtualized list or grid scrolled to its end (for example by resizing the grid) no longer renders the rows or columns out of order or shifts the visible content by one item (#17575).
- In right-to-left direction, changing the items of a horizontally scrolled
igxForno longer moves the visible items away from the scroll position. - Grids and other horizontally virtualized
igxForinstances no longer throwReferenceError: window is not definedduring server-side rendering (#17927).
IgxGridComponent,IgxTreeGridComponent,IgxHierarchicalGridComponent,IgxPivotGridComponent- The grid scrollbars use the theme's scrollbar colors again. Unless the grid theme had a
$background, the derived scrollbar track color was invalid and the browser's default scrollbar was shown. - Restored the style recalculation performance of 21.2.x in Chromium-based browsers. The grid, Excel-style filtering and query builder themes no longer use multi-selector
:where()lists as rule subjects, which Chromium matched against every element on each style recalculation. The styles are otherwise unchanged. - Filtering, grouping, editing and toggling
isLoadingno longer add and remove the stylesheets of the badge, chip, checkbox, input group, date picker and circular progress bar components, which forced a restyle of the whole page each time. The grid now keeps these stylesheets for the application's lifetime. As a result, the first grid in an application uses up one auto-generatedidof the badge, chip, checkbox, date picker and circular progress bar (includingigx-circular-gradient-N), so instances created after it get anidone higher than before. Later grids do not shift the ids further. - Pressing
Escapewhile dragging a column header over the group-by area no longer groups by that column. A column move canceled withEscapeor in acolumnMovinghandler also no longer prevents the next column move from being dropped.
- The grid scrollbars use the theme's scrollbar colors again. Unless the grid theme had a
IgxGridComponent,IgxTreeGridComponent,IgxHierarchicalGridComponent- Autosizing a column with quick filtering enabled now fits its content and filtering chip, instead of keeping its current width or growing by 1px on each call with fractional scaling.
- A single filter chip whose label is longer than the column now shrinks to the filter cell and truncates its label with an ellipsis instead of being clipped by the cell. The condition and remove icons keep their size; only a column narrower than the icons still clips the chip. The "more filters" indicator no longer shows its icon while it is hidden.
- Pinned filter row cells use the pinned border, row action cells use the header border width, and selected cells and columns no longer show stray borders.
- Destroying the grid while its advanced filtering dialog is open no longer logs
igxOverlay.detach was called with wrong idin the console.
IgxGridComponent- Autosizing a child column of a column layout now fits its content, instead of keeping the width of its layout area.
- When grouping is applied and no column is pinned at the start, the group-by indentation and the summary area below it use the pinned border.
- Multi-row layout cell borders stay visible when the row is hovered or selected.
IgxHierarchicalGridComponent- The advanced filtering dialog now lists the nested row islands of a row island whose child data is not available yet, e.g. when it is loaded on demand. Previously they were left out when the first record had no child data.
- The fields of an auto-generated row island in the advanced filtering dialog are updated when its child grids generate their columns, e.g. when the child data is loaded on demand, and take the column
header,dataTypeand formatting options set incolumnInit. The fields of its nested row islands that are still empty are resolved from the loaded child data. The child grids of a row island share its fields, so a child grid adds the fields it has columns for and does not change the type of a field that has no value in its first record. Previously they were resolved only from the first record and were empty when it had no child data. - The fields of a row island with declared columns in the advanced filtering dialog now take the column
header,filters,editorOptionsand formatting options, as the fields of the root grid do. Previously only thefieldand thedataTypewere used. - The fields in the advanced filtering dialog are updated when the columns of the root grid or of a row island are added, removed or changed after the dialog was first opened, e.g. when they are rendered conditionally or loaded later.
IgxTreeGridComponent- Setting
databefore the grid is initialized whileautoGenerateis enabled no longer throws an error. In Ignite UI for Web Components this happened whendatawas set onigc-tree-gridbefore the element was attached to the page.
- Setting
IgxPivotGridComponent- Autosizing a column now fits its content, instead of keeping its current width.
- Ignite UI for Web Components grids
- Writable properties that are not inputs, such as
selectedofigc-columnandtotalPagesofigc-paginator, are now applied when set on the element. Previously the value was ignored and anNG0303error was logged. - The deprecated
getFilterFactorymethod is now available onigc-grid, as intended for backwards compatibility. - Icon changes broadcast from other pages now update only the icons or icon references that match the message's action type.
- Writable properties that are not inputs, such as
IgxNavigationToggleDirective,IgxNavigationCloseDirective- The
igxNavToggleandigxNavCloseinputs are now public, so they can be set in applications compiled withstrictInputAccessModifiers. Previously the inputs were private and setting them failed the template type check.
- The
IgxOverlayService- Detaching an overlay with a dynamically created component, such as the date picker calendar, no longer leaves the component visible in its original place until Angular removes it.
IgxQueryBuilderComponent- When the drag indicator of a condition is focused while another condition is dragged with the mouse,
Arrow UpandArrow Downnow move that condition once the mouse drag ends without a drop. Previously the condition could not be moved with the keyboard until the drag indicator was focused again.
- When the drag indicator of a condition is focused while another condition is dragged with the mouse,
IgxSplitterComponent- Percentage
minSizeandmaxSizevalues of the panes are now honored while resizing, as is amaxSizeof0. Previously percentages were treated as pixels and amaxSizeof0was ignored. - Dragging a splitter bar now resizes the panes to the current pointer position. Previously the panes lagged one pointer move behind.
- Releasing a dragged splitter bar now always applies the pane sizes and emits
resizeEnd, including when the pointer is released at the drag start point. - A splitter bar dragged across the resize direction no longer moves away from its position.
Ctrl+ arrow keys no longer collapse panes whennonCollapsibleis set.- Ending a resize after the splitter shrinks no longer sets negative pane sizes, including when the splitter is smaller than the
minSizeof a pane. - Keys other than the arrow keys, pressed on a splitter bar, now propagate, so for example
Escapecloses a dialog that contains the splitter. Previously the splitter bar stopped the propagation of every key. - Holding
Ctrland an arrow key on a splitter bar now collapses or expands a pane once, instead of toggling it on every repeated key press. - A splitter bar no longer loses the focus when one of its panes is collapsed, so the pane can be expanded again with
Ctrland an arrow key. - A splitter bar next to a pane that is not
resizableis now in the tab order, so the pane can be collapsed and expanded withCtrland an arrow key. The bar is removed from the tab order only when it can neither resize nor collapse its panes, that is whennonCollapsibleis set and a pane is collapsed or notresizable.
- Percentage
IgxSplitterPaneComponent- Setting
sizetonullorundefinedno longer throws an error. The pane falls back to the default'auto'size.
- Setting
IgxStepperComponent- When the steps are rendered with
@for, noExpressionChangedAfterItHasBeenCheckedErroris thrown on init in development mode, and the active step and the step indicators are rendered on init inOnPushhosts. activeChangeis no longer emitted twice for the step activated on init, or for steps bound to[active]="false"that were not active. It is now emitted for the steps whose collapse animation is interrupted by changingorientation,verticalAnimationTypeorhorizontalAnimationType.- The active step now gets
tabindex="0"when it is changed withnext,prevornavigateTo. next,prevand focusing a step no longer throw when there is no active step, e.g. when all steps are initially disabled. In that caseactiveStepChangingis emitted witholdIndexset to-1.resetkeeps the active step visited, so its invalid state is displayed after moving to another step.- Setting
animationDurationfrom code now applies it to the vertical animations as well.
- When the steps are rendered with
IgxTabsComponent- With
manualactivation, a tab header focused with the keyboard is scrolled into view. - The selected tab header is scrolled into view when hidden tabs become visible, for example in a dialog or a drop-down.
- Header content with a word longer than the header now wraps within the header instead of overflowing and being clipped on both sides. Header labels are truncated with an ellipsis after the second line.
- With
IgxTimePickerComponent- Resetting a bound form control, for example with
reset(), no longer keeps the previous time selected in the dropdown/dialog. - Setting
minValueormaxValueback tonullnow restores the full range of the dropdown/dialog, and changingitemsDeltaorinputFormatat runtime now updates it and the selected time. - Loosening or removing
minValueormaxValuewhile the dropdown/dialog is open now selects the time of the picker value, or the time picked but not yet confirmed, again. Previously the time clamped by the earlierminValueormaxValuestayed selected (#17845). - The dialog header and the dropdown/dialog lists now update when the locale, format or
spinLoopchange while the picker is open. - A value or
minValuethat does not matchitemsDeltais now rounded up to the next available item, for example10:58with a minutes delta of7selects11:00instead of11:03. When rounding up passes the last available item, the last item is selected. - Switching from AM to PM in the dropdown/dialog no longer selects a time later than
maxValue. - The
outletinput is now applied to the dropdown/dialog. - The dialog header no longer throws a missing locale data error for a
localewithout registered Angular locale data whenprovideIgniteIntl()is used. - The
aria-valueminandaria-valuemaxof the selected seconds item no longer depend on the milliseconds of the value. - The default browser action of
Alt + Arrow DownandAlt + Arrow Up, which open and close the drop-down, is now prevented.
- Resetting a bound form control, for example with
Supply chain
npm audit reported no known vulnerabilities in the delivered dependencies.
Build-environment SBOM diagnostics (best-effort)
The build-environment CycloneDX SBOM is a best-effort inventory of the repository toolchain. npm dependency-tree errors are tolerated there and do not affect the delivered-package SBOM.
npm ls exited with status 1.
invalid: chokidar@5.0.0
code ELSPROBLEMS