Web Components Adición de filas de cuadrícula de árboles

    Proporciona IgcTreeGridComponent una forma conveniente de realizar manipulaciones de datos a través de la adición de filas en línea y una potente API para operaciones CRUD Web Components. Agregue un IgcActionStrip componente con acciones de edición habilitadas en la plantilla de la cuadrícula, coloque el cursor sobre una fila y use el botón proporcionado, presione ALT + + para generar la interfaz de usuario de adición de fila o ALT + SHIFT + + para generar la interfaz de usuario para agregar un elemento secundario para la fila seleccionada.

    Web Components Tree Grid Row Adding Example

    Row Adding Usage

    A continuación, defina una fuente de IgcTreeGridComponent datos enlazada, rowEditable establecida en true y un IgcActionStrip 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.

    <igc-tree-grid id="treeGrid" primary-key="ID" foreign-key="ParentID" row-editable="true">
    <igc-column field="Name" data-type="String"></igc-column>
    <igc-column field="Title" data-type="String"></igc-column>
    <igc-column field="HireDate" data-type="Date"></igc-column>
    <igc-column field="OnPTO" data-type="Boolean" width="130px">
    </igc-column>
    <igc-column field="Age" data-type="Number"></igc-column>
    <igc-action-strip id="actionstrip">
        <igc-grid-editing-actions add-row="true">
        </igc-grid-editing-actions>
    </igc-action-strip>
</igc-tree-grid>

    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: Las IgcGridEditingActions entradas que controlan la visibilidad de los botones Agregar fila y agregar botones secundarios pueden usar el contexto de la tira de acciones (que es del tipo IgcRowType para ajustar los registros para los que se muestran los botones.

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

    Start Row Adding Programmatically

    IgcTreeGridComponent 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 el cambio de página o la especificación de una fila que, por ejemplo, esté filtrada.

    El uso beginAddRowById requiere que especifique la fila que se va a utilizar como contexto para la operación por its RowID (PK). A continuación, el método funciona como si el usuario final hiciera clic en el botón de la tira de acción Agregar fila para la fila especificada, generando la interfaz de usuario debajo de ella. El segundo parámetro controla si la fila se agrega como elemento secundario a la fila de contexto o como elemento del mismo nivel. También puede hacer que la interfaz de usuario aparezca como la primera fila de la cuadrícula pasando null el primer parámetro.

    this.treeGrid.beginAddRowById('ALFKI', true);   // Spawns the add row UI to add a child for the row with PK 'ALFKI'
this.treeGrid.beginAddRowById(null);            // Spawns the add row UI as the first record

    El beginAddRowByIndex método funciona de manera similar, pero la fila que se va a usar como contexto se especifica mediante el índice.

    this.treeGrid.beginAddRowByIndex(10, true);   // Spawns the add row UI to add a child for the row at index 10
this.treeGrid.beginAddRowByIndex(null);       // Spawns the add row UI as the first record

    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 IgcTreeGridComponent 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 la cuadrícula de árbol para obtener más información.

    Una vez que se agrega 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 IgcTreeGridComponent. En un IgcTreeGridComponent 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 IgcTreeGridComponent a su posición si no está a la vista.

    Keyboard Navigation

    • ALT + +: ingresa al modo de edición para agregar una fila
    • ALT + SHIFT + + - Enters edit mode for adding a child

    • 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 IgcTreeGridComponent fila. Se envían todos los cambios realizados por el usuario final. Las operaciones que cambian la vista de datos incluyen, entre otras, ordenación, agrupación, filtrado, paginación, etcétera.

    • 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.

    Customizing Row Adding Overlay

    Customizing Text

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

    this.grid.rowAddTextTemplate = (ctx: IgcGridEmptyTemplateContext) => {
    return html`Adding Row`;
}

    Styling

    La interfaz de usuario de adición de filas comprende los botones de las IgcActionStrip acciones de edición, los editores de edición y la superposición, así como la barra de aperitivos que permite a los usuarios finales desplazarse a la fila recién agregada. Para aplicar estilo a estos componentes, puede consultar estas guías completas en sus temas respectivos:

    API References

    Additional Resources

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