1.0.0 Changelog

This build introduces breaking change. Please read below.

Breaking Changes

12 Changes


6 Bug Fixes


Nov 30, 2018

Sketch template

Light Theme
Dark Theme


  • Welcome to Clarity 1.0.0! We've worked hard to get to this major milestone, and are excited about the future of Clarity! All features and changes are listed below from the beta and rc stages for an easy summary of all that changed between 0.13 and 1.0.

    This is the first release to follow our new support policy, which is to follow the Angular 7 LTS support policy as we outlined in our blog about our release and support strategy.

    To get this update, run ng update @clr/angular. The @next tag is necessary only while You can use this with any Angular CLI project, even if you've already started to work on it. You may need to run ng update @angular/core @angular/cli first to update to Angular 7.

    Refactored Tree View component (#2859)

    The Tree View component had some internal design issues that prevented fixing some important bugs. This refactoring is important to address those problems and the old tree view has been replaced. If you use Tree View in your application, review the new documentation and update your uses of it.

    Support for new checkboxes (#2782)

    The checkboxes have been overhauled to work with the new forms, and the old clr-checkbox component has been removed.

    Support new forms in login form (#2804)

    The login page template has been updated to support the new form controls, with only a slight visual difference. If you do not update to the new forms, you'll need to be sure to include the deprecated forms module in your Angular module.

    New pagination in Datagrid (#2754)

    The new datagrid pagination is a visual improvement to the original pagination that also includes a new text field for users to manually input the page they'd like to view by entering the number directly. It also was a requirement for future work in the datagrid. You can also add a new component clr-dg-page-size which will display a select box for items per page.

    Support for form resets and forced validation (#2735)

    Forms have been improved to support NgControl reset methods, and can be forced to display validation by marking them as dirty. This helps in cases where you want to force validation (such as when the user submits a form without filling in all the fields), and when you need to clear the values and reset validation.

    Set default form layout to horizontal (#2797)

    Previously, Angular forms would default to the vertical layout, which is against the desired UX default. Therefore, unless you specify a different layout it will adopt horizontal by default with Angular forms.

    Support for Angular 7 (#2729)

    This release brings Angular 7 support for Clarity, and this Clarity branch will be supported to work with Angular 7 while Angular is supported.

    Removal of Bootstrap as a dependency (#2729)

    To help Clarity not depend on Bootstrap, and to avoid having dependencies with known vulnerabilities (though we did not use the vulnerable code anywhere), we moved the Bootstrap sass files into our project. This only matters to projects that have custom themes that incorporate Bootstrap, you'll now want to now import the Bootstrap files from @clr/ui/utils/bootstrap/.

    Removal of deprecated Wizard API (#2758)

    We removed two deprecated Wizard APIs. The removed ClrWizard.prev() should be replaced with ClrWizard.previous(). The removed ClrWizard.navService.setCurrentPage(1) should be replaced with ClrWizard.navService.currentPage = 1;.

    Removal of deprecated Datagrid features (#2756)

    We removed two deprecated Datagrid APIs. The ClrDgColumnToggleButton no longer has the clrType binding, since the OK button was removed, so you should just remove the attribute and remove any OK toggle button implementations you have. Also, the mistyped clDgRowSelection should be replaced with clrDgRowSelection.

    Removal of deprecated Alert features (#2751)

    We removed two deprecated Alert APIs for the Angular component only. The alert types no longer support any variations that start with alert-, just remove the prefix like info. The first child of an ClrAlert should be clr-alert-item, to ensure the icons properly display.

    Removal of deprecated icon shapes (#2750)

    The eye and eye-hide shapes were moved from the essentials set to the core set. If you import them directly, you will need to update the import path.

    Deprecation of old grid (#2757)

    Clarity has had deprecated the old grid already, but has actually removed it from the main @clr/ui bundles. If you are still using the old grid (which includes the old unprefixed .row and .col classes), we have provided a temporary file you can include until you fully migrate to the new grid classes. To do this, add @clr/ui/clr-grid-deprecated.css to your project.

    Deprecation of old forms (#2730)

    Clarity has had deprecated the old forms already, but has kept them in this release to provide more time to migrate. Previously to use the new forms you had to include the ClrFormsNextModule with the old forms as the default, but now it has been reversed. The new forms no longer need to include the next module, but if you wish to use the old forms still you must include the ClrFormsDeprecatedModule.

    Two way support for ClrDatagridHideableColumn (#2738)

    Clarity now supports two way binding on [(clrDgHidden)] so you can keep track of the state more easily.


  • Fixed removing a global alerts when multiple alerts were present (#2884)

    Fixed case where having multiple alerts open and then dynamically removing one would remove all alerts instead of just the one.

    Fixed modal close on backdrop click default (#2889)

    Fixed the default behavior to not close by default per our UX guidelines.

    Fixed Vertical Nav hover and active colors (#2862)

    The color of the active and hovered item in vertical nav are now different.

    Page size changes now trigger state changes (#2841)

    Fixed a bug that didn't correctly set the correct grid class overrides when specified.

    Date picker reset bugfix (#2803)

    Fixed a bug that if you reset the date picker, you were unable to reselect the same date again.

    Date picker grid override bugfix (#2803)

    Fixed a bug that didn't correctly set the correct grid class overrides when specified.