Blazor Hierarchical Grid Row Adding

    La función de adición de filas Ignite UI for Blazor en Blazor Hierarchical Grid permite a los usuarios ingresar y enviar nuevos registros de datos sin navegar a un formulario o página separados. Con IgbHierarchicalGrid, los usuarios pueden manipular datos mediante la adición de filas en línea y una API poderosa para operaciones CRUD. Agregue un componente IgbActionStrip con acciones de edición habilitadas en la plantilla de la cuadrícula. Después de eso, pase el cursor sobre una fila y use el botón provisto. Finalmente, presione ALT + + para generar la interfaz de usuario de adición de filas.

    Blazor Hierarchical Grid Row Adding Example

    EXAMPLE
    MODULES
    DATA
    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.

    Row Adding Usage

    A continuación, defina una fuente de IgbHierarchicalGrid datos enlazada, RowEditable establecida en true y un IgbActionStrip componente con acciones de edición habilitadas. La AddRow entrada controla la visibilidad del botón que genera la interfaz de usuario de adición de filas.

    <IgbHierarchicalGrid AutoGenerate="false" Id="hGrid" PrimaryKey="Debut" RowEditable="true">
        <IgbColumn Field="Artist" Header="Artist" DataType="GridColumnDataType.String"></IgbColumn>
        <IgbColumn Field="HasGrammyAward" Header="Has Grammy Award" DataType="GridColumnDataType.Boolean"></IgbColumn>
        <IgbColumn Field="Debut" Header="Debut" DataType="GridColumnDataType.Number"></IgbColumn>
        <IgbColumn Field="GrammyNominations" Header="Grammy Nominations" DataType="GridColumnDataType.Number"></IgbColumn>
        <IgbColumn Field="GrammyAwards" Header="Grammy Awards" DataType="GridColumnDataType.Number"></IgbColumn>
    
        <IgbActionStrip>
            <IgbGridEditingActions AddRow="true"></IgbGridEditingActions>
        </IgbActionStrip>
        
        <IgbRowIsland AutoGenerate="false" Key="Albums" PrimaryKey="USBillboard200" RowEditable="true">
            <IgbColumn Field="Album" Header="Album" DataType="GridColumnDataType.Number"></IgbColumn>
            <IgbColumn Field="LaunchDate" Header="Launch Date" DataType="GridColumnDataType.Date"></IgbColumn>
            <IgbColumn Field="BillboardReview" Header="Billboard Review" DataType="GridColumnDataType.Number"></IgbColumn>
            <IgbColumn Field="USBillboard200" Header="US Billboard 200" DataType="GridColumnDataType.Number"></IgbColumn>
            <IgbColumn Field="GrammyAwards" Header="Grammy Awards" DataType="GridColumnDataType.Number"></IgbColumn>
    
            <IgbRowIsland AutoGenerate="false" Key="Songs" PrimaryKey="Number" RowEditable="true">
                <IgbColumn Field="Number" Header="Number" DataType="GridColumnDataType.String"></IgbColumn>
                <IgbColumn Field="Title" DataType="GridColumnDataType.String"></IgbColumn>
                <IgbColumn Field="Released" DataType="GridColumnDataType.Date"></IgbColumn>
                <IgbColumn Field="Genre" DataType="GridColumnDataType.String"></IgbColumn>
    
                <IgbActionStrip>
                    <IgbGridEditingActions AddRow="true"></IgbGridEditingActions>
                </IgbActionStrip>
            </IgbRowIsland>
    
            <IgbActionStrip>
                <IgbGridEditingActions AddRow="true"></IgbGridEditingActions>
            </IgbActionStrip>
        </IgbRowIsland>
    </IgbHierarchicalGrid>
    razor

    Nota: La configuración de la clave principal es obligatoria para las operaciones de adición de filas.

    Nota: Todas las columnas, excepto la clave principal, se pueden editar en la fila que agrega la interfaz de usuario de forma predeterminada. Si desea deshabilitar la edición de una columna específica, debe establecer la entrada de la columna Editable en false.

    Nota: La entrada IgbGridEditingActions que controla la visibilidad del botón Agregar fila puede usar el contexto de la tira de acción (que es del tipo IgbRowType para ajustar qué registros muestra el botón.

    El interno BaseTransactionService se proporciona IgbHierarchicalGrid automáticamente. Mantiene los cambios de celda pendientes hasta que se envía o cancela el estado de la fila.

    Start Row Adding Programmatically

    IgbHierarchicalGrid permite generar mediante programación la interfaz de usuario de agregar fila mediante dos métodos públicos diferentes. Uno que acepta un identificador de fila para especificar la fila en la que debe aparecer la interfaz de usuario y otro que funciona por índice. Puede usar estos métodos para generar la interfaz de usuario en cualquier lugar dentro de la vista de datos actual. No se admite cambiar la página o especificar una fila que, por ejemplo, esté filtrada.

    El uso BeginAddRowById requiere que especifique la fila que se utilizará como contexto para la operación mediante su RowID (PK). Luego, el método funciona como si el usuario final hiciera clic en el botón agregar fila de acción para la fila especificada, generando la interfaz de usuario debajo de ella. También puede hacer que la interfaz de usuario se genere como la primera fila de la cuadrícula pasando null para el primer parámetro.

    @code {
        await this.grid.BeginAddRowByIdAsync('ALFKI', false);  // Spawns the add row UI under the row with PK 'ALFKI'
        await this.grid.BeginAddRowByIdAsync(null, false);     // Spawns the add row UI as the first record
    }
    razor

    El método beginAddRowByIndex funciona de manera similar, pero requiere que especifiques el índice en el que debe generarse la interfaz de usuario. Los valores permitidos oscilan entre 0 y el tamaño de la vista de datos: 1.

    @code {
        await this.grid.BeginAddRowByIndexAsync(10);   // Spawns the add row UI at index 10
        await this.grid.BeginAddRowByIndexAsync(0);    // Spawns the add row UI as the first record
    }
    razor

    Positioning

    • La posición predeterminada de la interfaz de usuario para agregar filas está debajo de la fila en la que el usuario final hizo clic en el botón Agregar fila.

    • Se IgbHierarchicalGrid desplaza para mostrar completamente la interfaz de usuario de agregar fila automáticamente.

    • La superposición de la interfaz de usuario para agregar fila mantiene su posición durante el desplazamiento.

    Behavior

    La interfaz de usuario para agregar filas tiene el mismo comportamiento que la de edición de filas, ya que están diseñadas para brindar una experiencia de edición consistente a los usuarios finales. Consulte el tema Edición de filas de cuadrícula jerárquica para obtener más información.

    Después de agregar una nueva fila a través de la interfaz de usuario de adición de filas, su posición y/o visibilidad se determina mediante el estado de ordenación, filtrado y agrupación de la IgbHierarchicalGrid. En un IgbHierarchicalGrid que no tiene ninguno de estos estados aplicados, aparece como el último registro. Se muestra brevemente una barra de bocadillos que contiene un botón que el usuario final puede usar para desplazarse IgbHierarchicalGrid a su posición si no está a la vista.

    Keyboard Navigation

    • ALT + +: ingresa al modo de edición para agregar una fila
    • ESC sale del modo de agregar filas sin enviar ningún cambio

    • TAB mueve el foco de una celda editable en la fila a la siguiente y de la celda editable más a la derecha a los botones CANCELAR y LISTO. La navegación desde el botón LISTO va a la celda editable más a la izquierda dentro de la fila actualmente editada.

    Feature Integration

    • Cualquier operación de adición de filas se detendrá si se modifica la vista de datos de la IgbHierarchicalGrid fila. Se envían todos los cambios realizados por el usuario final. Las operaciones que cambian la vista de datos incluyen, entre otras, la ordenación, la agrupación, el filtrado, la paginación, etc.

    • Los resúmenes se actualizan una vez finalizada la operación de agregar filas. Lo mismo es válido para otras funciones dependientes de la vista de datos, como ordenar, filtrar, etc.

    • Al generar la interfaz de usuario para el IgbHierarchicalGrid, se contrae cualquier diseño secundario actualmente expandido para una fila en la que el usuario final hace clic en el botón Agregar fila.

    Customizing Row Adding Overlay

    Customizing Text

    Es posible personalizar el texto de la fila agregando superposición usando RowAddTextDirective.

    <IgbHierarchicalGrid Data="data" PrimaryKey="ProductID" AutoGenerate="false" RowEditable="true" RowAddTextTemplate="addTextTemplate">
    </IgbHierarchicalGrid>
    
    @code {
        private RenderFragment<IgbGridEmptyTemplateContext> addTextTemplate = (context) =>
        {
            return @<span>Adding Row</span>;
        };
    }
    razor

    Customizing Buttons

    Es posible personalizar los botones de la superposición de edición de filas utilizando la plantilla RowEditActions.

    <IgbHierarchicalGrid Data="data" PrimaryKey="ProductID" AutoGenerate="false" RowEditable="true" RowEditActionsTemplateScript="rowEditActionsTemplate">
    </IgbHierarchicalGrid>
    
    //In JavaScript:
    igRegisterScript("rowEditActionsTemplate", (endRowEdit) => {
        var html = window.igTemplating.html;
        return html`<div class="row-actions">
            <button @click="${evt => endRowEdit.implicit(false, evt)}">Cancel</button>
            <button @click="${evt => endRowEdit.implicit(true, evt)}">Apply</button>
        </div>`
    }, false);
    razor

    Nota: El uso de la plantilla RowEditActions cambiará las acciones de edición tanto para editar como para agregar botones superpuestos.

    Styling

    La interfaz de usuario para agregar filas comprende los botones en las acciones de edición IgbActionStrip, los editores de edición y la superposición, así como la barra de bocadillos que permite a los usuarios finales desplazarse a la fila recién agregada. Para diseñar estos componentes, puede consultar estas guías completas en sus respectivos temas:

    API References

    Additional Resources

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