/

Barra de herramientas de la cuadrícula y el menú Más opciones

La barra de herramientas de la cuadrícula y su menú "⋯ Más opciones", que agrupa varios controles de visualización del lado del cliente detrás de un único botón.

Resumen

La mayor parte de la barra de herramientas de la cuadrícula -Añadir, agrupar por, búsqueda, el panel de filtro avanzado- está controlada directamente por los métodos que llamas en PHP. Algunos controles son distintos: son interruptores puramente del lado del cliente que un visitante cambia a su antojo en su propio navegador, independientemente de tu configuración en PHP (aunque algunos igualmente necesitan que exista un interruptor de configuración). Esos viven detrás del botón "⋯ Más opciones" para que la barra de herramientas principal no se sature. El menú solo muestra las secciones que realmente son relevantes para la página actual; una página sin ninguna llamada a group_by_columns(), por ejemplo, nunca muestra una sección de agrupación.

Interruptor de visibilidad de columnas

Permite que un visitante oculte/muestre columnas individuales de la cuadrícula a voluntad, independientemente de lo que columns() haya configurado para la página. Está controlado por un único interruptor de configuración a nivel de sitio, sin anulación por página:

public static bool $columnVisibilityToggle = true;

Cuando está activado (por defecto), toda cuadrícula recibe una sección "Columnas" en el menú Más opciones con una casilla por columna; desmarcar una la elimina inmediatamente del encabezado/cuerpo/pie de sumas, del lado del cliente. La elección se recuerda durante la sesión actual del navegador, pero no persiste entre días o dispositivos. No existe una llamada al estilo XcrudConfig por página para incluir o excluir una sola tabla; está activado para todas las cuadrículas, o desactivado para todas ellas.

Expandir/colapsar todos los grupos

Solo aparece una vez que una página llama a group_by_columns() (consulta https://xcrudnova.xcrud.net/docs/es/grouped-rows-sums-and-reports). El menú muestra un único interruptor que expande todos los grupos a la vez, o los colapsa todos: un atajo frente a hacer clic en cada encabezado de grupo individualmente.

Selector de disposición del formulario / modo de edición

El mismo selector de modo de edición descrito en Opciones de disposición del formulario también se puede acceder desde este menú; es la forma en que un visitante llega a los dos modos de vista dividida exclusivos de JS (split_left/split_right) que set_edit_mode() por sí solo no puede establecer. El menú lista los cinco: vista lateral, vista dividida - izquierda, vista dividida - derecha, modal y normal. Elegir uno se aplica de inmediato, incluso reabriendo un formulario ya abierto en el nuevo modo en lugar de esperar a una actualización.

Mostrar cuadros de búsqueda en los encabezados de la cuadrícula

Activa o desactiva los campos de búsqueda por columna en el encabezado (la fila de pequeños cuadros de texto bajo los títulos de columna). Se muestran por defecto; la elección de un visitante aquí se recuerda por sesión de navegador, igual que las elecciones del interruptor de visibilidad de columnas.

Relacionado: edición en línea con clic

No forma parte del menú Más opciones en sí, pero está relacionado con la barra de herramientas: al hacer clic directamente sobre una celda de la cuadrícula se edita ese campo en el sitio, sin abrir el formulario completo de añadir/editar. Funciona junto con el modo de edición que esté activo y no requiere configuración adicional para habilitarse; forma parte del comportamiento base de la cuadrícula.

Qué depende de la configuración y qué es un interruptor puramente del cliente

Función¿Controlada por configuración?¿Anulación por página?
Interruptor de visibilidad de columnasSí - XcrudConfig::$columnVisibilityToggleNo - solo a nivel de sitio
Expandir/colapsar todos los gruposAparece automáticamente cuando se define group_by_columns()N/D
Selector de disposición del formulario / modo de ediciónModo inicial mediante set_edit_mode()Sí, por página; el visitante puede seguir cambiándolo en vivo
Mostrar cuadros de búsqueda en los encabezados de la cuadrículaNo - interruptor puramente del clienteN/D (se recuerda por sesión)
Edición en línea con clicNo - siempre disponibleN/D