Blazor Tree Grid Row Pinning

    Blazor Tree Grid의 Ignite UI for Blazor Row Pinning 기능을 사용하면 그리드의 상단이나 하단에 하나 이상의 행을 고정할 수 있습니다. Row Pinning을 사용하면 최종 사용자가 특정 순서로 행을 고정하여 IgbTreeGrid를 세로로 스크롤하더라도 항상 보이는 특수 영역에 복제할 수 있습니다. Blazor Tree Grid에는 Tree Grid 컨텍스트에서 IgbActionStrip 구성 요소를 초기화하여 활성화되는 기본 제공 행 고정 UI가 있습니다. 또한 Row Pinning API를 통해 사용자 지정 UI를 정의하고 행의 고정 상태를 변경할 수 있습니다.

    Blazor Tree Grid Row Pinning Example

    EXAMPLE
    DATA
    MODULES
    RAZOR
    JS
    CSS

    Like this sample? Get access to our complete Ignite UI for Blazor toolkit and start building your own apps in minutes. Download it for free.

    Row Pinning UI

    기본 제공 행 고정 UI는 IgbGridPinningActions 구성 요소와 함께 IgbActionStrip 구성 요소를 추가하여 활성화됩니다. 행을 마우스로 가리키면 작업 스트립이 자동으로 표시되며 표시된 행의 상태에 따라 고정 또는 고정 해제 버튼 아이콘이 표시됩니다. 고정된 행의 복사본을 보기로 스크롤할 수 있는 추가 작업도 고정된 각 행에 대해 표시됩니다.

        <IgbTreeGrid Width="100%"  
                 Height="100%"
                 PrimaryKey="Key"
                 AutoGenerate=true
                 Data=northwindEmployees
                 RowEditable=true>
            <IgbColumn Field="ID" Editable=false></IgbColumn>
            <IgbColumn Field="ContactName"></IgbColumn>
            <IgbColumn Field="ContactTitle"></IgbColumn>
            <IgbColumn Field="City" Sortable=true></IgbColumn>
            <IgbColumn Field="CompanyName" Sortable=true></IgbColumn>
            <IgbColumn Field="Fax" Sortable=true></IgbColumn>
            <IgbColumn Field="Address" Sortable=true></IgbColumn>
            <IgbColumn Field="PostalCode" Sortable=true></IgbColumn>
            <IgbColumn Field="Country" Sortable=true></IgbColumn>
            <IgbColumn Field="Phone" Sortable=true></IgbColumn>
            <IgbActionStrip>
                <IgbGridPinningActions></IgbGridPinningActions>
                <IgbGridEditingActions></IgbGridEditingActions>
            </IgbActionStrip>
        </IgbTreeGrid>
    razor

    Row Pinning API

    행 고정은 다음을 통해 제어됩니다. Pinned의 입력 Row. 고정된 행은 IgbTreeGrid 기본적으로 고정되지 않은 행의 세로 스크롤을 통해 고정된 상태를 유지합니다. IgbTreeGrid 몸.

    this.Grid.PinRowAsync("ALFKI", 0);
    razor

    또는 UnpinRow 메서드를 사용하여 IgbTreeGrid​ ​PinRow ID로 레코드를 고정하거나 고정 해제할 수도 있습니다.

    this.Grid.PinRowAsync("ALFKI", 0);
    this.Grid.UnpinRowAsync("ALFKI");
    razor

    행 ID는 그리드의 PrimaryKey 또는 레코드 인스턴스 자체에 의해 정의된 기본 키 값입니다. 두 메서드 모두 해당 작업의 성공 여부를 나타내는 부울 값을 반환합니다. 일반적으로 실패하는 이유는 행이 이미 원하는 상태에 있기 때문입니다.

    행은 마지막으로 고정된 행 아래에 고정됩니다. 고정된 행의 순서를 변경하려면 RowPinning 이벤트를 구독하고 이벤트 인수의 InsertAtIndex 속성을 원하는 위치 인덱스로 변경하면 됩니다.

    <IgbTreeGrid Width="100%"
                 Id="grid"
                 RowPinningScript="rowPinningHandler"
                 Height="100%"
                 PrimaryKey="Key"
                 AutoGenerate="true"
                 Data="northwindEmployees">
    </IgbTreeGrid>
    razor
    *** In JavaScript ***
    
    function rowPinningHandler(event) {
        event.detail.insertAtIndex = 0;
    }
    
    igRegisterScript("rowPinningHandler", rowPinningHandler, false);
    razor

    Pinning Position

    구성 옵션을 통해 Pinning 행 고정 위치를 변경할 수 있습니다. 핀 영역 위치를 Top 또는 Bottom으로 설정할 수 있습니다. 아래쪽으로 설정하면 고정된 행이 그리드의 아래쪽에서 고정되지 않은 행 뒤에 렌더링됩니다. 고정되지 않은 행은 세로로 스크롤할 수 있지만 고정된 행은 아래쪽에 고정되어 있습니다.

        <IgbTreeGrid Id="grid"
                Width="100%"
                Height="100%"
                Pinning=PinningConfig
                PrimaryKey="Key"
                AutoGenerate=true
                Data=northwindEmployees>
        </IgbTreeGrid>
        @code {
            public string Key = "ID";
            private Northwind.EmployeesType[] northwindEmployees = Array.Empty<Northwind.EmployeesType>();
            public IgbPinningConfig PinningConfig = new IgbPinningConfig()
            {
                Rows = RowPinningPosition.Bottom
            };
            protected override async Task OnInitializedAsync()
            {
                northwindEmployees = await this.northwindService.GetEmployees() ?? northwindEmployees;
            }
        }
    razor

    Custom Row Pinning UI

    사용자 정의 UI를 정의하고 관련 API를 통해 행의 핀 상태를 변경할 수 있습니다.

    Via extra column with icon

    액션 스트립 대신 최종 사용자가 클릭하여 특정 행의 핀 상태를 변경할 수 있도록 모든 행에 핀 아이콘을 표시하고 싶다고 가정해 보겠습니다. 이는 사용자 정의 아이콘이 포함된 셀 템플릿이 있는 추가 열을 추가하여 수행할 수 있습니다.

    <IgbColumn Width="70px" BodyTemplateScript="WebGridRowPinCellTemplate"/>
    
    // In Javascript
    
    igRegisterScript("WebGridRowPinCellTemplate", (ctx) => {
        var html = window.igTemplating.html;
        window.toggleRowPin = function toggleRowPin(index) {
            var grid = document.getElementsByTagName("igc-grid")[0];
            grid.getRowByIndex(index).pinned = !grid.getRowByIndex(index).pinned;
        }
        const index = ctx.cell.id.rowIndex;
        return html`<div>
        <span onpointerdown='toggleRowPin("${index}")'>📌</span>
    </div>`;
    }, false);
    razor

    데모

    EXAMPLE
    DATA
    MODULES
    RAZOR
    JS
    CSS

    Row Pinning Limitations

    • 데이터 원본에 존재하는 레코드만 고정할 수 있습니다.
    • 행 고정 상태는 Excel로 내보내지지 않습니다. 행 고정이 적용되지 않은 것처럼 그리드가 내보내집니다.
    • 그리드의 스크롤 가능 영역에 있는 고정된 행의 복사본은 고정된 행이 있을 때 다른 그리드 기능이 해당 기능을 달성하는 방법의 필수 부분이므로 생성을 비활성화하거나 제거할 수 없습니다.
    • 행 선택은 전적으로 행 ID와 함께 작동하므로 고정된 행을 선택하면 해당 복사본도 선택됩니다(그 반대도 마찬가지). 또한 고정된 영역 내에서 범위 선택(예: Shift + 클릭 사용)은 스크롤 가능한 영역 내에서 행 범위를 선택하는 것과 동일한 방식으로 작동합니다. 결과 선택에는 현재 고정되어 있지 않은 경우에도 그 사이의 모든 행이 포함됩니다. API를 통해 선택한 행을 가져오면 선택한 각 레코드의 단일 인스턴스만 반환됩니다.

    Styling

    사전 정의된 테마 외에도 사용 가능한 CSS 속성 중 일부를 설정하여 그리드를 추가로 사용자 정의할 수 있습니다. 일부 색상을 변경하려면 먼저 그리드에 대한 클래스를 설정해야 합니다.

    <IgbTreeGrid class="grid"></IgbTreeGrid>
    razor

    그런 다음 해당 클래스에 대한 관련 CSS 속성을 설정합니다.

    .grid {
        --ig-grid-pinned-border-width: 5px;
        --ig-grid-pinned-border-style: double;
        --ig-grid-pinned-border-color: #FFCD0F;
        --ig-grid-cell-active-border-color: #FFCD0F;
    }
    css

    데모

    EXAMPLE
    DATA
    MODULES
    RAZOR
    JS
    CSS

    API References

    Additional Resources

    우리 커뮤니티는 활동적이며 항상 새로운 아이디어를 환영합니다.