Edición de celdas de cuadrícula Blazor

La Ignite UI for Blazor Cell Editing en Blazor Grid proporciona una excelente capacidad de manipulación de datos del contenido de celdas individuales dentro del componente Blazor Grid y viene con una potente API para operaciones React CRUD. 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 usa en la edición de celdas. Y debido a la plantilla de edición de celda 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 Grid Cell Editing and Edit Templates Example

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: cuando haga clic en otra celda en IgbGrid, se enviarán sus 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.

[!Note] The cell remains in edit mode when you scroll vertically or horizontally or click outside the IgbGrid. 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 IgbGrid, pero solo si está definida la clave principal:

this.grid.UpdateCell(newValue, rowID, 'ReorderLevel')

Otra forma de actualizar la celda es directamente mediante el método Update de IgbCell:

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

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="Race"
    DataType="GridColumnDataType.String"
    InlineEditorTemplateScript="WebGridCellEditCellTemplate"
    Editable="true"
    Name="column1"
    @ref="column1">
</IgbColumn>

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);

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

Grid Excel Style Editing

El uso de la edición de estilo de Excel permite al usuario navegar a través de las celdas tal como lo haría con Excel y editarlas muy rápidamente.

La implementación de esta funcionalidad personalizada se puede realizar utilizando los eventos de IgbGrid. Primero nos conectamos a los eventos de keydown del grid y desde allí podemos implementar dos funcionalidades:

Modo de edición constante

Entrar / Mayús+Entrar navegación

Las partes clave para encontrar el próximo índice elegible serían:

Consulte la muestra completa para obtener más referencias:

Muestra de edición de estilo de Excel Blazor Grid

Los principales beneficios del enfoque anterior incluyen:

Modo de edición constante: al escribir mientras se selecciona una celda, se ingresará inmediatamente al modo de edición con el valor ingresado, reemplazando el existente
Cualquier fila que no sea de datos se omite al navegar con Enter / Shift+Enter. Esto permite a los usuarios recorrer rápidamente sus valores.

CRUD operations

[!Note] 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.

IgbGrid proporciona una API sencilla para operaciones CRUD básicas.

Adding a new record

El componente IgbGrid expone el método AddRow 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.GridRef.AddRow(record);
}

Updating data in the Grid

La actualización de datos en Grid se logra mediante los métodos UpdateRow y UpdateCell, pero solo si se define la clave primaria para el grid. 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.grid.UpdateRow(newData, this.selectedCell.cellID.rowID);

    // Just a particular cell through the Grid API
    this.grid.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.grid.GetRowByKey(rowID);
    row.Update(newData);
}

Deleting data from the 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.grid.DeleteRow(this.selectedCell.cellID.rowID);
    // Delete row through row object
    IgbRowType row = this.grid.GetRowByIndex(rowIndex);
    row.Del();
}

Cell Validation on Edit Event

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

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:

<IgbGrid CellEditScript="HandleCellEdit" />

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) => {
    var d = ev.detail;
    if (d.column != null && d.column.field == "UnitsOnOrder") {
        if (d.newValue > d.rowData.UnitsInStock) {
            d.cancel = true;
            alert("You cannot order more than the units in stock!")
        }
    }
}, false);

Si el valor ingresado en una celda debajo de la columna Unidades en pedido es mayor que la cantidad disponible (el valor en Unidades en stock), la edición se cancelará y se alertará al usuario sobre la cancelación.

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

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:

<IgbGrid Class="grid"></IgbGrid>

Luego configure las propiedades CSS relacionadas para esa clase:

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