Web Components Grid Column Hiding

    La Ignite UI for Web Components tiene una interfaz de usuario integrada para ocultar columnas, que se puede utilizar a través de la barra de herramientas de la cuadrícula Web Components para cambiar el estado visible de las columnas. Los desarrolladores tienen la flexibilidad de definir la interfaz de usuario para ocultar columnas en cualquier lugar dentro de la página según sea necesario. La función Ocultar columnas de cuadrícula Web Components es especialmente útil cuando se desea reducir el tamaño de la cuadrícula y eliminar la necesidad de tabular campos redundantes.

    Web Components Grid Column Hiding Example

    Grid Setup

    Comencemos creando nuestro IgcGridComponent y vinculándolo a nuestros datos. También habilitaremos el filtrado y la clasificación de las columnas.

    <igc-grid id="grid" auto-generate="false" width="100%" height="560px" allow-filtering="true">
        <igc-column field="ID" data-type="String" sortable="true" hidden="true"></igc-column>
        <igc-column field="ContactName" data-type="String" sortable="true" hidden="true"></igc-column>
        <igc-column field="ContactTitle" data-type="String" sortable="true"></igc-column>
        <igc-column field="City" data-type="String" sortable="true"></igc-column>
        <igc-column field="CompanyName" data-type="String" sortable="true"></igc-column>
        <igc-column field="Fax" data-type="String" sortable="true"></igc-column>
        <igc-column field="Address" data-type="String" sortable="true"></igc-column>
        <igc-column field="PostalCode" data-type="String" sortable="true"></igc-column>
        <igc-column field="Country" data-type="String" sortable="true"></igc-column>
        <igc-column field="Phone" data-type="String" sortable="true"></igc-column>
    </igc-grid>
    

    Toolbar's Column Hiding UI

    La interfaz de usuario integrada para ocultar columnas se coloca dentro de un menú DropDown en la barra de herramientas de IgcGridComponent. Podemos mostrar/ocultar la interfaz de usuario de ocultación de columnas usando este menú desplegable exacto.

    Para ello, todo lo que tenemos que hacer es configurar IgcGridToolbarActions e IgcGridToolbarHiding dentro de IgcGridComponent. También agregaremos un título a nuestra barra de herramientas usando IgcGridToolbarTitle y un estilo personalizado para el contenedor de nuestra Grid.

    <igc-grid>
        <igc-grid-toolbar>
            <igc-grid-toolbar-actions>
                <igc-grid-toolbar-hiding></igc-grid-toolbar-hiding>
            </igc-grid-toolbar-actions>
        </igc-grid-toolbar>
    </igc-grid>
    

    IgcGridComponent nos proporciona algunas propiedades útiles cuando se trata de usar la interfaz de usuario para ocultar columnas de la barra de herramientas.

    Al usar la propiedad title, configuraremos el título que se muestra dentro del botón desplegable en la barra de herramientas.

    <igc-grid id="grid">
        <igc-grid-toolbar>
            <igc-grid-toolbar-actions>
                <igc-grid-toolbar-hiding id="hidingAction" title="Column Hiding"></igc-grid-toolbar-hiding>
            </igc-grid-toolbar-actions>
        </igc-grid-toolbar>
    </igc-grid>
    

    Puede ver el resultado del código anterior al comienzo de este artículo en la sección Ejemplo de ocultación de columnas Web Components.

    Disable hiding of a column

    Podemos evitar fácilmente que el usuario pueda ocultar columnas a través de la interfaz de usuario que oculta columnas simplemente configurando su propiedad disableHiding en verdadero.

    <igc-grid>
        <igc-column field="ContactName" data-type="String" sortable="true" disable-hiding="true"></igc-column>
        <igc-column field="ContactTitle" data-type="String" sortable="true" disable-hiding="true"></igc-column>
    </igc-grid>
    

    Styling

    La cuadrícula se puede personalizar aún más configurando algunas de las variables CSS disponibles. Para lograrlo usaremos una clase que primero asignaremos al grid:

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

    Luego configure las variables CSS relacionadas para los componentes relacionados. Aplicaremos los estilos también solo en igx-column-actions, por lo que el resto de la cuadrícula no se ve afectado:

    .grid  igx-column-actions {
        /* Main Column Actions styles */
        --ig-column-actions-background-color: #292826;
        --ig-column-actions-title-color: #ffcd0f;
    
        /* Checkbox styles */
        --ig-checkbox-tick-color: #292826;
        --ig-checkbox-label-color: #ffcd0f;
        --ig-checkbox-empty-color: #ffcd0f;
        --ig-checkbox-fill-color: #ffcd0f;
    
        /* Input styles */
        --ig-input-group-idle-text-color: white;
        --ig-input-group-filled-text-color: #ffcd0f;
        --ig-input-group-focused-text-color: #ffcd0f;
        --ig-input-group-focused-border-color: #ffcd0f;
        --ig-input-group-focused-secondary-color: #ffcd0f;
    
        /* Buttons styles */
        --ig-button-foreground: #292826;
        --ig-button-background: #ffcd0f;
        --ig-button-hover-background: #404040;
        --ig-button-hover-foreground: #ffcd0f;
        --ig-button-focus-background: #ffcd0f;
        --ig-button-focus-foreground: black;
        --ig-button-focus-visible-background: #ffcd0f;
        --ig-button-focus-visible-foreground: black;
        --ig-button-disabled-foreground: #ffcd0f;
    }
    

    Demo

    API References

    En este artículo, aprendimos cómo utilizar la interfaz de usuario integrada para ocultar columnas en la barra de herramientas de IgcGridComponent. La interfaz de usuario que oculta columnas tiene algunas API más para explorar, que se enumeran a continuación.

    • ColumnActionsComponent

    Componentes adicionales con API relativas que se utilizaron:

    IgcColumnComponent properties:

    IgcGridToolbar properties:

    • showProgress

    IgcGridToolbar methods:

    IgcGridComponent events:

    • ColumnVisibilityChanged

    Additional Resources

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