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
우리 커뮤니티는 활동적이며 항상 새로운 아이디어를 환영합니다.