React Tree Grid 개요 및 구성

React 트리 그리드는 데이터 그리드(테이블)의 기능과 트리 뷰를 결합하여 계층적 데이터를 표 형식으로 쉽게 표시할 수 있는 UI 구성 요소입니다. 일반 그리드와 달리 트리 그리드를 사용하면 행을 확장 및 축소할 수 있어 상위 행 아래에 중첩된 자식 행이 표시되므로 파일 탐색기, 조직도, 프로젝트 작업 또는 제품 범주와 같은 구조화된 데이터를 나타내는 데 유용합니다.

Ignite UI for React 계층적 또는 플랫 데이터를 쉽게 표시하고 조작하는 데 사용됩니다. 매우 적은 코드로 데이터를 빠르게 바인딩하거나 다양한 이벤트를 사용하여 다양한 동작을 사용자 정의합니다. 이 구성 요소는 데이터 선택, Excel 스타일 필터링, 정렬, 페이징, 템플릿 및 열 이동과 같은 풍부한 기능 세트를 제공합니다. Material Table 기반 UI Tree Grid 덕분에 표 형식 데이터를 표시하는 것이 그 어느 때보다 쉽고 아름다워졌습니다.

React Tree Grid Example

이 예에서는 사용자가 계층적 또는 단순 데이터를 조작하는 방법을 볼 수 있습니다. 필터링 및 정렬 옵션, 고정 및 숨기기, 행 선택, Excel 및 CSV로 내보내기가 포함되었습니다.

예

트리 그리드 Ignite UI for React 시작하는 방법

종속성

React 그리드 라이브러리와 특히 React 트리 그리드를 시작하는 것은 계층적 정보를 명확하고 대화형 방식으로 표시하는 강력하고 데이터가 풍부한 애플리케이션을 구축하기 위한 첫 번째 단계입니다. React 트리 그리드를 사용하면 대규모 데이터 세트에서 고성능을 위해 행 확장, 정렬, 필터링, 편집 및 가상화와 같은 기능을 갖춘 친숙한 표 형식으로 부모-자식 데이터 구조를 표시할 수 있습니다.

To get started with the React tree grid, first you need to install the igniteui-react and igniteui-react-grids packages.

npm install --save igniteui-react
npm install --save igniteui-react-grids

용법

트리 그리드는 그리드와 많은 기능을 공유하지만 데이터를 계층적으로 표시하는 기능도 추가합니다. 이를 달성하기 위해 트리 그리드는 모든 데이터 개체에 대해 하위 컬렉션을 사용하거나 모든 데이터 개체에 대해 기본 및 외래 키를 사용하여 데이터 개체 간의 관계를 정의하는 몇 가지 방법을 제공합니다.

트리 셀

트리 그리드의 계층 구조(하위 컬렉션 또는 기본 및 외래 키)를 구축하는 데 사용되는 옵션에 관계없이 트리 그리드의 행은 두 가지 유형의 셀로 구성됩니다.

• GridCell- 값을 포함하는 일반 셀.
• TreeGridCell- 값, 확장/붕괴 표시기, 그리고 셀 행 수준에 기반한 들여쓰기 div 요소를 포함하는 트리 셀. 행 구성 요소의 레벨은 내부level 구성 요소의 속성을 통해treeRow 접근할 수 있습니다.

[! 참고] 각 행은 하나의 트리 셀만 가질 수 있지만, 여러 개(또는 아예) 일반 셀을 가질 수도 있습니다.

초기 확장 깊이

초기에는 트리 그리드가 모든 노드 레벨을 확장하고 보여줍니다. 이 동작은 속성을expansionDepth 사용하여 설정할 수 있습니다. 기본값으로 그 값은 무한대로, 모든 노드 레벨이 확장됩니다. 이 속성을 숫자 값으로 설정하여 초기 확장 깊이를 제어할 수 있습니다. 예를 들어, 0은 루트 레벨 노드만 보여주고, 1은 루트 레벨 노드와 그 자식 노드를 표시하는 식입니다.

아동 소장품

자식 컬렉션 옵션을 사용하는 경우 모든 데이터 개체에는 부모 데이터 개체와 동일한 유형의 항목으로 채워지는 자식 컬렉션이 포함됩니다. 이렇게 하면 트리 그리드의 모든 레코드가 자식에 대한 직접 참조를 갖게 됩니다. 이 경우 원래 데이터 원본을 포함하는 트리 표의 데이터 속성은 계층적으로 정의된 컬렉션이 됩니다.

이 샘플에서는 다음 컬렉션 구조를 사용해 보겠습니다.

const EMPLOYEE_DATA = [
    {
        Name: "Johnathan Winchester",
        ID: 1,
        HireDate: new Date(2008, 3, 20),
        Age: 55,
        Employees: [
            {
                Name: "Michael Burke",
                ID: 3,
                HireDate: new Date(2011, 6, 3),
                Age: 43,
                Employees: []
            },
            {
                Name: "Thomas Anderson"
                ID: 2,
                HireDate: new Date(2009, 6, 19),
                Age: 29,
                Employees: []
            },
            // ...
        ]
    },
    // ...
]

이제 컬렉션을data 가져오고 트리 그리드에 바인딩하는 것부터 시작하겠습니다.

트리 그리드가 계층 구조를 구축하려면, 각 데이터 객체에 사용되는 자식 컬렉션 이름으로 트리 그리드의childDataKey 속성을 설정해야 합니다. 저희 경우에는 직원 컬렉션이 될 것입니다. 또한, 자동 열 생성을 비활성화하고 실제 데이터 객체 속성과 일치시켜 수동으로 컬럼을 정의할 수 있습니다. (Employees 컬렉션은 계층 구조에 자동으로 사용되므로 열의 정의에 포함될 필요가 없습니다.)

이제 와 를 추가rowSelection​IgrPaginator 하여 트리 그리드의 행 선택 및 페이지 기능을 활성화할 수 있습니다. 각 열에 대해 요약, 필터링, 정렬, 편집, 이동 및 크기 조절 기능도 활성화할 수 있습니다.

마지막으로, 트리 그리드의 툴바와 함께 열의 숨기기, 열을 고정하는 기능, 그리고 각각 '와 '내보내기'를 사용할IgrGridToolbar​IgrGridToolbarHiding​IgrGridToolbarPinning​IgrGridToolbarExporter 수 있습니다.

이 문서의 시작 부분에 있는 트리 그리드 예제 섹션에서 위 코드의 결과를 볼 수 있습니다.

기본 키 및 외래키

​기본 키와 외래 키 옵션을 사용할 때, 모든 데이터 객체는 기본 키와 외래 키를 포함합니다. 기본 키는 현재 데이터 객체의 고유 식별자이고, 외래 키는 그 부모 객체의 고유 식별자입니다. 이 경우 원래 데이터 소스를 포함하는 트리 그리드의 속성은data 평면 집합이 됩니다.

const data = [
    { ID: 1, ParentID: -1, Name: "Casey Houston", JobTitle: "Vice President", Age: 32 },
    { ID: 2, ParentID: 1, Name: "Gilberto Todd", JobTitle: "Director", Age: 41 },
    { ID: 3, ParentID: 2, Name: "Tanya Bennett", JobTitle: "Director", Age: 29 },
    { ID: 4, ParentID: 2, Name: "Jack Simon", JobTitle: "Software Developer", Age: 33 },
    { ID: 5, ParentID: 8, Name: "Celia Martinez", JobTitle: "Senior Software Developer", Age: 44 },
    { ID: 6, ParentID: -1, Name: "Erma Walsh", JobTitle: "CEO", Age: 52 },
    { ID: 7, ParentID: 2, Name: "Debra Morton", JobTitle: "Associate Software Developer", Age: 35 },
    { ID: 8, ParentID: 10, Name: "Erika Wells", JobTitle: "Software Development Team Lead", Age: 50 },
    { ID: 9, ParentID: 8, Name: "Leslie Hansen", JobTitle: "Associate Software Developer", Age: 28 },
    { ID: 10, ParentID: -1, Name: "Eduardo Ramirez", JobTitle: "Development Manager", Age: 53 }
];

위 샘플 데이터에서 모든 레코드는 ID, ParentID, 그리고 이름, 직책, 나이와 같은 추가 속성을 가지고 있습니다. 앞서 언급했듯이, 기록의 ID는 반드시 고유해야 하며, 이는 우리primaryKey 기록이 될 것입니다. ParentID는 부모 노드의 ID를 포함하며, a로foreignKey 설정할 수 있습니다. 만약 어떤 행의 ParentID가 트리 그리드의 어떤 행과도 일치하지 않는다면, 그 행은 루트 행임을 의미합니다.

부모-자식 관계는 트리 그리드primaryKey와foreignKey 속성을 사용하여 구성됩니다.

다음은 위의 플랫 컬렉션에 정의된 데이터를 표시하도록 트리 그리드를 구성하는 방법을 보여주는 구성 요소의 템플릿입니다.

또한 rowSelection 속성을 사용하여 트리 그리드의 행 선택 기능과 각 열에 대한 필터링, 정렬, 편집, 이동 및 크기 조정 기능을 활성화합니다.

최종 결과는 다음과 같습니다.

지속성과 통합

트리 그리드 셀의 들여쓰기는 필터링, 정렬 및 페이징과 같은 다른 트리 그리드 기능에서 유지됩니다.

• 열에 적용되면Sorting 데이터 행이 레벨별로 정렬됩니다. 즉, 루트 레벨 행은 각각의 자식과 독립적으로 정렬됩니다. 각 자녀 컬렉션도 각각 독립적으로 분류됩니다.
• 첫 번째 열(avisibleIndex가 0인 열)은 항상 트리 열입니다.
• 열 고정, 열 숨기기, 열 이동 같은 연산 후 avisibleIndex가 0이 되는 열은 트리 열이 됩니다.
• 내보낸 Excel 워크시트는 트리 그리드 자체에 그룹화된 레코드를 그룹화하여 계층 구조를 반영합니다. 모든 레코드 확장 상태도 유지되고 반영됩니다.
• CSV로 내보낼 때 레벨 및 확장 상태가 무시되고 모든 데이터가 플랫으로 내보내집니다.

API 참조

• IgrTreeGrid
• IgrColumn
• IgrGridToolbar
• IgrTreeGridRecord

추가 리소스

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

• Ignite UI for React Forums
• Ignite UI for React GitHub