9.0.0 (2021-12-01)

BREAKING CHANGES

Theming

CSS custom properties mode for theming is enabled by default since Angular dropped support for Internet Explorer and also removed the ability to use node-sass to compile sass. Read details and how to opt-out here. This change doesn't affect users who use prebuilt Nebular themes. For prebult themes users we also ship prebuilt themes with custom properties. See usage guide here.

API changes

• @nebular/theme/styles/_components.scss file removed. Replace imports from this files with:

  @import '@nebular/theme/styles/theming';
  @import '@nebular/theme/styles/themes';
  

• layout-window-mode-max-width, tabset-tab-text-hide-breakpoint, route-tabset-tab-text-hide-breakpoint theme properties removed. Migration guide.
• overlay trigger: NbTriggerStrategyBase's isNotOnHostOrContainer, isOnHostOrContainer, isOnHost, isOnContainer methods now expect Element instead of Event as the first parameter. Pass event.target as Element instead of event.
• sidebar:
  • NbSidebarComponent.toggleResponsive method removed. Change method call to sidebar.responsive = !sidebar.responsive.
  • STATE_EXPANDED, STATE_COLLAPSED, STATE_COMPACTED static properties removed. Use NbSidebarState type values ('expanded', 'collapsed', 'compacted').
  • RESPONSIVE_STATE_MOBILE, RESPONSIVE_STATE_TABLET, RESPONSIVE_STATE_PC static properties removed. Use NbSidebarResponsiveState type values ('mobile', 'tablet', 'pc').
• router tabset:
  • NbRouteTabsetComponent.tabs property type changed from any to NbRouteTab.
  • NbRouteTabsetComponent.changeTab property type changed from EventEmitter<any> to EventEmitter<NbRouteTab>.
  • tab parameter type of the NbRouteTabsetComponent.selectTab method changed from any to NbRouteTab.
• infinite list: NbScrollableContainerDimentions class renamed to NbScrollableContainerDimensions. Use updated class name.
• auth: NbOAuth2AuthStrategy.buildAuthHeader return type changed from any to HttpHeaders | undefined. If the method is overridden in a derived class, update its return type as well.
• autocomplete: focusInputOnValueChange property removed from NbAutocompleteDirective class. Now autocomplete focuses input only when value is selected by option click or via keyboard.
• range-picker:
  • NbRangepickerComponent's min, max properties are expecting Date (or moment if using moment adapter) type. filter function parameter also corrected to Date.
  • NbDatepicker now a has second generic D to use for min, max, and filter arguments. It should be set to Date or moment type.
• context menu: Context menu won't close on menu item click if trigger strategy is set to noop (nbContextMenuTrigger="noop").

Other

• Minimal required Angular version is 13

Features

• auth: ability to add additional request headers (#2825) (3959848)
• chat: ability to provide template as chat title (#2920) (9ccec64)
• date-time picker: ability to remove now button (#2848) (a2c9d10)
• date-time picker: add dateTimeChange output (#2816) (73a6b5a)
• datepicker: allow to change adjustment (#2806) (a3b5ae5)
• icon: add support for ligature icons (#2951) (b89339d)
• infinite list: threshold emissions throttling (#2948) (718dd0a)
• layout: add nbLtr and nbRtl directives (#2927) (35a7ad1)
• layout: added error message if layout not provided (#2778) (7c12874)
• router tabset: ability to configure routerLinkActiveOptions per tab (#2907) (276d610)
• select, autocomplete: ability to override options width (#2874) (e30e00c)
• stepper: add step change event (#2779) (1b871f4)
• tabset: ability to provide template as tab label (#2829) (d56a492)
• theme: enable CSS custom properties mode by default (#2965) (3a88e9b)
• theme: add prebuilt themes with custom properties (#2977) (ff0b034)
• toastr: add onclick, onclose events (#2821) (3795905)
• tooltip, popover: add disabled property (#2841) (b7fe861)
• window: ability to hide close button (#2952) (ad64fe2)
• window: add component instance property to window ref (#2858) (fcf1a08)
• window: template as window title (#2915) (8eaf460)
• window: window may return result (#2869) (95247a4)
• update to Angular 13 (#2944) (ed8cd04)

Bug Fixes

• autocomplete: handle null and undefined values (#2814) (7753027)
• autocomplete: input focus behavior on value change (#2852) (a86da11)
• button: prevent expression changed error on icon button (#2846) (baee608)
• button group: prevent unpress in single mode button group (#2860) (4b8a430)
• chat: file drop in firefox (#2776) (07db7f5)
• checkbox: don't style user icons in checkbox (#2857) (a94a867)
• context menu: don't close on item click with noop strategy (#2875) (a76fccf)
• context menu: prevent close on expand icon click (#2923) (2b7f60c)
• datapicker: input update issue with reactive forms (#2945) (07527f8)
• flip card: prevent extra whitespace (#2854) (e8fa95b)
• focus trigger strategy: detect click out via activeElement (#2865) (1f8e0cb)
• focus trigger strategy clickout: consider click target (#2885) (a5f695a)
• moment date service: use locale format by default (#2856) (491c696)
• range-picker: correct type for min, max, filter properties (#2877) (73cdec0)
• route tabset: support icon config object (#2810) (ff00a16)
• scroll service: listen position requests right after layout created (#2949) (74d64cf)
• select: add ellipsis on selection view (#2809) (9b525f4)
• select: correctly handle reset value when multiple is on (#2815) (37a0bc2)
• select: scroll into selected option on open (#2859) (1c02e15)
• select, autocomplete: don't open overlay without options (#2930) (fca5cd1)
• tabset: lazy loading (#2827) (a51513c)
• tag list: prevent initialisation error in Universal (#2937) (e6a8ba0)
• theme: correct custom properties subtraction (#2932) (4e63abc)
• theme: set scrollbars corner color (#2943) (1447b15)
• tooltip, popover, context menu: correct physical positions in RTL (#2819) (0959935)

Code Refactoring

• overlay trigger: accept element instead event (#2974) (2137969)
• sidebar: remove deprecated properties (#2973) (0ba32cd)

<a name="8.0.0"></a>

8.0.0 (2021-06-27)

BREAKING CHANGES

• Minimal required Angular version to 12.
• Minimal required tslib version is 2.1.0.
• NbTable and NbTreeGridComponent:
  • _viewRepeater, _coalescedStyleScheduler constructor parameters are now required.
  • New parameters (_viewportRuler, _stickyPositioningListener) added to the constructor.
• chat: NbChatMessageComponent constructor now has a second parameter (NbCustomMessageService).

Bug Fixes

• button: styling for disabled anchor (#2649) (19a5b43)
• chat: double image preview (#2766) (1b3c809)
• context menu: emit destroy when component got destroyed (#2767) (5036b89)
• radio: add setDisabledState hook (#2717) (db9e556)
• scroll dispatcher: emit scroll events from cdkScrollable directive (#2714) (f715e97)
• sidebar: sidebar state observable (#2729) (dd0c88e)
• sidebar: update state when responsive setting change (#2654) (bf7e2a3)
• tag list: prevent autofocus on initial load (#2734) (8d60faf)
• timepicker: save lastInputValue when changed via form api (#2718) (74096d0)

Features

• update to Angular 12 (#2769) (5e74916)
• button group: add valueChange output (#2722) (39c610c)
• chat: add support for custom message template (#2750) (d84497c)
• chat form: add output for input change (#2735) (1bb0dfb)
• route tabset: add support for NavigationExtras options (#2753) (bcf7b65)
• tabset: add a tabId data attribute to the tab button (#2738) (5aaab17)
• timepicker: add localization config (#2719) (b9c77ce)
• window: add window buttons configuration (#2762) (9dcd40e)

<a name="7.0.0"></a>

7.0.0 (2021-01-18)

Bug Fixes

• autocomplete: update input element disabled state (#2555) (23e59ba)
• radio, select: prevent updates of destroyed component (#2617) (1ead242)
• sidebar: emit state change (#2645) (8a35e85)
• toggle: alignment of toggle switches (#2561) (09a7ba1)

Code Refactoring

• sidebar: use OnPush change detection strategy (#2646) (59daeea)
• auth: remove redundant _all.scss theme file (#2623) (09c5e91)
• autocomplete: make renderer constructor parameter required (#2621) (2cd2c78)
• overlay: add missing component class suffix (#2622) (3e20fe4)

Features

• update to Angular 11 (#2611) (847bc99)
• tag component (#2565) (bcdfcd8)
• button group component (#2473) (72bb1b3)
• deps: migrate to firebase 8 (#2584) (b7a2c6e)
• select, autocomplete: ability to change scroll strategy (#2567) (d10275b)
• autocomplete, datepicker, select, tooltip: add ability to customize overlay offset (#2628) (c1aafb9)
• checkbox: remove deprecated value input (#2618) (0380050)
• select: add custom comparator input (#2590) (1f8a57b)
• select, autocomplete: add input to set options list class (#2560) (92083e8)
• sidebar: add the ability to determine state and responsiveState (#1893) (bac0edc)
• theme: ability to add custom statuses (#2625) (3b2e903)
• toastr: remove deprecated iconPack property (#2620) (77a3519)
• tooltip, popover: remove ability to use falsy adjustment (#2619) (32ab00e)

BREAKING CHANGES

• deps:

  • Bump Angular version to 11+.
  • @nebular/fire requires @angular/fire 6.1.0+ and firebase 8.0.0+.

• sidebar: Added change detector ref constructor parameter.

• checkbox: NbCheckboxComponent.value and NbCheckboxComponent.valueChange properties removed. Use checked and checkedChange accordingly.

• autocomplete: renderer constructor parameter is now required.

• toastr: NbToastrConfig.iconPack property removed. You can set icon pack via icon property:

  const toastrConfig = {
    // ...
    icon: { icon: 'star', pack: 'eva' },
  }
  

  NbToastComponent.iconPack and NbToastComponent.iconConfig properties removed. Use icon property instead.

• tooltip, popover: Falsy adjustment values no longer become converted to NbAdjustment.NOOP, pass NbAdjustment.NOOP instead.

• theme: The document parameter in the NbViewportRulerAdapter and NbScrollDispatcherAdapter constructors is now required.

• theme: Empty string won't be converted to basic status anymore. If you used to set status properties to '' change it to 'basic'.

• theme: NbPositionedContainer renamed to NbPositionedContainerComponent.

• auth: ~@nebular/auth/styles/allfile removed. Replace ~@nebular/auth/styles/all imports with ~@nebular/auth/styles/globals.

• theme::

  • NbComponentStatus type replaced with NbComponentOrCustomStatus in following properties: NbActionComponent.badgeStatus, NbBadge.status, NbBadgeComponent.status, NbButtonComponent.status, NbAlertComponent.status, NbCardComponent.status, NbChatFormComponent.status, NbChatComponent.status, NbCheckboxComponent.status, NbFormFieldControl.status$, NbFormControlState.status, NbInputDirective.status, NbInputDirective.status%, NbSelectComponent.status, NbSelectComponent.status$, NbIconConfig.status, NbIconComponent.status, NbProgressBarComponent.status, NbRadioComponent.status, NbRadioGroupComponent.status, NbSpinnerDirective.spinnerStatus, NbSpinnerComponent.status, NbTabComponent.badgeStatus, NbToastrConfig.status, NbToggleComponent.status, NbTooltipDirective.status, NbTooltipComponent.context.status, NbUserComponent.badgeStatus. If you extended listed components replace NbComponentStatus in the property type with NbComponentOrCustomStatus.
  • NbBadgeComponent, NbButtonComponent, NbAlertComponent, NbCardComponent, NbChatComponent, NbCheckboxComponent, NbInputDirective, NbSelectComponent, NbIconComponent, NbProgressBarComponent, NbRadioComponent, NbSpinnerComponent, NbToastComponent, NbToggleComponent, NbTooltipComponent constructors now require NbStatusService as a constructor parameter. If you extended listed components, inject NbStatusService and pass it to the base class.

<a name="6.2.1"></a>

6.2.1 (2020-10-01)

Bug Fixes

• accordion: extract inner elements styles outside accordion (#2536) (9089690)
• calendar range cells: handle unset date or selectedValue (#2537) (0f20b9c)

<a name="6.2.0"></a>

6.2.0 (2020-09-25)

Bug Fixes

• build: provide ES5 code in UMD bundles (#2520) (e64bac0)
• timepicker: remove duplicate providers (#2529) (7e5e489)

Features

• datepicker: export calendar with time component (#2528) (f378492)
• add support for TypeScript 4.0 (#2523) (7b7f0a4)

Please note required @angular/cdk package version changed to 10.2.1+.

<a name="6.1.0"></a>