Web Components 계층형 그리드 도구 모음

    Ignite UI for Web Components Toolbar는 Web Components Hierarchical Grid의 UI 작업을 위한 컨테이너입니다. Web Components 도구 모음은 Web Components 구성 요소의 맨 위에 있습니다. 즉, IgcHierarchicalGridComponent 가로 크기와 일치합니다. 도구 모음 컨테이너는 사용자 지정 콘텐츠 또는 미리 정의된 UI 컨트롤 집합을 호스팅할 수 있습니다. Web Components Hierarchical Grid의 기본 설정은 다음과 같습니다.

    • 열 숨기기
    • 열 고정
    • 엑셀 내보내기
    • 고급 필터링

    도구 모음과 사전 정의된 UI 구성 요소는 Web Components 이벤트를 지원하고 개발자를 위한 API를 노출합니다.

    Web Components 도구 모음 그리드 예제

    EXAMPLE
    TS
    HTML
    CSS
    Edit in:

    이 샘플이 마음에 드시나요? 당사의 완전한 Ignite UI for Web Components 툴킷에 액세스하여 몇 분 만에 나만의 앱을 빌드하기 시작하세요. 무료로 다운로드하세요.

    사전 정의된 Actions UI title 구성 요소는 내부 IgcGridToolbar에 추가되며, 이 모든 것은 해당 그리드 기능과의 기본 상호 작용을 제공하는 도구 모음이 있어야 합니다.

    <igc-hierarchical-grid id="hGrid">
    <igc-grid-toolbar>
        <igc-grid-toolbar-title>Hierarchical Grid Toolbar</igc-grid-toolbar-title>
        <igc-grid-toolbar-actions>
            <igc-grid-toolbar-advanced-filtering><igc-grid-toolbar-advanced-filtering>
            <igc-grid-toolbar-hiding></igc-grid-toolbar-hiding>
            <igc-grid-toolbar-pinning></igc-grid-toolbar-pinning>
            <igc-grid-toolbar-exporter></igc-grid-toolbar-exporter>
        </igc-grid-toolbar-actions>
    </igc-grid-toolbar>
</igc-hierarchical-grid>
html

    위의 코드 조각에서 볼 수 있듯이 사전 정의된 Actions UI 구성 요소는 IgcGridToolbarActions 컨테이너에 래핑됩니다. 이렇게 하면 도구 모음 제목이 도구 모음 왼쪽에 정렬되고 작업이 도구 모음 오른쪽에 정렬됩니다.

    물론, 각 UI는 서로 독립적으로 추가될 수도 있고 전혀 추가되지 않을 수도 있습니다. 이렇게 하면 도구 모음 컨테이너가 비어 있게 렌더링됩니다.

    <igc-hierarchical-grid>
    <igc-grid-toolbar>
    </igc-grid-toolbar>
</igc-hierarchical-grid>
html

    각 기본 UI 구성 요소를 포괄적으로 살펴보려면 아래 기능 섹션을 계속 읽어보세요.

    자식 그리드가 있는 도구 모음

    자식 그리드 igc-hierarchical-grid가 구현되는 방식과 DI 범위가 작동하는 방식에 대한 특정 제한 사항으로 인해 내부 igc-row-island의 도구 모음 구성 요소를 정의하려면 input 속성을 사용합니다 ToolbarTemplate. 이렇게 하면 자식 그리드가 별도의 도구 모음 인스턴스를 만들 수 있습니다.

    constructor() {
    var rowIsland1 = document.getElementById('rowIsland1') as IgcRowIslandComponent;
    rowIsland1.toolbarTemplate = this.rowIslandToolbarTemplate;
}

public rowIslandToolbarTemplate = () => {
    return html`<igc-grid-toolbar>
        <igc-grid-toolbar-actions>
            <igc-grid-toolbar-advanced-filtering></igc-grid-toolbar-advanced-filtering>
            <igc-grid-toolbar-hiding></igc-grid-toolbar-hiding>
            <igc-grid-toolbar-pinning></igc-grid-toolbar-pinning>
            <igc-grid-toolbar-exporter></igc-grid-toolbar-exporter>
        </igc-grid-toolbar-actions>
    </igc-grid-toolbar>`;
}
ts
    <igc-hierarchical-grid>
    ...
    <igc-row-island id="rowIsland1">
    </igc-row-island>
</igc-hierarchical-grid>
html
    Ignite UI for Web Components | CTA 배너

    특징

    도구 모음은 그리드 전체에 영향을 미치는 논리/상호 작용을 분리하는 데 유용합니다.

    위에 표시된 대로 그리드에서 데이터 제어, 열 숨기기, 열 고정, 고급 필터링 및 내보내기를 위한 기본 구성 요소를 제공하도록 구성할 수 있습니다.

    이러한 기능은 Ignite UI for Web Components Suite의 카드 구성 요소와 유사한 패턴을 따라 서로 독립적으로 사용하도록 설정할 수 있습니다.

    아래에는 도구 모음의 주요 기능과 각 기능에 대한 예제 코드가 나열되어 있습니다.

    EXAMPLE
    TS
    HTML
    CSS
    Edit in:

    제목

    그리드의 도구 모음 제목 설정은 IgcGridToolbarTitle을 사용하여 수행됩니다.

    사용자는 간단한 텍스트부터 보다 복잡한 템플릿까지 무엇이든 제공할 수 있습니다.

    <igc-grid-toolbar>
    <igc-grid-toolbar-title>Grid toolbar title</igc-grid-toolbar-title>
</igc-grid-toolbar>
html

    행위

    ​IgcGridToolbarActions는 사용자가 상위 그리드와 관련하여 작업/상호작용을 배치할 수 있는 곳입니다. 도구 모음의 제목 부분과 마찬가지로 사용자는 기본 도구 모음 상호 작용 구성 요소를 포함하여 해당 템플릿 부분 내에 무엇이든 제공할 수 있습니다.

    <igc-grid-toolbar>
    <igc-grid-toolbar-actions>
    <!-- ... -->
    </igc-grid-toolbar-actions>
</igc-grid-toolbar>
html

    열 고정

    ​IgcGridToolbarPinning 구성 요소는 그리드의 열 고정과 상호 작용하기 위한 기본 UI를 제공합니다.

    구성 요소는 구성 요소 제목, 구성 요소 입력을 위한 자리 표시자 및 드롭다운 자체의 높이와 같은 UI 사용자 정의를 위한 여러 입력 속성뿐만 아니라 도구 모음이 포함된 상위 그리드를 사용하여 즉시 작동하도록 설정됩니다.

    <igc-grid-toolbar>
    <igc-grid-toolbar-actions>
        <igc-grid-toolbar-pinning
            title="Grid pinned columns"
            prompt="Filter column collection"
            column-list-height="400px">
        </igc-grid-toolbar-pinning>
    </igc-grid-toolbar-actions>
</igc-grid-toolbar>
html

    열 숨기기

    ​IgcGridToolbarHiding은 열 숨기기와 상호작용하기 위한 기본 UI를 제공합니다. 구성 요소 제목, 구성 요소 입력을 위한 자리 표시자, 드롭다운 자체의 높이 등 UI 사용자 지정을 위한 동일한 입력 속성을 노출합니다.

    <igc-grid-toolbar>
    <igc-grid-toolbar-actions>
        <igc-grid-toolbar-hiding
            title="Grid column hiding"
            prompt="Filter column collection"
            column-list-height="400px">
        </igc-grid-toolbar-hiding>
    </igc-grid-toolbar-actions>
</igc-grid-toolbar>
html

    고급 필터링

    도구 모음 고급 필터링 구성 요소는 고급 필터링 기능을 위한 기본 UI를 제공합니다. 구성 요소는 버튼의 기본 텍스트를 변경하는 방법을 노출합니다.

    <igc-grid-toolbar>
    <igc-grid-toolbar-actions>
        <igc-grid-toolbar-advanced-filtering>Custom text for the toggle button</igc-grid-toolbar-advanced-filtering>
    </igc-grid-toolbar-actions>
</igc-grid-toolbar>
html

    데이터 내보내기

    IgcHierarchicalGridComponent 또는 해당 자식 그리드를 계층 구조로 내보낼 때 내보낸 데이터는 해당 그리드에 속하는 행의 플랫 컬렉션이 됩니다(자식 그리드는 내보낸 데이터에 포함되지 않음).

    나머지 도구 모음 작업과 마찬가지로 내보내기는 기본적으로 IgcGridToolbarExporter를 통해 제공됩니다.

    도구 모음 내보내기 구성 요소는 UI와 내보내기 환경을 모두 사용자 지정하기 위한 여러 입력 속성을 노출합니다.

    표시 텍스트 변경부터 드롭다운 옵션 활성화/비활성화, 생성된 파일 이름 사용자 정의까지 다양합니다. 자세한 내용은 ToolbarExporter에 대한 API 문서를 참조하세요.

    다음은 Web Components 템플릿을 통해 사용자 지정할 수 있는 몇 가지 옵션을 보여주는 스니펫입니다.

    <igc-grid-toolbar>
    <igc-grid-toolbar-actions>
        <igc-grid-toolbar-exporter export-csv="true" export-excel="true" filename="exported_data">
        </igc-grid-toolbar-exporter>
    </igc-grid-toolbar-actions>
</igc-grid-toolbar>
html

    내보낸 파일 이름을 변경하는 것 외에도 사용자는 ToolbarExporting 이벤트를 기다리고 이벤트 속성에서 옵션 항목을 사용자 정의하여 내보내기 옵션을 추가로 구성할 수 있습니다.

    기본적으로 CSV로 내보낼 때 내보내기는 쉼표 구분 기호를 사용하여 내보내고 출력 파일에 '.csv' 확장자를 사용합니다. 내보내기 이벤트를 구독하거나 내보내기 옵션 필드의 값을 변경하여 이러한 내보내기 매개변수를 사용자 정의할 수 있습니다. 이벤트 인수의 취소 필드를 true로 설정하여 내보내기 프로세스를 취소할 수도 있습니다.

    다음 코드 조각은 도구 모음 내보내기 이벤트를 구독하고 내보내기 옵션을 구성하는 방법을 보여줍니다.

    <igc-hierarchical-grid id="hierarchicalGrid"></igc-hierarchical-grid>
html
    constructor() {
    var hierarchicalGrid = document.getElementById('hierarchicalGrid') as IgcHierarchicalGridComponent;
    hierarchicalGrid.addEventListener("toolbarExporting", this.configureExport);
}

public configureExport(evt: CustomEvent<IgcGridToolbarExportEventArgs>) {
    const args = evt.detail;
    const options: IgcExporterOptionsBase = args.options;
    if (options) {
        options.fileName = `Report_${new Date().toDateString()}`;
        (args.exporter as any).columnExporting.subscribe((columnArgs: any) => {
            columnArgs.cancel = columnArgs.header === 'Photo';
        });
    }
}
ts

    다음 샘플은 내보낸 파일을 사용자 정의하는 방법을 보여줍니다.

    EXAMPLE
    TS
    HTML
    CSS
    Edit in:

    지표 내보내기

    기본 도구 모음 내보내기 구성 요소를 사용하는 경우 내보내기 작업이 발생할 때마다 작업이 진행되는 동안 도구 모음에 진행률 표시기가 표시됩니다.

    또한 사용자는 도구 모음 ShowProgress 속성을 설정하고 장기 실행 작업에 사용하거나 그리드에서 발생하는 작업을 나타내는 또 다른 방법으로 사용할 수 있습니다.

    아래 샘플에는 진행률 표시줄을 볼 수 있도록 데이터 내보내기에 필요한 시간을 늘리기 위해 상당한 양의 데이터가 사용됩니다. 또한 그리드에서 장기 실행 작업을 시뮬레이션하는 또 다른 버튼이 있습니다.

    EXAMPLE
    DATA
    TS
    HTML
    CSS
    Edit in:

    맞춤 콘텐츠

    도구 모음 구성 요소의 작업 부분이 특정 사용 사례에 충분하지 않은 경우 도구 모음 자체에는 사용자가 추가 UI를 제공할 수 있는 일반 콘텐츠 프로젝션이 있습니다. 사용자가 API 호출 또는 바인딩을 위해 해당 그리드 인스턴스가 필요한 경우 템플릿 참조 변수를 만들 수 있습니다.

    다음은 샘플 스니펫입니다.

    <igc-hierarchical-grid id="grid">
    <igc-grid-toolbar>
        <igc-grid-toolbar-title>title</igx-grid-toolbar-title>
        <!--
            Everything between the toolbar tags except the default toolbar components/directives
            will be projected as custom content.
         -->
        <igc-grid-toolbar-actions>
        </igc-grid-toolbar-actions>
    </igc-grid-toolbar>
</igc-hierarchical-grid>
html

    다음 샘플은 열 헤더를 클릭하여 정렬 설정을 지우기 위해 도구 모음에 추가 버튼을 추가하는 방법을 보여줍니다.

    EXAMPLE
    DATA
    TS
    HTML
    CSS
    Edit in:

    스타일링

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

    <igc-hierarchical-grid class="grid"></igc-hierarchical-grid>
html

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

    .grid {
    --ig-grid-toolbar-background-color: #2a2b2f;
    --ig-grid-toolbar-title-text-color: #ffcd0f;
    --ig-grid-toolbar-dropdown-background: #2a2b2f;
}
css

    데모

    EXAMPLE
    TS
    HTML
    CSS
    Edit in:

    API 참조

    Grid Toolbar 서비스에는 아래에 나열된 몇 가지 API가 더 있습니다.

    추가 리소스

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