Descripción general de los grupos de columnas plegables de la cuadrícula de árbol Blazor

    The Ignite UI for Blazor Collapsible Column Groups feature in Blazor Tree Grid allows you to organize and manage multiple levels of nested columns and column groups in the IgbTreeGrid by grouping them together and providing the option to collapse or expand these groups for improved data visualization and navigation.

    Blazor Tree Grid Collapsible Column Groups Example

    Setup

    To get started with the IgbTreeGrid and the Collapsible multi-column headers feature, first you need to install Ignite UI for Blazor by typing the following command:

    > dotnet add package IgniteUI.Blazor --version 25.2.38 (December 2025)

    Para obtener una introducción completa al Ignite UI for Blazor, lea el tema de introducción.

    Además, le recomendamos encarecidamente que eche un vistazo breve al tema de encabezados de varias columnas para ver información más detallada sobre cómo configurar los grupos de columnas en su cuadrícula.

    Usage

    Los grupos de columnas plegables son parte de la función de encabezados de varias columnas que proporciona una manera de contraer/expandir un grupo de columnas a un conjunto más pequeño de datos. Cuando se contrae un grupo de columnas, se mostrará un subconjunto de columnas al usuario final y las otras columnas secundarias del grupo se ocultarán. Cada columna contraída/expandida se puede vincular a la fuente de datos de la cuadrícula, o puede no vincularse y, por lo tanto, calcularse.

    Para definir un grupo de columnas como colapsable, necesitas establecer laCollapsible propiedad en elIgbColumnGroup como verdadero.

    Necesitas definir la propiedadVisibleWhenCollapsed al menos a dos columnas hijas. Al menos una columna debe ser visible cuando el grupo se colapsa (VisibleWhenCollapsedse pone en verdadero) y al menos una columna debe ocultarse cuando el grupo se expande (VisibleWhenCollapsedse configura a),false de lo contrario la funcionalidad plegable se desactivará. SiVisibleWhenCollapsed no se especifica para algunas de las columnas hijas, entonces esta columna siempre será visible independientemente de si el estado padre está expandido o colapsado.

    Veamos el marcado a continuación:

     <IgbColumnGroup Header="Customer Information" Collapsible="true">
    <!--The column below will be visible when its parent is collapsed-->
    <IgbColumn Field="CustomerName" Header="Full name" VisibleWhenCollapsed="true"></IgbColumn>
        <!--The three columns below will be visible when its parent is expanded-->
        <IgbColumn Field="CustomerID" Header="Customer ID" VisibleWhenCollapsed="false"></IgbColumn>
        <IgbColumn Field="FirstName" Header="First Name" VisibleWhenCollapsed="false"></IgbColumn>
        <IgbColumn Field="LastName" Header="Last Name" VisibleWhenCollapsed="false"></IgbColumn>
        <IgbColumnGroup Header="Customer Address">
            <IgbColumn Field="Country" Header="Country" Sortable="true"></IgbColumn>
            <IgbColumn Field="City" Header="City" Sortable="true"></IgbColumn>
        </IgbColumnGroup>
 </IgbColumnGroup>

    En resumen, cada columna secundaria tiene tres estados:

    • Puede estar siempre visible, sin importar el estado expandido de su padre.
    • Puede ser visible cuando su padre está contraído.
    • Se puede ocultar cuando su padre está colapsado.

    El estado inicial del grupo de columnas, que se especifica como colapsable, seExpanded pone en verdadero, pero puedes cambiar fácilmente este comportamiento poniéndolo en falso.

    Nota Tenga en cuenta que inicialmente la opción de contraer grupo tiene prioridad sobre la columna oculta. Si declaró que su columna estaba oculta usando la propiedad oculta y tiene un grupo definido donde se debe mostrar la misma columna, se mostrará la columna.

    API References

    Additional Resources

    Nuestra comunidad es activa y siempre da la bienvenida a nuevas ideas.