Eventos de jTable
Eventos de jTable en JavaScript
La biblioteca jTable (un plugin de jQuery para la creación rápida de tablas CRUD) dispone de un completo sistema de eventos que permiten interceptar diferentes acciones del ciclo de vida de la tabla, de los formularios de edición/creación y de las operaciones AJAX con el servidor.
A continuación, se detallan los eventos principales, cuándo se disparan y qué parámetros (event, data) proporcionan.
1. Eventos de Carga y Visualización de Registros
loadingRecords(event, data)- Cuándo se dispara: Justo antes de que se envíe la petición AJAX al servidor para cargar o refrescar los registros.
- Argumentos: No contiene parámetros adicionales.
recordsLoaded(event, data)- Cuándo se dispara: Cuando jTable recibe los registros del servidor y actualiza la tabla (si la paginación está activa, también se ejecuta al cambiar de página).
- Propiedades de
data:data.records: Contiene todos los registros cargados desde el servidor.data.serverResponse: Objeto JSON completo devuelto por el servidor como respuesta.
2. Eventos del Ciclo de Vida de las Filas
rowInserted(event, data)- Cuándo se dispara: Cada vez que se inserta una nueva fila en la tabla mostrada (ya sea porque el usuario creó un registro o porque se cargaron los datos desde el servidor). Si se cargan múltiples registros, este evento se ejecuta por cada fila.
- Propiedades de
data:data.row: Fila insertada (como selección jQuery).data.record: Registro de datos asociado a esa fila.data.isNewRow: Booleano que se establece entruesi es un registro recién añadido por el usuario.
rowUpdated(event, data)- Cuándo se dispara: Inmediatamente después de que se actualiza una fila existente (se ejecuta tras
recordUpdated). - Propiedades de
data:data.row: Fila actualizada (como selección jQuery).data.record: Datos actualizados del registro.
- Cuándo se dispara: Inmediatamente después de que se actualiza una fila existente (se ejecuta tras
rowsRemoved(event, data)- Cuándo se dispara: Cuando se eliminan filas de la tabla (bien por borrado real en el servidor o durante una recarga de datos donde se limpian las filas anteriores).
- Propiedades de
data:data.rows: Todas las filas eliminadas (como selección jQuery).data.reason: Motivo de la eliminación ('deleted'si se borraron del servidor o'reloading'si la tabla se está recargando).
selectionChanged(event, data)- Cuándo se dispara: Cuando cambia la selección de filas de la tabla (al seleccionar/deseleccionar una fila, borrar una fila seleccionada, cambiar de página, etc.).
- Uso habitual: Permite recuperar las filas seleccionadas utilizando el método interno de jTable (
selectedRows).
3. Eventos de los Formularios (Crear y Editar)
formCreated(event, data)- Cuándo se dispara: Cuando el formulario flotante de creación o edición de un registro ha sido generado en el DOM.
- Propiedades de
data:data.form: Formulario como selección jQuery (ideal para personalizar campos o añadir eventos).data.formType: Indica el tipo de formulario ('create'o'edit').data.record: Registro que se está editando (solo disponible siformTypees'edit', permitiendo acceder a propiedades comodata.record.Nombre).data.row: Fila que se está editando (solo disponible en modo'edit').
formSubmitting(event, data)- Cuándo se dispara: Al hacer clic en el botón de guardar/enviar de un formulario de creación o edición, antes de enviar los datos al servidor.
- Propiedades de
data:data.form: Formulario como selección jQuery.data.formType: Tipo de formulario ('create'o'edit').data.row: Fila en edición (si aplica).
- Validación: Este evento permite validar los campos del formulario. Si la función de callback devuelve
false, la operación de envío se cancela automáticamente.
formClosed(event, data)- Cuándo se dispara: Cuando se cierra el diálogo del formulario de creación o edición.
- Propiedades de
data:data.form: Formulario como selección jQuery.data.formType: Tipo de formulario ('create'o'edit').data.row: Fila editada (si aplica).
closeRequested(event, data)- Cuándo se dispara: Cuando el usuario hace clic en el botón o icono de cierre del diálogo principal de la tabla (este botón se muestra solo si la opción
showCloseButtonestá configurada comotrue). - Argumentos: No recibe parámetros en
data.
- Cuándo se dispara: Cuando el usuario hace clic en el botón o icono de cierre del diálogo principal de la tabla (este botón se muestra solo si la opción
4. Eventos de Operaciones CRUD (Acciones de Datos)
recordAdded(event, data)- Cuándo se dispara: Cuando el usuario crea y guarda con éxito un nuevo registro en el servidor.
- Propiedades de
data:data.record: Datos del registro recién añadido.data.serverResponse: Objeto JSON devuelto por el servidor.
recordUpdated(event, data)- Cuándo se dispara: Cuando un registro existente se actualiza correctamente en el servidor.
- Propiedades de
data:data.record: Datos del registro actualizado.data.row: Fila de la tabla modificada.data.serverResponse: Objeto JSON de respuesta del servidor.
recordDeleted(event, data)- Cuándo se dispara: Cuando se elimina con éxito un registro del servidor.
- Propiedades de
data:data.record: Datos del registro eliminado.data.row: Fila eliminada de la tabla.data.serverResponse: Objeto JSON de respuesta del servidor.