Web Components Edición de celdas de cuadrícula

    La edición de celdas Ignite UI for Web Components en Web Components Grid proporciona una gran capacidad de manipulación de datos del contenido de celdas individuales dentro del componente Web Components 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, lo que permite a los usuarios agregar, editar o actualizar datos dentro de celdas específicas. De forma predeterminada, la cuadrícula de Ignite UI for Web Components se utiliza en la edición de celdas. Y debido a la plantilla de edición de celdas predeterminada, habrá diferentes editores basados en el tipo de datos de columna Top of Form.

    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.

    Web Components Ejemplo de edición de celdas de cuadrícula y plantillas de edición

    EXAMPLE
    TS
    HTML
    CSS
    Edit in:

    ¿Te gusta esta muestra? Obtenga acceso a nuestro kit de herramientas de Ignite UI for Web Components completo y comience a crear sus propias aplicaciones en minutos. Descárgalo gratis.

    Edición de celdas

    Edición a través de la interfaz de usuario

    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 IgcGridComponent, 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.

    La celda permanece en modo de edición cuando se desplaza vertical u horizontalmente o hace clic fuera de IgcGridComponent. Esto es válido tanto para la edición de celdas como para la edición de filas.

    Edición a través de API

    También puede modificar el valor de la celda a través de la API IgcGridComponent, pero solo si está definida la clave principal:

    public updateCell() {
    this.grid1.updateCell(newValue, rowID, 'ReorderLevel');
}
typescript

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

    public updateCell() {
    const cell = this.grid1.getCellByColumn(rowIndex, 'ReorderLevel');
    // You can also get cell by rowID if primary key is defined
    // cell = this.grid1.getCellByKey(rowID, 'ReorderLevel');
    cell.update(70);
}
typescript

    Plantillas de edición de celdas

    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:

    <igc-column
    field="Race"
    data-type="string"
    editable="true"
    id="column1">
</igc-column>
html

    y pase las plantillas a esta columna en el archivo index.ts:

    constructor() {
    var grid1 = document.getElementById('grid1') as IgcGridComponent;
    var column1 = document.getElementById('column1') as IgcColumnComponent;
    var column2 = document.getElementById('column2') as IgcColumnComponent;
    var column3 = document.getElementById('column3') as IgcColumnComponent;

    grid1.data = this.webGridCellEditSampleRoleplay;
    column1.inlineEditorTemplate = this.webGridCellEditCellTemplate;
    column2.inlineEditorTemplate = this.webGridCellEditCellTemplate;
    column3.inlineEditorTemplate = this.webGridCellEditCellTemplate;
}


public webGridCellEditCellTemplate = (ctx: IgcCellTemplateContext) => {
    let cellValues: any = [];
    let uniqueValues: any = [];
    for(const i of (this.webGridCellEditSampleRoleplay as any)){
        const field: string = 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`
        <igc-select style="width:100%; height:100%" size="large" @igcChange=${(e: any) => ctx.cell.editValue = e.detail.value}>
            ${cellValues}
        </igc-select>
    `;
}
typescript

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

    EXAMPLE
    DATA
    TS
    HTML
    CSS
    Edit in:

    Edición de estilo de cuadrícula de Excel

    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 IgcGridComponent. Primero nos conectamos a los eventos de keydown del grid y desde allí podemos implementar dos funcionalidades:

    • Modo de edición constante
    public keydownHandler(event) {
  const key = event.keyCode;
  const grid = this.grid;
  const activeElem = grid.navigation.activeNode;

  if ((key >= 48 && key <= 57) ||
      (key >= 65 && key <= 90) ||
      (key >= 97 && key <= 122)) {
        // Number or Alphabet upper case or Alphabet lower case
        const columnName = grid.getColumnByVisibleIndex(activeElem.column).field;
        const cell = grid.getCellByColumn(activeElem.row, columnName);
        if (cell && !grid.crudService.cellInEditMode) {
            grid.crudService.enterEditMode(cell);
            cell.editValue = event.key;
        }
    }
}
typescript
    • Entrar / Mayús+Entrar navegación
    if (key == 13) {
    let thisRow = activeElem.row;
    const column = activeElem.column;
    const rowInfo = grid.dataView;

    // to find the next eligible cell, we will use a custom method that will check the next suitable index
    let nextRow = this.getNextEditableRowIndex(thisRow, rowInfo, event.shiftKey);

    // and then we will navigate to it using the grid's built in method navigateTo
    this.grid.navigateTo(nextRow, column, (obj) => {
        obj.target.activate();
        this.grid.clearCellSelection();
        this.cdr.detectChanges();
    });
}
typescript

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

    //first we check if the currently selected cell is the first or the last
if (currentRowIndex < 0 || (currentRowIndex === 0 && previous) || (currentRowIndex >= dataView.length - 1 && !previous)) {
return currentRowIndex;
}
// in case using shift + enter combination, we look for the first suitable cell going up the field
if (previous) {
return  dataView.findLastIndex((rec, index) => index < currentRowIndex && this.isEditableDataRecordAtIndex(index, dataView));
}
// or for the next one down the field
return dataView.findIndex((rec, index) => index > currentRowIndex && this.isEditableDataRecordAtIndex(index, dataView));
typescript

    Consulte la muestra completa para obtener más referencias:

    Ejemplo de edición de estilo de Excel de cuadrícula de Web Components

    EXAMPLE
    DATA
    TS
    HTML
    CSS
    Edit in:

    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.
    Ignite UI for Web Components | CTA Banner

    operaciones CRUD

    Tenga en cuenta que cuando realice alguna operación CRUD, todas las canalizaciones aplicadas, como filtrado, clasificación y agrupación, se volverán a aplicar y su vista se actualizará automáticamente.

    ​IgcGridComponent proporciona una API sencilla para operaciones CRUD básicas.

    Agregar un nuevo registro

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

    // Adding a new record
// Assuming we have a `getNewRecord` method returning the new row data.
const record = this.getNewRecord();
this.grid.addRow(record);
typescript

    Actualizando datos en el 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.

    // 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
const row = this.grid.getRowByKey(rowID);
row.update(newData);
typescript

    Eliminar datos de la cuadrícula

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

    // Delete row through Grid API
this.grid.deleteRow(this.selectedCell.cellID.rowID);
// Delete row through row object
const row = this.grid.getRowByIndex(rowIndex);
row.delete();
typescript

    Validación de celda al editar evento

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

    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:

    constructor() {
    var grid = document.getElementById('grid') as IgcGridComponent;
    this.webGridCellEdit = this.webGridCellEdit.bind(this);
    grid.addEventListener("cellEdit", this.webGridCellEdit);
}
typescript

    ​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:

    public webGridCellEdit(event: CustomEvent<IgcGridEditEventArgs>): void {
    const column = event.detail.column;
    if (column.field === 'UnitsOnOrder') {
            const rowData = event.detail.rowData;
            if (!rowData) {
                return;
            }
            if (event.detail.newValue > rowData.UnitsInStock) {
                event.cancel = true;
                alert("You cannot order more than the units in stock!");
            }
    }
}

typescript

    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 IgcGridComponent se puede ver en la siguiente demostración:

    EXAMPLE
    TS
    HTML
    CSS
    Edit in:

    Estilo

    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:

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

    Luego configure las propiedades CSS relacionadas para esa clase:

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

    Ejemplo de estilo

    EXAMPLE
    TS
    HTML
    CSS
    Edit in:

    Referencias de API

    Recursos adicionales