Skip to content

22.3.0

Latest

Choose a tag to compare

@ChronosSF ChronosSF released this 17 Nov 16:03
· 6 commits to master since this release
6b81241

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 schema input 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. A schema that is set is still used as before.

New Functionality

  • IgxTabsComponent
    • Added the headerPosition input, 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, so start is 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>
  • IgxCalendarComponent
    • Added the igxCalendarDay template directive and the dayTemplate input 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, active and the range states) through the IgxCalendarDayTemplateContext. The day cells keep their selection, keyboard navigation, ARIA attributes and theme styling. IgxDatePickerComponent and IgxDateRangePickerComponent pass an igxCalendarDay template to their calendar.
  • IgxGridComponent, IgxTreeGridComponent, IgxHierarchicalGridComponent
    • Added the validationTooltipTrigger input, which controls when the validation error tooltip of an invalid cell is displayed. With the default active value the tooltip is shown when an invalid cell becomes active and on error icon hover, as before. With hover it 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>
  • 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 a leave event.
    • Added cancelOnEscape input (default false). When set to true, pressing Escape while dragging cancels the drag.
    • IDragBaseEventArgs has a new cancelled property, which is true for the dragEnd and transitioned events of a canceled drag. If your app moves or reorders items in a dragEnd or transitioned handler, check cancelled there and restore the original state instead. Call transitionToOrigin() in the dragEnd handler to animate the element back.
  • IgxChipComponent, IgxChipsAreaComponent
    • For a canceled chip drag (e.g. with chip.dragDirective.cancelDrag()), originalEvent.cancelled of the moveEnd event is true.
  • IgxQueryBuilderComponent
    • Pressing Escape while 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.

Themes

  • Breaking Change - Updated to Ignite UI Theming 30.0.0. The palette() function builds palettes with the new fitted generator by default, which places every shade by contrast and emits it as a fixed color. The predefined palettes and the pre-built themes keep the legacy generator and are unchanged.
    • ng update adds $generator: 'legacy' to existing palette() calls, so they keep the colors they produced before. Remove the argument to switch a palette to the fitted generator.
    • The deprecated light-theme, dark-theme, and the other deprecated theme wrapper mixins build their palettes with the legacy generator.
  • Breaking Change - Component themes take their background from the base surface 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-500 to 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 a fitted palette --ig-surface-500 points to --ig-surface-base.
  • 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-avatar on an igx-avatar element is still themed with the same specificity. Previously the selector always received the tokens, and generic tokens such as --background were 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, $foreground and $accent-color, so grid-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)); }.
  • 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.
  • Fixed components losing styles when a theme they depend on is excluded through $exclude. For example, excluding igx-label no 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-combo and igx-accordion can also be excluded now.
  • The grid, grid toolbar, paginator, column actions, Excel-style filtering and query builder themes no longer pick up --background, --foreground or --accent-color declared 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

  • IgxCarouselComponent
    • stop() is now a no-op when the carousel is not playing, so carouselPaused is no longer emitted for an already stopped carousel, for example on every mouseenter or 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-live region of the slides is now off only while the carousel is rotating automatically. Previously it stayed off whenever an interval was set, even after stop() 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 pause is false: isPlaying becomes false and carouselPaused is emitted. Previously the carousel kept playing on the last slide.
    • Touch gestures now follow the carousel orientation: a vertical carousel sets touch-action: pan-x instead of pan-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, Alt or Meta, and Ctrl + 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 or Ctrl + arrow keys.
    • Resizing panes with the arrow keys now updates the pane size and emits resizeStart, resizing and resizeEnd for each key press, as a pointer drag does. Previously only a temporary size was applied, resizeEnd was not emitted and percentage or auto sized panes no longer adjusted to the splitter size.
  • IgxStepperComponent
    • In linear mode, the steps after the first invalid step that is not optional or disabled are 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 invalid optional active step disabled the steps after it, and an invalid step before the active one did not. The disabled steps are also recalculated when the optional state of a step changes, and the step activated with navigateTo or its active property is no longer displayed as disabled.
    • The vertical animations now use the default animationDuration of 320 milliseconds instead of 350. animationDuration also falls back to 320 instead of 350 when it is set to a value that is not a positive number.
  • 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 locale is not set, the picker now follows the global locale set with setCurrentI18n and 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 a Date value now assigns a new Date with its time reset to 00:00:00 and notifies ngModel and reactive form controls. Previously it changed the bound Date object in place, so forms were not updated or re-validated.

Bug Fixes

  • Forms
    • IgxSnackbarComponent - The default action button now renders with type="button". Previously, when the snackbar was inside a form (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 with type="button". Previously, clicking them inside a form submitted it. Pressing Enter in the query builder inputs also no longer submits a surrounding form.
    • 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 surrounding form.
    • IgxAdvancedFilteringDialogComponent, IgxColumnActionsComponent, IgxPivotDataSelectorComponent - Pressing Enter in their inputs no longer submits a surrounding form when they are rendered outside of the grid, e.g. used standalone, or the advanced filtering dialog opened with custom overlay settings.
  • IgxAccordionComponent
    • When singleBranchExpand is set initially and the panels are rendered with @for, the panels collapsed on init no longer keep aria-expanded="true" and no ExpressionChangedAfterItHasBeenCheckedError is thrown in development mode.
  • IgxCarouselComponent
    • After slides are added or removed, the aria-labelledby of the slides now references the matching indicator.
    • Destroying the carousel right after it is created no longer leaves an auto-play interval running.
    • Enabling gesturesSupport after 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 gesturesSupport or vertical.
    • 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 active property now animates in the direction of its position, or in its own direction when one is set.
  • 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_COL column with the nesting level of each record. Only the grid's columns are exported, as with the Excel and PDF exporters.
  • IgxDatePickerComponent
    • Opening the calendar from the default icon no longer briefly selects the input value in the inputFormat (e.g. 09/15/2026). As with igx-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 Down and Alt + 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 id in the console. In the grid, this happened whenever a date cell edit ended while the calendar was open.
  • IgxDateRangePickerComponent
    • Alt + Arrow Down and Alt + 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 id in the console.
  • IgxDragDirective
    • transitionToOrigin() with a start location equal to the origin location no longer animates. Previously the vertical start position was compared with the horizontal origin.
    • transitionToOrigin() and transitionTo() now emit transitioned right away when the element is already at the target or there is no ghost to animate (e.g. its creation was canceled in ghostCreate). Previously no transitioned was emitted and the next drag did not start correctly.
  • IgxExpansionPanelComponent
    • Alt + Arrow Down and Alt + Arrow Up no 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 / overdueConditionFn are called once per item instead of once per key.
    • Items whose key property has a falsy value, such as 0 or false, are now matched by that value instead of the item's text content.
    • The directive now filters the items again when the inputValue changes to undefined, so all items are shown when the input is cleared. A custom matchFn now always receives a string, with an empty string passed when inputValue is null or undefined. The IgxFilterOptions.inputValue type now includes null and undefined.
    • The pipe now returns the items as they are, instead of undefined, when they are empty, null or undefined, or when no options are provided. The filtered event now emits an empty filteredItems array for empty items.
  • 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 disabled fieldset or an inert container are now skipped. The summary of a details element and contenteditable editing 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.
  • 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 igxFor no longer moves the visible items away from the scroll position.
    • Grids and other horizontally virtualized igxFor instances no longer throw ReferenceError: window is not defined during 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 isLoading no 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-generated id of the badge, chip, checkbox, date picker and circular progress bar (including igx-circular-gradient-N), so instances created after it get an id one higher than before. Later grids do not shift the ids further.
    • Pressing Escape while dragging a column header over the group-by area no longer groups by that column. A column move canceled with Escape or in a columnMoving handler also no longer prevents the next column move from being dropped.
  • 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 id in 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, dataType and formatting options set in columnInit. 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, editorOptions and formatting options, as the fields of the root grid do. Previously only the field and the dataType were 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 data before the grid is initialized while autoGenerate is enabled no longer throws an error. In Ignite UI for Web Components this happened when data was set on igc-tree-grid before the element was attached to the page.
  • 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 selected of igc-column and totalPages of igc-paginator, are now applied when set on the element. Previously the value was ignored and an NG0303 error was logged.
    • The deprecated getFilterFactory method is now available on igc-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.
  • IgxNavigationToggleDirective, IgxNavigationCloseDirective
    • The igxNavToggle and igxNavClose inputs are now public, so they can be set in applications compiled with strictInputAccessModifiers. Previously the inputs were private and setting them failed the template type check.
  • 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 Up and Arrow Down now 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.
  • IgxSplitterComponent
    • Percentage minSize and maxSize values of the panes are now honored while resizing, as is a maxSize of 0. Previously percentages were treated as pixels and a maxSize of 0 was 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 when nonCollapsible is set.
    • Ending a resize after the splitter shrinks no longer sets negative pane sizes, including when the splitter is smaller than the minSize of a pane.
    • Keys other than the arrow keys, pressed on a splitter bar, now propagate, so for example Escape closes a dialog that contains the splitter. Previously the splitter bar stopped the propagation of every key.
    • Holding Ctrl and 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 Ctrl and an arrow key.
    • A splitter bar next to a pane that is not resizable is now in the tab order, so the pane can be collapsed and expanded with Ctrl and an arrow key. The bar is removed from the tab order only when it can neither resize nor collapse its panes, that is when nonCollapsible is set and a pane is collapsed or not resizable.
  • IgxSplitterPaneComponent
    • Setting size to null or undefined no longer throws an error. The pane falls back to the default 'auto' size.
  • IgxStepperComponent
    • When the steps are rendered with @for, no ExpressionChangedAfterItHasBeenCheckedError is thrown on init in development mode, and the active step and the step indicators are rendered on init in OnPush hosts.
    • activeChange is 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 changing orientation, verticalAnimationType or horizontalAnimationType.
    • The active step now gets tabindex="0" when it is changed with next, prev or navigateTo.
    • next, prev and focusing a step no longer throw when there is no active step, e.g. when all steps are initially disabled. In that case activeStepChanging is emitted with oldIndex set to -1.
    • reset keeps the active step visited, so its invalid state is displayed after moving to another step.
    • Setting animationDuration from code now applies it to the vertical animations as well.
  • IgxTabsComponent
    • With manual activation, 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.
  • IgxTimePickerComponent
    • Resetting a bound form control, for example with reset(), no longer keeps the previous time selected in the dropdown/dialog.
    • Setting minValue or maxValue back to null now restores the full range of the dropdown/dialog, and changing itemsDelta or inputFormat at runtime now updates it and the selected time.
    • Loosening or removing minValue or maxValue while 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 earlier minValue or maxValue stayed selected (#17845).
    • The dialog header and the dropdown/dialog lists now update when the locale, format or spinLoop change while the picker is open.
    • A value or minValue that does not match itemsDelta is now rounded up to the next available item, for example 10:58 with a minutes delta of 7 selects 11:00 instead of 11: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 outlet input is now applied to the dropdown/dialog.
    • The dialog header no longer throws a missing locale data error for a locale without registered Angular locale data when provideIgniteIntl() is used.
    • The aria-valuemin and aria-valuemax of the selected seconds item no longer depend on the milliseconds of the value.
    • The default browser action of Alt + Arrow Down and Alt + Arrow Up, which open and close the drop-down, is now prevented.

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