React Grid Keyboard Navigation - Ignite UI for React

The Ignite UI for React Keyboard Navigation feature in React Grid provides a rich variety of keyboard interactions for the user. It enhances the accessibility of the IgrGrid and allows the user to navigate through any type of elements inside (cell, row, column header, toolbar, footer, etc.). This functionality is enabled by default, and the developer has the option to override any of the default behaviors in an easy way.

The tabulations of the IgrGrid has been reduced so that the navigation is compliant with W3C accessibility standards and convenient to use.

Currently, the IgrGrid introduces the following tab stops:

Área GroupBy o Barra de herramientas (si está habilitada).
Grid header.
Grid body.
Column summaries (if enabled).
Paginador de cuadrícula (si está habilitado).

[!Note] Due to this change, navigating between the cells with TAB and SHIFT + TAB is no longer supported in the IgrGrid. Pressing the TAB key now goes through the tab stops in the following order: GroupBy / Toolbar -> Headers -> Body -> Summaries -> Footer / Paginator.

[!Note] Exposing any focusable element into the IgrGrid body via template may introduce side effects in the keyboard navigation, since the default browser behavior is not prevented. It is the developer's responsibility to prevent or modify it appropriately.

A full keyboard navigation support in the IgrGrid header is now introduced. Column headers can be easily traversed with the arrow keys. Additionally, there are a number of key combinations that trigger actions on the columns like filtering, sorting, grouping and etc. When the IgrGrid header container is focused, the following key combinations are available:

Key Combinations

↑ navega una celda hacia arriba en los encabezados (sin bucles). Disponible solo cuando se definen Diseño de varias filas (MRL) o Encabezados de varias columnas (MCH).
↓ navega una celda hacia abajo en los encabezados (sin ajuste). Disponible solo cuando se definen Diseño de varias filas (MRL) o Encabezados de varias columnas (MCH).
← navega una celda hacia la izquierda (sin bucles).
→ navega una celda hacia la derecha (sin ajustar entre líneas).
CTRL + ← navega a la celda más a la izquierda de la fila; si MRL o MCH están habilitados, navega a la celda más a la izquierda en el mismo nivel.
HOME navega a la celda más a la izquierda de la fila; si MRL o MCH están habilitados, navega a la celda más a la izquierda en el mismo nivel.
CTRL + → navega a la celda más a la derecha de la fila; si MRL o MCH están habilitados, navega a la celda más a la derecha en el mismo nivel.
END navega a la celda más a la derecha de la fila; si MRL o MCH están habilitados, navega a la celda más a la derecha en el mismo nivel.
ALT + L abre el cuadro de diálogo Filtrado avanzado si el filtrado avanzado está habilitado.
CTRL + SHIFT + L abre el cuadro de diálogo Filtro de estilo de Excel o el filtro predeterminado (fila) si la columna se puede filtrar.
CTRL + ↑ ordena el encabezado de columna activo en orden ASC. Si la columna ya está ordenada en ASC, se borra el estado de ordenación.
CTRL + ↓ ordena el encabezado de columna activo en orden de DSC. Si la columna ya está ordenada en DSC, se borra el estado de ordenación.
SPACE selecciona la columna. Si la columna ya está seleccionada, la selección está desactivada.

SHIFT + ALT + ← agrupa la columna, si la columna está marcada como agrupable.

SHIFT + ALT + → desagrupa la columna, si la columna está marcada como agrupable.
ALT + ← o ALT + ↑ contrae el encabezado del grupo de columnas, si el encabezado aún no está contraído.
ALT + → o ALT + ↓ expande el encabezado del grupo de columnas, si el encabezado aún no está expandido.

When the IgrGrid body is focused, the following key combinations are available:

Key Combination

↑- navega una celda hacia arriba.
↓ navega una celda hacia abajo.

← navega una celda hacia la izquierda (sin ajustar entre líneas).
→- navega una celda hacia la derecha (sin ajustar entre líneas).
CTRL + ← navega a la celda más a la izquierda de la fila.
CTRL + → navega a la celda más a la derecha de la fila.
CTRL + ↑ navega a la primera celda de la columna.
CTRL + ↓ navega a la última celda de la columna.
HOME navega a la celda más a la izquierda de la fila.
END navega a la celda más a la derecha de la fila.
CTRL + HOME navega a la celda de datos superior izquierda de la cuadrícula.
CTRL + END navega a la celda de datos inferior derecha de la cuadrícula.
PAGE UP se desplaza una página (ventana gráfica) hacia arriba.
PAGE DOWN se desplaza una página (puerto de visualización) hacia abajo.
ENTER Entra en modo de edición.
F2 enters edit mode.
ESC sale del modo de edición.
TAB disponible solo si hay una celda en modo de edición; mueve el foco a la siguiente celda editable de la fila; Después de llegar a la última celda de la fila, mueve el foco TE a la primera celda editable de la siguiente fila. Cuando la edición de filas está habilitada, mueve el foco de la celda editable más a la derecha a los botones CANCELAR y LISTO, y del botón LISTO a la celda editable más a la izquierda de la fila.
SHIFT + TAB- disponible solo si hay una celda en modo de edición; mueve el foco a la celda editable anterior de la fila; después de llegar a la primera celda de la fila, mueve el foco a la última celda editable de la fila anterior. Cuando la edición de filas está habilitada, mueve el foco de la celda editable más a la derecha a los botones CANCELAR y LISTO, y del botón LISTO a la celda editable más a la derecha de la fila.
SPACE- selecciona la fila, si la selección de filas está habilitada.
ALT + ← o ALT + ↑-

sobre la fila del grupo: colapsa el grupo.

ALT + → or ALT + ↓ - over Group Row - expands the group.

ALT + ← o ALT + ↑- sobre la fila de detalles maestra: contrae la vista de detalles.
ALT + → o ALT + ↓- sobre la fila de detalles maestros: expande la vista de detalles.
SPACE - over Group Row - selects all rows in the group, if rowSelection property is set to multiple.

Practique todas las acciones mencionadas anteriormente en el ejemplo de demostración a continuación. Enfoque cualquier elemento de la cuadrícula navegable y se mostrará una lista con algunas de las acciones disponibles para el elemento para guiarlo.

Manifestación

Anular el comportamiento predeterminado para una determinada tecla o combinación de teclas es uno de los beneficios que proporciona la característica de navegación con teclado. Por ejemplo: presione la ENTER tecla o TAB para navegar a la siguiente celda o a la celda de abajo. Este o cualquier otro escenario de navegación se logra fácilmente mediante la API de navegación por teclado:

Let's try the API to demonstrate how to achieve common scenarios like user input validation and custom navigation. First we need to register an event handler for the GridKeydown event:

<IgrGrid id="grid1" primaryKey="ProductID" onGridKeydown={customKeydown}>
</IgrGrid>

const customKeydown = (eventArgs: IgrGridKeydownEventArgs) => {
  const args = eventArgs.detail;
  const target= args.target;
  const evt = args.event;
  const type = args.targetType;

  if (type === 'dataCell' && target.editMode && evt.key.toLowerCase() === 'tab') {
      // 1. USER INPUT VALIDATION ON TAB

  }
  if (type === 'dataCell' && evt.key.toLowerCase() === 'enter') {
      // 2. CUSTOM NAVIGATION ON ENTER KEY PRESS
  }
}

Con base en los valores de argumentos del evento, identificamos dos casos, donde proporcionar nuestra propia lógica (ver arriba). Ahora, usando los métodos de la API, realicemos lo deseado: si el usuario está presionando TAB la tecla sobre una celda en modo de edición, realizaremos la validación en la entrada:

    // 1. USER INPUT VALIDATION ON TAB
    if (target.column.dataType === 'number' && target.editValue < 10) {
        // alert the user that the input is invalid
        return;
    }

[!Note] Please refer to the sample code for full implementation details.

Utilice la demostración a continuación para probar los escenarios personalizados que acabamos de implementar:

Haga doble clic o presione la F2 tecla en una celda en una columna numérica, cambie el valor a 7 y presione TAB la tecla. Se mostrará un mensaje de aviso.
Seleccione una celda y presione ENTER la tecla un par de veces. Cada vez que se presiona una tecla, el foco se moverá a una celda en la siguiente fila, debajo de la misma columna.

Manifestación

Known Limitations

Limitación	Descripción
Navegando dentro de una cuadrícula con contenedor principal desplazable.	Si la cuadrícula se coloca dentro de un contenedor principal desplazable y el usuario navega a una celda de la cuadrícula que está fuera de la vista, el contenedor principal no se desplazará.

Additional Resources

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

Navegación por teclado de cuadrícula React

Header Navigation

Key Combinations

Body navigation

Key Combination

Manifestación

Custom Keyboard Navigation

Manifestación

Known Limitations

Additional Resources