React Grid 축소 가능한 열 그룹 개요

    React Grid의 Ignite UI for React 하면 IgrGrid에서 여러 수준의 중첩된 열과 열 그룹을 그룹화하고 향상된 데이터 시각화 및 탐색을 위해 이러한 그룹을 축소하거나 확장하는 옵션을 제공하여 구성하고 관리할 수 있습니다.

    React Grid Collapsible Column Groups Example

    Setup

    IgrGrid축소 가능한 다중 열 헤더 기능을 시작하려면 먼저 다음 명령을 입력하여 Ignite UI for React 설치해야 합니다.

    npm install igniteui-react-grids
    

    Ignite UI for React에 대한 전체 소개를 보려면 시작하기 항목을 읽어보세요.

    또한 그리드에서 열 그룹을 설정하는 방법에 대한 자세한 내용을 보려면 다중 열 헤더 항목을 간략하게 살펴보는 것이 좋습니다.

    Usage

    축소 가능한 열 그룹은 열 그룹을 더 작은 데이터 세트로 축소/확장하는 방법을 제공하는 다중 열 헤더 기능의 일부입니다. 열 그룹이 축소되면 열의 하위 집합이 최종 사용자에게 표시되고 그룹의 다른 하위 열은 숨겨집니다. 축소/확장된 각 열은 그리드 데이터 소스에 바인딩되거나 바인딩 해제되어 계산될 수 있습니다.

    열 그룹을 축소 가능한 것으로 정의하려면 를 설정해야 합니다. Collapsible의 속성 columnGroup 받는 사람 .

    최소한 두 개의 하위 열에 visibleWhenCollapsed 속성을 정의해야 합니다. 그룹이 축소될 때(visibleWhenCollapsed​ ​true로 설정됨) 하나 이상의 열이 표시되어야 하고, 그룹이 확장될 때(visibleWhenCollapsed​ ​false로 설정됨) 하나 이상의 열이 숨겨져야 합니다. 그렇지 않으면 축소 가능한 기능이 비활성화됩니다. 일부 하위 열에 visibleWhenCollapsed 지정되지 않은 경우 상위 상태가 확장되거나 축소되었는지 여부에 관계없이 이 열이 항상 표시됩니다.

    아래 마크업을 살펴보겠습니다.

    <IgrColumnGroup collapsible="true" header="Customer Information">
        <IgrColumn field="CustomerName" header="Customer Name" visibleWhenCollapsed="true">
        </IgrColumn>
        <IgrColumn field="CustomerID" header="Customer ID" visibleWhenCollapsed="false">
        </IgrColumn>
        <IgrColumn field="CustomerFirstName" header="First Name" visibleWhenCollapsed="false">
        </IgrColumn>
        <IgrColumn field="CustomerLastName" header="Last Name" visibleWhenCollapsed="false">
        </IgrColumn>
        <IgrColumnGroup header="Customer Address">
            <IgrColumn field="CustomerAddress"  header="Full Address" width="250px" visibleWhenCollapsed="true">
            </IgrColumn>
            <IgrColumn field="Address" visibleWhenCollapsed="false">
            </IgrColumn>
            <IgrColumn  field="City" visibleWhenCollapsed="false">
            </IgrColumn>
            <IgrColumn field="Country" visibleWhenCollapsed="false">
            </IgrColumn>
            <IgrColumn field="PostalCode" header="Postal Code" visibleWhenCollapsed="false">
            </IgrColumn>
        </IgrColumnGroup>
    </IgrColumnGroup>
    

    요약하면 모든 하위 열에는 세 가지 상태가 있습니다.

    • 상위 항목의 확장 상태에 관계없이 항상 표시될 수 있습니다.
    • 상위 항목이 축소되면 표시될 수 있습니다.
    • 상위 항목이 축소되면 숨길 수 있습니다.

    축소 가능으로 지정된 열 그룹의 초기 상태는 다음과 같습니다. expanded로 설정 진실로 설정하여 이 동작을 쉽게 변경할 수 있습니다. 거짓.

    Expand/Collapse Indicator Template

    IgrGrid의 기본 확장 표시기는 다음과 같습니다.

    IgrGrid의 기본 축소 표시기는 다음과 같습니다.

    또한 기본 확장/축소 표시기를 변경해야 하는 경우 이를 달성하기 위해 템플릿 옵션을 제공합니다.

    <IgrColumnGroup id="info" header="Customer Information" collapsible="true" collapsibleIndicatorTemplate={this.collapsibleIndicatorTemplate}>
        <IgrColumn field="CustomerName" header="Fullname" dataType="String" visibleWhenCollapsed="true"></IgrColumn>
        <IgrColumn field="CustomerID" header="Customer ID" dataType="String" visibleWhenCollapsed="false"></IgrColumn>
        <IgrColumnGroup id="address" header="Customer Address" collapsible="true">
            <IgrColumn field="Country" header="Country" dataType="String" sortable="true" visibleWhenCollapsed="true"></IgrColumn>
            <IgrColumn field="City" header="City" dataType="String" sortable="true" visibleWhenCollapsed="false"></IgrColumn>
        </IgrColumnGroup>
    </IgrColumnGroup>
    
    function collapsibleIndicatorTemplate(e: { dataContext: IgrColumnTemplateContext }) {
        return (
        <div>
            <IgrIcon iconName={e.dataContext.column.expanded ? 'remove' : 'add'}></IgrIcon>
        </div>)
    }
    

    참고 초기에 그룹 축소 옵션은 열 숨김보다 우선합니다. 숨김 속성을 사용하여 열을 숨기도록 선언하고 동일한 열이 표시되어야 하는 그룹을 정의한 경우 해당 열이 표시됩니다.

    API References

    Additional Resources

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