merge master

Author: ddincheva

CHANGELOG.md

@@ -1,4 +1,4 @@
-# Ignite UI for Angular Change Log
+# Ignite UI for Angular Change Log
 
 All notable changes for each version of this project will be documented in this file.
 
@@ -9,6 +9,20 @@ All notable changes for each version of this project will be documented in this
     - `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).
     - `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.
     - 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.
+- `IgxHierarchicalGrid`
+    - Row Islands now emit child grid events with an additional argument - `owner`, which holds reference to the related child grid component instance.
+- `IgxDrag`
+    - Dragging without ghost. Now it is possible to drag the base element `igxDrag` is instanced on by setting the new input `ghost` to false.
+    - Ghost template. A custom ghost template reference can be provided on the new `ghostTemplate` input.
+    - Dragging using a single or multiple handles. New `igxDragHandle` directive is exposed to specify a handle by which and element can be interacted with instead of the whole element `igxDrag` is instanced on.
+    - 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.
+    - 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.
+    - New getters - `location` and `originLocation` to aid in applying transition animations.
+    - New outputs - `dragMove`, `ghostCreate` and `ghostDestroy`
+- `IgxDrop`
+    - 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.
+    - 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.
+
 ### General
 - `IgxGrid`, `IgxTreeGrid`, `IgxHierarchicalGrid`
     - `isCellSelected` method has been deprecated. Now you can use `selected` property.
@@ -19,6 +33,7 @@ All notable changes for each version of this project will be documented in this
     - **Breaking Change** `igxExcelStyleHidingTemplate` directive is renamed to `igxExcelStyleHiding`.
     - **Breaking Change** `onRowSelectionChange` event arguments are changed. The `row` property has been removed and the properties `added`, `removed` and `cancel` are newly added.
     - **Breaking Change** `igxExcelStylePinningTemplate` directive is renamed to `igxExcelStylePinning`.
+    - **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.
 - `IgxCombo`
     - 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:
     ```html
@@ -42,6 +57,26 @@ All notable changes for each version of this project will be documented in this
 ## 8.1.4
 - `IgxDialog` new @Input `positionSettings` is now available. It provides the ability to get/set both position and animation settings of the Dialog component.
 
+- `IgxDrag`
+    - Deprecated inputs - `hideBaseOnDrag`, `animateOnRelease`, `visible`.
+    - Deprecated methods - `dropFinished`.
+    - **Breaking Change** `ghostImageClass` input is renamed to `ghostClass`.
+    - **Breaking Change** `dragGhostHost` input is renamed to `ghostHost`.
+    - **Breaking Change** `returnMoveEnd` input is renamed to `transitioned`.
+    - **Breaking Change** `onDragStart` output is renamed to `dragStart`.
+    - **Breaking Change** `onDragEnd` output is renamed to `dragEnd`.
+
+- `IgxDrop`
+    - **Breaking Change** Default drop strategy is now changed to not perform any actions.
+    - **Breaking Change** `onEnter` output is renamed to `enter`.
+    - **Breaking Change** `onOver` output is renamed to `over`.
+    - **Breaking Change** `onLeave` output is renamed to `leave`.
+    - **Breaking Change** `onDrop` output is renamed to `dropped`.
+    - **Breaking Change** Interfaces `IgxDropEnterEventArgs`, `IgxDropLeaveEventArgs` are both now called `IDragBaseEventArgs`.
+    - **Breaking Change** Interfaces `IgxDropEventArgs` is renamed to `IDropDroppedEventArgs`.
+    - **Breaking Change** Outputs `enter`, `over`, `leave`(former `onEnter`, `onOver`, `onLeave`) now have arguments of type `IDropBaseEventArgs`
+    - **Breaking Change** Output `dropped` (former `onDrop`) now have arguments of type `IDropDroppedEventArgs`
+
 ## 8.1.3
 - `IgxCombo`
     - Combo `onSelectionChange` events now emits the item(s) that were added to or removed from the collection:

projects/igniteui-angular/migrations/update-8_2_0/changes/inputs.json

@@ -0,0 +1,29 @@
+{
+    "$schema": "../../common/schema/binding.schema.json",
+    "changes": [
+        {
+            "name": "renderGhost",
+            "replaceWith": "ghost",
+            "owner": {
+                "selector": "igxDrag",
+                "type": "directive"
+            }
+        },
+        {
+            "name": "ghostImageClass",
+            "replaceWith": "ghostClass",
+            "owner": {
+                "selector": "igxDrag",
+                "type": "directive"
+            }
+        },
+        {
+            "name": "dragGhostHost",
+            "replaceWith": "ghostHost",
+            "owner": {
+                "selector": "igxDrag",
+                "type": "directive"
+            }
+        }
+    ]
+}

projects/igniteui-angular/migrations/update-8_2_0/changes/outputs.json

@@ -0,0 +1,61 @@
+{
+    "$schema": "../../common/schema/binding.schema.json",
+    "changes": [
+        {
+            "name": "onGhostCreate",
+            "replaceWith": "ghostCreate",
+            "owner": {
+                "selector": "igxDrag",
+                "type": "directive"
+            }
+        },
+        {
+            "name": "onGhostDestroy",
+            "replaceWith": "ghostDestroy",
+            "owner": {
+                "selector": "igxDrag",
+                "type": "directive"
+            }
+        },
+        {
+            "name": "returnMoveEnd",
+            "replaceWith": "transitioned",
+            "owner": {
+                "selector": "igxDrag",
+                "type": "directive"
+            }
+        },
+        {
+            "name": "dragClicked",
+            "replaceWith": "click",
+            "owner": {
+                "selector": "igxDrag",
+                "type": "directive"
+            }
+        },
+        {
+            "name": "onEnter",
+            "replaceWith": "enter",
+            "owner": {
+                "selector": "igxDrop",
+                "type": "directive"
+            }
+        },
+        {
+            "name": "onLeave",
+            "replaceWith": "leave",
+            "owner": {
+                "selector": "igxDrop",
+                "type": "directive"
+            }
+        },
+        {
+            "name": "onDrop",
+            "replaceWith": "dropped",
+            "owner": {
+                "selector": "igxDrop",
+                "type": "directive"
+            }
+        }
+    ]
+}

projects/igniteui-angular/migrations/update-8_2_0/index.spec.ts

@@ -50,4 +50,32 @@ describe('Update 8.2.0', () => {
 
         done();
     });
+
+    it('should update igxDrag input bindings', done => {
+        appTree.create(
+            '/testSrc/appPrefix/component/custom.component.html',
+            `<div igxDrag [renderGhost]="true" [ghostImageClass]="'casper'" [dragGhostHost]="host">Drag me</div>`);
+        const tree = schematicRunner.runSchematic('migration-10', {}, appTree);
+
+        expect(tree.readContent('/testSrc/appPrefix/component/custom.component.html'))
+            .toEqual(
+            `<div igxDrag [ghost]="true" [ghostClass]="'casper'" [ghostHost]="host">Drag me</div>`);
+        done();
+    });
+
+    it('should update igxDrag and igxDrop outputs bindings', done => {
+        appTree.create(
+            '/testSrc/appPrefix/component/custom.component.html',
+            `<div igxDrag (onGhostCreate)="ghostCreateHandler($event)" (onGhostDestroy)="ghostDestroyHandler($event)" (returnMoveEnd)="moveEndHandler($event)" (dragClicked)="clickHandler($event)">Drag me</div>
+            <div igxDrop (onEnter)="enterHandler($event)" (onLeave)="leaveHandler($event)" (onDrop)="dropHandler($event)">drop area</div>
+            `);
+        const tree = schematicRunner.runSchematic('migration-10', {}, appTree);
+
+        expect(tree.readContent('/testSrc/appPrefix/component/custom.component.html'))
+            .toEqual(
+            `<div igxDrag (ghostCreate)="ghostCreateHandler($event)" (ghostDestroy)="ghostDestroyHandler($event)" (transitioned)="moveEndHandler($event)" (click)="clickHandler($event)">Drag me</div>
+            <div igxDrop (enter)="enterHandler($event)" (leave)="leaveHandler($event)" (dropped)="dropHandler($event)">drop area</div>
+            `);
+        done();
+    });
 });

projects/igniteui-angular/src/lib/banner/banner.component.ts

@@ -9,9 +9,9 @@ import { IgxButtonModule } from '../directives/button/button.directive';
 import { IgxRippleModule } from '../directives/ripple/ripple.directive';
 import { IgxBannerActionsDirective } from './banner.directives';
 import { CommonModule } from '@angular/common';
-import { CancelableEventArgs } from '../core/utils';
+import { CancelableEventArgs, IBaseEventArgs } from '../core/utils';
 
-export interface BannerEventArgs {
+export interface BannerEventArgs extends IBaseEventArgs {
     banner: IgxBannerComponent;
     event?: Event;
 }

projects/igniteui-angular/src/lib/buttonGroup/buttonGroup.component.ts

@@ -23,6 +23,7 @@ import { IgxRippleModule } from '../directives/ripple/ripple.directive';
 import { IgxIconModule } from '../icon/index';
 import { takeUntil } from 'rxjs/operators';
 import { DisplayDensityBase, DisplayDensityToken, IDisplayDensityOptions, DisplayDensity } from '../core/density';
+import { IBaseEventArgs } from '../core/utils';
 
 export enum ButtonGroupAlignment { horizontal, vertical }
 let NEXT_ID = 0;
@@ -424,7 +425,7 @@ export class IgxButtonGroupComponent extends DisplayDensityBase implements After
     }
 }
 
-export interface IButtonGroupEventArgs {
+export interface IButtonGroupEventArgs extends IBaseEventArgs {
     button: IgxButtonDirective;
     index: number;
 }

projects/igniteui-angular/src/lib/carousel/carousel.component.ts

@@ -12,6 +12,7 @@ import {
     Output
 } from '@angular/core';
 import { IgxIconModule } from '../icon/index';
+import { IBaseEventArgs } from '../core/utils';
 
 let NEXT_ID = 0;
 
@@ -560,7 +561,7 @@ export class IgxSlideComponent implements OnInit, OnDestroy {
     }
 }
 
-export interface ISlideEventArgs {
+export interface ISlideEventArgs extends IBaseEventArgs {
     carousel: IgxCarouselComponent;
     slide: IgxSlideComponent;
 }

projects/igniteui-angular/src/lib/checkbox/checkbox.component.ts

@@ -13,15 +13,15 @@ import {
 } from '@angular/core';
 import { CheckboxRequiredValidator, ControlValueAccessor, NG_VALIDATORS, NG_VALUE_ACCESSOR } from '@angular/forms';
 import { IgxRippleModule } from '../directives/ripple/ripple.directive';
-import { isIE } from '../core/utils';
+import { isIE, IBaseEventArgs } from '../core/utils';
 import { EditorProvider } from '../core/edit-provider';
 
 export enum LabelPosition {
     BEFORE = 'before',
     AFTER = 'after'
 }
 
-export interface IChangeCheckboxEventArgs {
+export interface IChangeCheckboxEventArgs extends IBaseEventArgs {
     checked: boolean;
     checkbox: IgxCheckboxComponent;
 }

projects/igniteui-angular/src/lib/chips/README.md

@@ -154,7 +154,6 @@ The chips can be focused using the `Tab` key or by clicking on them. Chips can b
 | `displayDensity`| `DisplayDensity | string` | Sets the chip theme. Available options are `compact`, `cosy`, `comfortable`. |
 | `color` | `string` | Sets the chip background color. |
 | `hideBaseOnDrag` | `boolean` | Sets if the chip base should be hidden when the chip is dragged. |
-| `animateOnRelease` | `boolean` | Sets if the chip should animate to its position when released. |
 
 ### Outputs
 | Name | Argument Type | Description |

projects/igniteui-angular/src/lib/chips/chip.component.html

@@ -3,15 +3,14 @@
     (keydown)="onChipKeyDown($event)"
     [igxDrag]="{chip: this}"
     [hideBaseOnDrag]="hideBaseOnDrag"
-    [animateOnRelease]="animateOnRelease"
-    [ghostImageClass]="ghostClass"
+    [ghostClass]="ghostClass"
     (dragStart)="onChipDragStart($event)"
     (dragEnd)="onChipDragEnd()"
-    (returnMoveEnd)="onChipMoveEnd($event)"
-    (dragClicked)="onChipDragClicked($event)"
+    (transitioned)="onChipMoveEnd($event)"
+    (click)="onChipDragClicked($event)"
     igxDrop
-    (onEnter)="onChipDragEnterHandler($event)"
-    (onDrop)="onChipDrop($event)">
+    (enter)="onChipDragEnterHandler($event)"
+    (dropped)="onChipDrop($event)">
 
     <div [ngClass]="selectClass(selected)">
         <ng-container *ngTemplateOutlet="selectIconTemplate"></ng-container>