Angular 계층형 그리드 열 고정
하나 이상의 열을 Angular UI 그리드의 왼쪽이나 오른쪽에 고정할 수 있습니다. Ignite UI for Angular의 열 고정을 사용 하면 최종 사용자가 특정 열 순서로 열을 잠글 수 있으며, 이를 통해 계층형 그리드를 가로로 스크롤하는 동안 해당 열을 볼 수 있습니다. 머티리얼 UI 그리드에는 계층적 그리드의 도구 모음을 통해 열의 고정 상태를 변경하는 데 사용할 수 있는 열 고정 UI가 내장되어 있습니다. 또한 Column Pinning API를 통해 사용자 정의 UI를 정의하고 열의 고정 상태를 변경할 수 있습니다.
Angular Hierarchical Grid Column Pinning Example
Column Pinning API
기둥 고정은 다음을 통해 제어됩니다. pinned
의 입력 igx-column
. 고정된 열은 기본적으로 계층적 그리드의 왼쪽에 렌더링되며 계층적 그리드 본문에서 고정 해제된 열의 가로 스크롤을 통해 고정된 상태로 유지됩니다.
<igx-hierarchical-grid class="hgrid" [data]="localdata" [autoGenerate]="false"
[height]="'600px'" [width]="'800px'" #hierarchicalGrid>
<igx-column [field]="Artist" [width]="200px" [pinned]="true"></igx-column>
<igx-column [field]="Debut" [width]="200px"></igx-column>
</igx-hierarchical-grid>
또한 Hierarchical Grid의 pinColumn
또는 IgxHierarchicalGridComponent
의 unpinColumn
메소드를 사용하여 필드 이름으로 열을 고정하거나 고정 해제할 수도 있습니다.
this.hierarchicalGrid.pinColumn('Artist');
this.hierarchicalGrid.unpinColumn('Debut');
두 메서드 모두 해당 작업의 성공 여부를 나타내는 부울 값을 반환합니다. 일반적으로 실패하는 이유는 열이 이미 원하는 상태에 있기 때문입니다.
열은 가장 오른쪽에 고정된 열의 오른쪽에 고정되어 있습니다. 고정된 열의 순서를 변경하려면 columnPin
이벤트를 구독하고 이벤트 인수의 insertAtIndex
속성을 원하는 위치 인덱스로 변경하면 됩니다.
<igx-hierarchical-grid class="hgrid" [data]="localdata" [autoGenerate]="false"
[height]="'600px'" [width]="'800px'"
(columnPin)="columnPinning($event)" #hierarchicalGrid>
</igx-hierarchical-grid>
public columnPinning(event) {
if (event.column.field === 'Artist') {
event.insertAtIndex = 0;
}
}
Pinning Position
pinning
구성 옵션을 통해 열 고정 위치를 변경할 수 있습니다. 열 위치를 시작 또는 끝으로 설정할 수 있습니다. 끝으로 설정하면 열이 고정 해제된 열 뒤의 그리드 끝에서 렌더링됩니다. 고정되지 않은 열은 가로로 스크롤할 수 있지만 고정된 열은 오른쪽에 고정된 상태로 유지됩니다.
<igx-hierarchical-grid #grid1 [data]="data" [autoGenerate]="true" [pinning]="pinningConfig"></igx-hierarchical-grid>
public pinningConfig: IPinningConfig = { columns: ColumnPinningPosition.End };
Demo
Custom Column Pinning UI
관련 API를 통해 사용자 정의 UI를 정의하고 열의 핀 상태를 변경할 수 있습니다.
도구 모음 대신 최종 사용자가 클릭하여 특정 열의 핀 상태를 변경할 수 있는 열 헤더에 핀 아이콘을 정의한다고 가정해 보겠습니다. 이는 사용자 정의 아이콘이 있는 열의 헤더 템플릿을 생성하여 수행할 수 있습니다.
<ng-template igxHeader let-column #pinTemplate>
<div class="title-inner">
<span style="float:left">{{column.header || column.field}}</span>
<igx-icon class="pin-icon" [class.pinned]="column.pinned" [class.unpinned]="!column.pinned" fontSet="fas" name="fa-thumbtack"
(click)="toggleColumn(column)"></igx-icon>
</div>
</ng-template>
<igx-hierarchical-grid class="hierarchicalGrid" [data]="localdata" [autoGenerate]="false"
[height]="'500px'" [width]="'100%'" #hierarchicalGrid>
<igx-column field="CompanyName" header="Company Name" [headerTemplate]="pinTemplate" width="200px" [pinned]="true"></igx-column>
<igx-column field="ContactName" header="Contact Name" [headerTemplate]="pinTemplate" width="150px"></igx-column>
<igx-column field="ContactTitle" header="Contact Title" [headerTemplate]="pinTemplate" width="200px"></igx-column>
<igx-row-island [key]="'Orders'" [autoGenerate]="false">
<igx-column field="OrderDate" header="Order Date" [headerTemplate]="pinTemplate" [dataType]="'date'" width="150px"></igx-column>
<igx-column field="RequiredDate" header="Required Date" [headerTemplate]="pinTemplate" [dataType]="'date'" width="150px"></igx-column>
<igx-column field="ShippedDate" header="Shipped Date" [headerTemplate]="pinTemplate" [dataType]="'date'" width="150px"></igx-column>
<igx-column field="ShipVia" header="Ship Via" [headerTemplate]="pinTemplate" width="150px"></igx-column>
<igx-row-island [key]="'OrderDetails'" [autoGenerate]="false">
<igx-column field="UnitPrice" header="Unit Price" width="150px"></igx-column>
<igx-column field="Quantity" width="150px"></igx-column>
<igx-column field="Discount" width="150px"></igx-column>
</igx-row-island>
</igx-row-island>
</igx-hierarchical-grid>
사용자 정의 아이콘을 클릭하면 해당 열의 API 메소드를 사용하여 관련 열의 고정 상태를 변경할 수 있습니다.
public toggleColumn(col: ColumnType) {
col.pinned ? col.unpin() : col.pin();
}
Demo
Pinning Limitations
- 열 너비를 백분율(%)로 설정하면 고정된 열이 있을 때 계층적 격자 본문과 머리글 콘텐츠가 잘못 정렬됩니다. 열 고정이 올바르게 작동하려면 열 너비가 픽셀(px) 단위이거나 계층 그리드에 의해 자동 할당되어야 합니다.