Premium

Angular Hierarchical Grid の行ドラッグ

Ignite UI for Angular Hierarchical Grid では、RowDrag がルート igx-hierarchical-grid コンポーネントで初期化されて、rowDraggable 入力で設定できます。行ドラッグを有効にすると、ユーザーは行ドラッグハンドルを使用して行のドラッグを開始できます。

Angular Hierarchical Grid 行ドラッグの例

構成

igx-hierarchical-grid の行ドラッグを有効にするには、グリッドの rowDraggable を true に設定します。これが有効になると、行ドラッグハンドルが各行に表示されます。このハンドルは行ドラッグを開始するために使用できます。

<igx-hierarchical-grid [rowDraggable]="true">
 ...
</igx-hierarchical-grid>

ドラッグハンドルをクリックしてボタンを押しながらカーソルを動かすと、グリッドの rowDragStart イベントが発生します。クリックをリリースすると、rowDragEnd イベントが発生します。

以下は、行ドラッグをサポートするための igx-hierarchical-grid の設定方法と、ドロップイベントの適切な処理方法についてのチュートリアルです。

この例では、グリッドから指定された領域に行をドラッグし、ドロップするとグリッドから削除します。

ドロップエリア

行ドラッグを簡単に有効にできました。次は行ドロップを処理する方法を設定する必要があります。 igxDrop ディレクティブを使用して、行をドロップする場所を定義できます。

はじめに、アプリモジュールに IgxDragDropModule をインポートする必要があります。

import { ..., IgxDragDropModule } from 'igniteui-angular/directives';
// import { ..., IgxDragDropModule } from '@infragistics/igniteui-angular'; for licensed package
...
@NgModule({
    imports: [..., IgxDragDropModule]
})

次にテンプレートでディレクティブのセレクターを使ってドロップエリアを定義します。

<div class="drop-area" igxDrop (enter)="onEnterAllowed($event)" (leave)="onLeaveAllowed($event)"
(dropped)="onDropAllowed($event)">
    <igx-icon>delete</igx-icon>
    <div>Drag a row here to delete it</div>
</div>

rowDragEnd イベントの animation パラメーターを使用して、ドロップできない領域に行がドロップされたときにアニメーションを有効にできます。true に設定されている場合、ドラッグされた行は、ドロップできない領域の上にドロップされると元の位置に戻ります。

以下はアニメーションを有効にする方法です。

export class IgxHierarchicalGridRowDragComponent {

    public onRowDragEnd(args) {
        args.animation = true;
    }

}

ドロップエリアイベントハンドラー

テンプレートでドロップ領域を定義したら、コンポーネントの .ts ファイルで igxDrop の enter、leave、dropped イベントを宣言する必要があります。

はじめに、enter と leave ハンドラーを見てみましょう。これらのメソッドでは、ドラッグの ghost のアイコンを変更して、行をドロップできる領域の上にあることをユーザーに示すことができます。

export class IgxHierarchicalGridRowDragComponent {
    public onEnterAllowed(args) {
        this.changeGhostIcon(args.drag.ghostElement, DragIcon.ALLOW);
    }

    public onLeaveAllowed(args) {
        this.changeGhostIcon(args.drag.ghostElement, DragIcon.DEFAULT);
    }

    private changeGhostIcon(ghost, icon: string) {
        if (ghost) {
            const currentIcon = ghost.querySelector('.igx-grid__drag-indicator > igx-icon');
            if (currentIcon) {
                currentIcon.innerText = icon;
            }
        }
    }
}

changeGhostIcon private メソッドは、ドラッグゴースト内のアイコンを変更するだけです。メソッドのロジックは、アイコンを含む要素を検索し (ドラッグインジケーターコンテナーに適用される igx-grid__drag-indicator クラスを使用)、要素の内部テキストを渡されたものに変更します。アイコンは material フォントセットからのもので、別の enum で定義されています。

enum DragIcon {
    DEFAULT = 'drag_indicator',
    ALLOW = 'remove'
}

次に、ユーザーが実際にドロップ領域内に行をドロップしたときに何が起こるかを定義する必要があります。

export class IgxHierarchicalGridRowDragComponent {

    public onDropAllowed(args: IDropDroppedEventArgs) {
        const draggedRow: RowType = args.dragData;
        draggedRow.delete();
    }

}

行が削除されたら、行の delete() メソッドを呼び出すだけです。

イベント引数 (args.dragData.data) または他の行プロパティからの行データを使用する場合、行全体が参照として引数に渡されることに注意してください。つまり、ソースグリッドのデータと区別する必要がある場合は、必要なデータを複製する必要があります。

ドラッグゴーストのテンプレート化

ドラッグゴーストは、igx-hierarchical-grid の本体内の <ng-template> に適用される IgxRowDragGhost ディレクティブを使用してテンプレート化できます。

<igx-hierarchical-grid>
...
   <ng-template igxRowDragGhost>
        <div>
            <igx-icon fontSet="material">arrow_right_alt</igx-icon>
        </div>
    </ng-template>
...
</igx-hierarchical-grid>

以下は、行ドラッグと複数選択を有効にした igx-hierarchical-grid で確認できる設定の結果です。以下のデモでは、現在ドラッグされている行の数を示します。

デモ

ドラッグゴーストは各グリッドレベルでテンプレート化できます。複数のゴーストテンプレートを作成できて、または単一の行アイランドにのみテンプレートを提供できます。

<igx-hierarchical-grid>
...
    <ng-template igxRowDragGhost>
        <div>
            <igx-icon fontSet="material">arrow_right_alt</igx-icon> 
        </div>
    </ng-template>
    <igx-row-island>
        ...
        <ng-template IgxRowDragGhost>
            <img src="smile.gif" height="42" width="42">
        </ng-template>
    </igx-row-island>
...
</igx-hierarchical-grid>

ドラッグアイコンのテンプレート化

ドラッグハンドルアイコンは、グリッドの dragIndicatorIconTemplate を使用してテンプレート化できます。作成している例で、アイコンをデフォルトのもの (drag_indicator) から drag_handle に変更します。 igxDragIndicatorIcon を使用して igx-hierarchical-grid の本体内にテンプレートを渡して変更できます。

<igx-hierarchical-grid>
...
    <ng-template igxDragIndicatorIcon>
        <igx-icon>drag_handle</igx-icon>
    </ng-template>
...
</igx-hierarchical-grid>

新しいアイコンテンプレートの設定後、DragIcon enum の DEFAULT アイコンも調整する必要があるため、changeIcon メソッドによって適切に変更されます。

enum DragIcon {
    DEFAULT = "drag_handle",
    ...
}

ドロップエリアのスタイル設定

ドロップハンドラが正しく設定されたら、次にドロップ領域をスタイル設定します。

.drop-area {
    width: 160px;
    height: 160px;
    background-color: #d3d3d3;
    border: 1px dashed #131313;
    display: flex;
    justify-content: center;
    align-items: center;
    flex-flow: column;
    text-align: center;
    margin: 8px;
}

:host {
    display: flex;
    justify-content: center;
    align-items: center;
    flex-flow: column;
    width: 100%;
}

結果は以下のデモで確認できます。

デモ

アプリケーションデモ

行の並べ替えデモ

グリッドの行ドラッグイベントと igxDrop ディレクティブを使用して、ドラッグよる行の並べ替えるが可能なグリッドを作成できます。

すべてのアクションはグリッド本体の内側で発生するため、ここで igxDrop ディレクティブをアタッチする必要があります:

<igx-hierarchical-grid #grid [data]="localData" [primaryKey]="'id'"
    [rowDraggable]="true" (rowDragStart)="rowDragStart($event)" igxDrop (dropped)="rowDrop($event)">
    ...
</igx-hierarchical-grid>

グリッドに primaryKey が指定されていることを確認してください！ロジックが行を適切に並べ替えられるように、行には一意の識別子が必要です。

rowDraggable が有効になり、ドロップエリアが定義されたら、ドロップイベントの単純なハンドラーを実装する必要があります。行をドラッグするときは、以下を確認してください:

行が展開されていますか? そうであれば、行を縮小します。
行はグリッド内にドロップされましたか?
そうであれば、ドラッグされた行が他のどの行にドロップされましたか?
ターゲット行が見つかれば、data 配列内のレコードの位置を入れ替えます。
行は最初に選択されてましたか? そうであれば、選択済みとしてマークします。

以下では、コンポーネントの .ts ファイルに実装されていることがわかります。

export class HGridRowReorderComponent {
    public rowDragStart(args: any): void {
        const targetRow = args.dragData;
        if (targetRow.expanded) {
            targetRow.expanded = false;
        }
    }

    public rowDrop(args: IDropDroppedEventArgs): void {
        const targetRow = args.dragData;
        const event = args.originalEvent;
        const cursorPosition: Point = { x: event.clientX, y: event.clientY };
        this.moveRow(targetRow, cursorPosition);
    }

    private moveRow(draggedRow: RowType, cursorPosition: Point): void {
        // const parent: IgxHierarchicalGridComponent = (draggedRow as any).grid;
        // const parent = args.drag.ghostContext.grid;
        const parent = this.hGrid;
        const rowIndex: number = this.getTargetRowIndex(parent.rowList.toArray(), cursorPosition);
        if (rowIndex === -1) { return; }
        const wasSelected = draggedRow.selected;
        draggedRow.delete();
        parent.data.splice(rowIndex, 0, draggedRow.data);
        if (wasSelected) {
            parent.selectRows([parent.rowList.toArray()
                .find((r) => r.rowID === draggedRow.key).rowID], false);
        }
    }

    private getTargetRowIndex(rowListArr: RowType[], cursorPosition: Point): number {
        const targetElem: IgxHierarchicalRowComponent = this.catchCursorPosOnElem(rowListArr, cursorPosition);
        return rowListArr.indexOf(rowListArr.find((r) => r.rowData.id === targetElem.rowData.id));
    }

    private catchCursorPosOnElem(rowListArr: any[], cursorPosition: Point)
        : IgxHierarchicalRowComponent {
        for (const row of rowListArr) {
            const rowRect = row.nativeElement.getBoundingClientRect();
            if (cursorPosition.y > rowRect.top + window.scrollY && cursorPosition.y < rowRect.bottom + window.scrollY &&
                cursorPosition.x > rowRect.left + window.scrollX && cursorPosition.x < rowRect.right + window.scrollX) {
                return row;
            } else if (row === rowListArr[rowListArr.length - 1] && cursorPosition.y > rowRect.bottom) {
                return row;
            }
        }
    }
}

これらの簡単な手順で、ドラッグ/ドロップで行を並べ替えることができるグリッドを構成しました! 次のデモで、上記コードの動作を確認できます。

行の選択も有効で、ドラッグした行をドロップしても選択が保持されます。

制限

現在、rowDraggable ディレクティブに既知の制限はありません。

API リファレンス

その他のリソース

Hierarchical Grid 概要

コミュニティに参加して新しいアイデアをご提案ください。

Angular Hierarchical Grid の行ドラッグ

Angular Hierarchical Grid 行ドラッグの例

構成

ドロップ エリア

ドロップ エリア イベント ハンドラー

ドラッグ ゴーストのテンプレート化

デモ

ドラッグ アイコンのテンプレート化

ドロップ エリアのスタイル設定

デモ

アプリケーション デモ