|
1 | | -# Ignite UI for Angular Change Log |
| 1 | +# Ignite UI for Angular Change Log |
2 | 2 |
|
3 | 3 | All notable changes for each version of this project will be documented in this file. |
4 | 4 |
|
| 5 | +## 8.2.0 |
| 6 | + |
| 7 | +### New theme |
| 8 | +Ignite UI for angular now have a new theme that mimics Microsoft "Fluent" design system. |
| 9 | +Depending on your use case you can use one of the following mixins: |
| 10 | +`igx-fluent-theme` and `igx-fluent-dark-theme` |
| 11 | + |
| 12 | +We also added two new pallets that go with the new theme, `$fluent-word-palette` and `$fluent-excel-palette`. |
| 13 | + |
| 14 | +Next example shows how you can use the Fluent theme. |
| 15 | + |
| 16 | +```scss |
| 17 | +// Light version |
| 18 | +.fluent-word-theme { |
| 19 | + @include igx-fluent-theme($fluent-word-palette); |
| 20 | +} |
| 21 | + |
| 22 | +// Dark version |
| 23 | +.fluent-excel-dark-theme { |
| 24 | + @include igx-fluent-dark-theme($fluent-excel-palette); |
| 25 | +} |
| 26 | +``` |
| 27 | + |
| 28 | +For more information about the theming please read our [documentation](https://www.infragistics.com/products/ignite-ui-angular/angular/components/themes/index.html) |
| 29 | + |
| 30 | +### New Features |
| 31 | +- `IgxGrid`, `IgxTreeGrid`, `IgxHierarchicalGrid` |
| 32 | + - `uniqueColumnValuesStrategy` input is added. This property provides a callback for loading unique column values on demand. If this property is provided, the unique values it generates will be used by the Excel Style Filtering (instead of using the unique values from the data that is bound to the grid). |
| 33 | + - `igxExcelStyleLoading` directive is added, which can be used to provide a custom loading template for the Excel Style Filtering. If this property is not provided, a default loading template will be used instead. |
| 34 | + - introduced new properties `cellSelection` and `rowSelection` which accept GridSelection mode enumeration. Grid selection mode could be none, single or multiple. Also `hideRowSelectors` property is added, which allows you to show and hide row selectors when row selection is enabled. |
| 35 | + - introduced functionality for templating row and header selectors - [spec](https://github.com/IgniteUI/igniteui-angular/wiki/Row-Selection-Templating-(Grid-feature)) |
| 36 | + ```html |
| 37 | + <igx-grid [data]="data", [rowSelection]="'multiple'" primaryKey="ID"> |
| 38 | + <igx-column field="Name"></igx-column> |
| 39 | + <igx-column field="Age"></igx-column> |
| 40 | + |
| 41 | + <ng-template igxHeadSelector let-headSelector> |
| 42 | + <igx-icon>done_all</igx-icon> |
| 43 | + </ng-template> |
| 44 | + <ng-template igxRowSelector let-rowContext> |
| 45 | + <igx-switch [checked]="rowContext.selected"></igx-switch> |
| 46 | + </ng-template> |
| 47 | + </igx-grid> |
| 48 | + ``` |
| 49 | +- `IgxHierarchicalGrid` |
| 50 | + - Row Islands now emit child grid events with an additional argument - `owner`, which holds reference to the related child grid component instance. |
| 51 | +- `IgxDrag` |
| 52 | + - Dragging without ghost. Now it is possible to drag the base element `igxDrag` is instanced on by setting the new input `ghost` to false. |
| 53 | + - Ghost template. A custom ghost template reference can be provided on the new `ghostTemplate` input. |
| 54 | + - Dragging using a single or multiple handles. New `igxDragHandle` directive is exposed to specify a handle by which an element can be interacted with instead of the whole element `igxDrag` is instanced on. |
| 55 | + - Linking of drag and drop elements. This can be achieved by using the new provided `dragChannel` input, specifying each element to which channel it corresponds. |
| 56 | + - Drag animation improvements. Three new methods have been exposed in place of the old `animateToOrigin` input in order to provide more flexibility when wanting to have transition animation to specific position when dropping. `setLocation`, `transitionToOrigin` and `transitionTo` are all methods that provide a various way to animate a transition to a specific location for the dragged element. |
| 57 | + - New getters - `location` and `originLocation` to aid in applying transition animations. |
| 58 | + - New outputs - `dragMove`, `ghostCreate` and `ghostDestroy` |
| 59 | +- `IgxDrop` |
| 60 | + - Linking of drag and drop elements. This can be achieved by using the new provided `dropChannel` input, specifying each drop area to which channel it corresponds. |
| 61 | + - Drop strategies. Three new drop strategies have been provided - Append, Prepend and Insert. Also an input `dropStrategy` to the `igxDrop` which specify which strategy should be used when dropping an element inside the drop area. Custom one can be specified as well. |
| 62 | +- `IgxCheckbox` |
| 63 | + - introduced a new `readonly` property that doesn't allow user interaction to change the state, but keeps the default active style. Intended for integration in complex controls that handle the interaction and control the checkbox instead through binding. |
| 64 | +- `IgxOverlay` |
| 65 | + - introduced a new `ContainerPositionStrategy`. The new strategy positions the element inside the containing outlet based on the directions passed in trough PositionSettings. |
| 66 | + |
| 67 | +### General |
| 68 | +- `IgxGrid`, `IgxTreeGrid`, `IgxHierarchicalGrid` |
| 69 | + - `isCellSelected` method has been deprecated. Now you can use `selected` property. |
| 70 | + - `rowSelectable` property has been deprecated. Now you can use `rowSelection` property to enable row selection and also you can show and hide the row selectors by setting `hideRowSelectors` property to true or false (which is the default value). |
| 71 | + - Removed deprecated event `OnFocusChange` |
| 72 | + - **Breaking Change** `igxExcelStyleSortingTemplate` directive is renamed to `igxExcelStyleSorting`. |
| 73 | + - **Breaking Change** `igxExcelStyleMovingTemplate` directive is renamed to `igxExcelStyleMoving`. |
| 74 | + - **Breaking Change** `igxExcelStyleHidingTemplate` directive is renamed to `igxExcelStyleHiding`. |
| 75 | + - **Breaking Change** `onRowSelectionChange` event arguments are changed. The `row` property has been removed and the properties `added`, `removed` and `cancel` are newly added. |
| 76 | + - **Breaking Change** `igxExcelStylePinningTemplate` directive is renamed to `igxExcelStylePinning`. |
| 77 | + - **Breaking Change** `onRowDragEnd` and `onRowDragStart` event arguments are changed - `owner` now holds reference to the grid component instance, while `dragDirective` hold reference to the drag directive. |
| 78 | +- `IgxCombo` |
| 79 | + - Combo selection is now consistent when `valueKey` is defined. When `valueKey` is specified, selection is based on the value keys of the items. For example: |
| 80 | + ```html |
| 81 | + <igx-combo [data]="myCustomData" valueKey="id" displayKey="text"></igx-combo> |
| 82 | + ``` |
| 83 | + ```typescript |
| 84 | + export class MyCombo { |
| 85 | + ... |
| 86 | + public combo: IgxComboComponent; |
| 87 | + public myCustomData: { id: number, text: string } = [{ id: 0, name: "One" }, ...]; |
| 88 | + ... |
| 89 | + ngOnInit() { |
| 90 | + // Selection is done only by valueKey property value |
| 91 | + this.combo.selectItems([0, 1]); |
| 92 | + } |
| 93 | + } |
| 94 | + ``` |
| 95 | + - **Breaking Change** When using `[valueKey]`, combo methods, events and outputs **cannot** be handled with *data item references*. |
| 96 | + - For more information, visit the component's [readme](https://github.com/IgniteUI/igniteui-angular/tree/master/projects/igniteui-angular/src/lib/combo/README.md) |
| 97 | +- `IgxDrag` |
| 98 | + - Deprecated inputs - `hideBaseOnDrag`, `animateOnRelease`, `visible`. |
| 99 | + - Deprecated methods - `dropFinished`. |
| 100 | + - **Breaking Change** `ghostImageClass` input is renamed to `ghostClass`. |
| 101 | + - **Breaking Change** `dragGhostHost` input is renamed to `ghostHost`. |
| 102 | + - **Breaking Change** `returnMoveEnd` input is renamed to `transitioned`. |
| 103 | + - **Breaking Change** `onDragStart` output is renamed to `dragStart`. |
| 104 | + - **Breaking Change** `onDragEnd` output is renamed to `dragEnd`. |
| 105 | + |
| 106 | +- `IgxDrop` |
| 107 | + - **Breaking Change** Default drop strategy is now changed to not perform any actions. |
| 108 | + - **Breaking Change** `onEnter` output is renamed to `enter`. |
| 109 | + - **Breaking Change** `onOver` output is renamed to `over`. |
| 110 | + - **Breaking Change** `onLeave` output is renamed to `leave`. |
| 111 | + - **Breaking Change** `onDrop` output is renamed to `dropped`. |
| 112 | + - **Breaking Change** Interfaces `IgxDropEnterEventArgs`, `IgxDropLeaveEventArgs` are both now called `IDropBaseEventArgs`. |
| 113 | + - **Breaking Change** Interfaces `IgxDropEventArgs` is renamed to `IDropDroppedEventArgs`. |
| 114 | + - **Breaking Change** Outputs `enter`, `over`, `leave`(former `onEnter`, `onOver`, `onLeave`) now have arguments of type `IDropBaseEventArgs` |
| 115 | + - **Breaking Change** Output `dropped` (former `onDrop`) now have arguments of type `IDropDroppedEventArgs` |
| 116 | + |
| 117 | +## 8.1.4 |
| 118 | +- `IgxDialog` new @Input `positionSettings` is now available. It provides the ability to get/set both position and animation settings of the Dialog component. |
| 119 | + |
| 120 | +## 8.1.3 |
| 121 | +- `IgxCombo` |
| 122 | + - Combo `onSelectionChange` events now emits the item(s) that were added to or removed from the collection: |
| 123 | + ```html |
| 124 | + <igx-combo (onSelectionChange)="handleChange($event)"> |
| 125 | + ``` |
| 126 | + ```typescript |
| 127 | + export class Example { |
| 128 | + ... |
| 129 | + handleChange(event: IComboSelectionChangeEventArgs) { |
| 130 | + console.log("Items added: ", [...event.added]); // the items added to the selection in this change |
| 131 | + console.log("Items removed: ", [...event.removed]); // the items removed from the selection in this change |
| 132 | + } |
| 133 | + } |
| 134 | + ``` |
| 135 | + |
5 | 136 | ## 8.1.2 |
6 | 137 |
|
7 | 138 | ### New Features |
|
0 commit comments