Edición de celdas en cuadrícula jerárquica Blazor

    La Ignite UI for Blazor en Blazor Hierarchical Grid ofrece una gran capacidad de manipulación de datos del contenido de celdas individuales dentro del componente Blazor Hierarchical Grid y viene con una potente API para operaciones CRUD React. Es una característica fundamental en aplicaciones como hojas de cálculo, tablas de datos y cuadrículas de datos, que permite a los usuarios agregar, editar o actualizar datos dentro de celdas específicas. De forma predeterminada, la cuadrícula en Ignite UI for Blazor se utiliza en la edición de celdas. Y debido a la plantilla de edición de celdas predeterminada, habrá diferentes editores según el tipo de datos de la columna Parte superior del formulario.

    Además, puede definir sus propias plantillas personalizadas para acciones de actualización de datos y anular el comportamiento predeterminado para confirmar y descartar cualquier cambio.

    Blazor Hierarchical Grid Cell Editing and Edit Templates Example

    EXAMPLE
    DATA
    MODULES
    RAZOR
    CSS

    Like this sample? Get access to our complete Ignite UI for Blazor toolkit and start building your own apps in minutes. Download it for free.

    Edición de celdas

    Editing through UI

    Puede ingresar al modo de edición para una celda específica, cuando una celda editable está enfocada de una de las siguientes maneras:

    • al hacer doble clic;
    • con un solo clic: un solo clic ingresará al modo de edición solo si la celda seleccionada previamente estaba en modo de edición y la celda actualmente seleccionada es editable. Si la celda previamente seleccionada no estaba en modo de edición, un solo clic seleccionará la celda sin ingresar al modo de edición;
    • en la tecla presione Enter;
    • en la tecla presione F2;

    Puede salir del modo de edición sin realizar los cambios de una de las siguientes maneras:

    • en la tecla presione Escape;
    • cuando realiza operaciones de clasificación, filtrado, búsqueda y ocultación;

    Puede salir del modo de edición y confirmar los cambios de una de las siguientes maneras:

    • en la tecla presione Enter;
    • en la tecla presione F2;
    • en la tecla presione Tab;
    • Con un solo clic en otra celda: al hacer clic en IgbHierarchicalGrid otra celda, se enviarán los cambios.
    • operaciones como paginación, cambio de tamaño, anclar o mover saldrán del modo de edición y se enviarán los cambios.

    The cell remains in edit mode when you scroll vertically or horizontally or click outside the IgbHierarchicalGrid. This is valid for both cell editing and row editing.

    Editing through API

    También puede modificar el valor de la celda a través de la API, pero solo si se define la IgbHierarchicalGrid clave principal:

    @code {
        this.hierarchicalGrid.UpdateCell(newValue, rowID, 'ReorderLevel');
    }
    razor

    Otra forma de actualizar la celda es directamente a través del Update método de Cell:

    @code {
        private UpdateCell() {
            IgbCell cell = this.hierarchicalGrid.GetCellByColumn(rowIndex, "ReorderLevel");
            cell.Update(70);
        }
    }
    razor

    Cell Editing Templates

    Puede ver y obtener más información sobre las plantillas de edición de celdas predeterminadas en el tema de edición general.

    Si desea proporcionar una plantilla personalizada que se aplicará a una celda, puede pasar dicha plantilla a la celda misma o a su encabezado. Primero cree la columna como lo haría normalmente:

    <IgbColumn
        Field="Age"
        DataType="GridColumnDataType.String"
        InlineEditorTemplateScript="WebGridCellEditCellTemplate"
        Editable="true"
        Name="column1"
        @ref="column1">
    </IgbColumn>
    razor

    y pasa la plantilla:

    *** In JavaScript ***
    
    igRegisterScript("WebGridCellEditCellTemplate", (ctx) => {
        let cellValues = [];
        let uniqueValues = [];
        for(const i of ctx.cell.grid.data){
            const field = ctx.cell.column.field;
            if(uniqueValues.indexOf(i[field]) === -1 )
            {
                cellValues.push(html`<igc-select-item value=${i[field]}>${(i[field])}</igc-select-item>`);
                uniqueValues.push(i[field]);
            }
        }
        return html`<div>
        <igc-select position-strategy="fixed" @igcChange=${ e => ctx.cell.editValue = e.detail.value}>
              ${cellValues}
        </igc-select>
    </div>`;
    }, false);
    razor

    Puede encontrar una muestra funcional de lo anterior aquí para mayor referencia:

    EXAMPLE
    DATA
    MODULES
    RAZOR
    JS
    CSS

    CRUD operations

    Please keep in mind that when you perform some CRUD operation all of the applied pipes like filtering, sorting and grouping will be re-applied and your view will be automatically updated.

    Proporciona IgbHierarchicalGrid una API sencilla para operaciones CRUD básicas.

    Adding a new record

    El IgbHierarchicalGrid componente expone el AddRow método que agregará los datos proporcionados a la propia fuente de datos.

    @code {
        //Assuming we have a `GetNewRecord` method returning the new row data.
        const record = this.GetNewRecord();
        this.HierarchicalGridRef.AddRow(record);
    }
    razor

    Updating data in the Hierarchical Grid

    La actualización de datos en la cuadrícula jerárquica se logra a través de UpdateRow métodos UpdateCell, pero solo si se define la clave principal de la cuadrícula. También puede actualizar directamente un valor de celda y/o fila a través de sus respectivos métodos de actualización.

    @code {
        // Updating the whole row
        this.hierarchicalGrid.UpdateRow(newData, this.selectedCell.cellID.rowID);
    
        // Just a particular cell through the Tree Grid API
        this.hierarchicalGrid.UpdateCell(newData, this.selectedCell.cellID.rowID, this.selectedCell.column.field);
    
        // Directly using the cell `update` method
        this.selectedCell.Update(newData);
    
        // Directly using the row `update` method
        IgbRowType row = this.hierarchicalGrid.GetRowByKey(rowID);
        row.Update(newData);
    }
    razor

    Deleting data from the Hierarchical Grid

    Tenga en cuenta que el método DeleteRow eliminará la fila especificada solo si se define una PrimaryKey.

    @code {
        // Delete row through Grid API
        this.hierarchicalGrid.DeleteRow(this.selectedCell.cellID.rowID);
        // Delete row through row object
        IgbRowType row = this.hierarchicalGrid.GetRowByIndex(rowIndex);
        row.Del();
    }
    razor

    Cell Validation on Edit Event

    Usando los IgbHierarchicalGrid eventos de edición, podemos alterar la forma en que el usuario interactúa con el IgbHierarchicalGrid.

    En este ejemplo, validaremos una celda según los datos ingresados en ella vinculándola al evento CellEdit. Si el nuevo valor de la celda no cumple con nuestros criterios predefinidos, evitaremos que llegue a la fuente de datos cancelando el evento.

    Lo primero que tenemos que hacer es enlazar al evento de la cuadrícula:

    <IgbHierarchicalGrid CellEditScript="HandleCellEdit" />
    razor

    CellEdit se emite cada vez que el valor de cualquier celda está a punto de confirmarse. En nuestra definición de CellEdit, debemos asegurarnos de verificar nuestra columna específica antes de realizar cualquier acción:

    *** In JavaScript ***
    igRegisterScript("HandleCellEdit", (ev) => {
        const today = new Date();
        const column = event.detail.column;
    	if (column.field === 'Debut') {
    		if (event.detail.newValue > today.getFullYear()) {
    			event.detail.cancel = true;
    			alert('The debut date must be in the past!');
    		}
    	} else if (column.field === 'LaunchDate') {
    		if (event.detail.newValue > today) {
    			event.detail.cancel = true;
    			alert('The launch date must be in the past!');
    		}
    	}
    }, false);
    razor

    Aquí, estamos validando dos columnas. Si el usuario intenta cambiar el año de debut de un artista o la fecha de lanzamiento de un álbum, la cuadrícula no permitirá fechas posteriores a la actual.

    El resultado de la aplicación de la validación anterior a nuestro IgbHierarchicalGrid se puede ver en la siguiente demostración:

    EXAMPLE
    DATA
    MODULES
    RAZOR
    JS
    CSS

    Styling

    Además de los temas predefinidos, la cuadrícula se puede personalizar aún más configurando algunas de las propiedades CSS disponibles. En caso de que desee cambiar algunos de los colores, primero debe establecer una clase para la cuadrícula:

    <IgbHierarchicalGrid Class="hierarchicalGrid"></IgbHierarchicalGrid>
    razor

    Luego configure las propiedades CSS relacionadas para esa clase:

    .hierarchicalGrid {
        --ig-grid-edit-mode-color: orange;
        --ig-grid-cell-editing-background: lightblue;
    }
    css

    Styling Example

    EXAMPLE
    DATA
    MODULES
    RAZOR
    CSS

    API References

    Additional Resources