# Tablas con uie.dbTable `uie.dbTable` (de `uielements.dbtable.dkl`) produce una tabla HTML completa con los resultados de una consulta: encabezados, filas, grupos con subtotales y total general, con formato por columna, atributos por tipo de fila y eventos para cambiar filas o celdas. Se basa en [uie.iterator](/es/devkron/2.0/marcos/uie/#uieiterator), así que incluya también `uielements.dkl`: ```dkl #include "uielements.dkl" #include "uielements.dbtable.dkl" ``` ```dkl do uie.dbTable(params) ``` ## Configuración Acepta todos los miembros de `uie.iterator` (`db`, `source`, `parameters`, `datatable`, `group_by`, `build_array`...) más: | Miembro | Descripción | |---|---| | `id` | `id` de la tabla; si se omite, `dbTable_` + un GUID | | `attributes` | Atributos del elemento `` | | `element` | Elemento de la tabla; predeterminado `table` | | `element_thead` | Elemento del encabezado; predeterminado `thead` | | `value_field` | Columna cuyo valor se pone en el atributo `data` de cada fila (útil para seleccionarla con JavaScript) | | `columns` | Un miembro por columna, en el orden de la tabla. **Si se omite, se muestran todas las columnas de la consulta** | | `show_summary_group` | `@false` omite los subtotales de grupo (predeterminado `@true`) | | `show_summary` | `@false` omite el total general (predeterminado `@true`) | | `rows_attributes` | Atributos por tipo de fila: `header`, `begin_group`, `detail`, `summary_group`, `summary` | | `before_row*`, `after_row*` | Eventos por fila: `f(¶ms, &row)` | | `before_cell*`, `after_cell*` | Eventos por celda: `f(¶ms, &row, &cell)` | Miembros de cada columna: | Miembro | Descripción | |---|---| | `caption` | Título; predeterminado, el nombre de la columna | | `field` | Campo de la consulta, si es distinto del nombre de la columna | | `summary` | `sum`, `max`, `min`, `avg` o `count`. Cualquier otro texto se muestra tal cual en la fila del total general (por ejemplo, `"Total"`) | | `format` | Formato al estilo de .NET: numérico (`#,0.00`) o, si contiene `/` o `:`, de fecha (`dd/MM/yyyy`) | | `attributes` | Atributos para todas las celdas de la columna | Igual que con `uie.iterator`, puede omitir `head`, `each_row`, `begin_group`, `summary_group` y `summary`: `uie.dbTable` pone los suyos (los que pintan la tabla). Si los define, sustituye la pieza correspondiente. ## Ejemplo: ventas por sucursal con subtotales ```dkl #include "dkli.dkh" #set "meta-xml-declaration" "" #! program "uie-tabla" { #include "functions.dkh" #include "serialize.dkh" #include "dbr.dkh" #include "uielements.dkl" #include "uielements.dbtable.dkl" // Evento: resalta las ventas mayores a 1000 resaltar::¶ms, &row, &cell { if @@(cell,"cell_type")=="data" && @@(cell,"column")=="importe" { if @@(row,"#importe") > 1000 { cell<"text">: "" + @@(cell,"text") + "" } } } ref db = dbr.login("principal@tienda", "web", "MiClave#2026") new t { @"db*": db @"source": "select sucursal, vendedor, fecha, importe from venta order by sucursal, fecha;" @"id": "ventas" @"group_by": "sucursal" member @"attributes" { @"class":"table" } member @"columns" { member @"vendedor" { @"caption":"Vendedor" @"summary":"count" } member @"fecha" { @"caption":"Fecha" @"format":"dd/MM/yyyy" } member @"importe" { @"caption":"Importe" @"summary":"sum" @"format":"#,0.00" member @"attributes" { @"class":"text-end" } } } member @"rows_attributes" { member @"summary" { @"class":"total" } } } t<"parameters*">: @null point f to resaltar t<"before_cell*">: f ## div { #! do uie.dbTable(t) #$ } ## do print("") do print("Total general: " + @@(t,"$summaries/sum/importe") + " filas: " + @@(t,"$summaries/count")) do dbr.close(db) } ``` Salida real (se separaron las filas en líneas para leerla; `do print` sale antes que la salida declarativa): ```html Total general: 4300.50 filas: 5
VendedorFechaImporte
Centro
Ana01/10/20261,200.00
Luis02/10/2026800.50
22,000.50
Norte
Marta01/10/2026450.00
Marta03/10/20261,550.00
Pedro04/10/2026300.00
32,300.00
54,300.50
``` Observe: - Las filas van directamente en la tabla, **sin ``**. - El texto de una celda se inserta **sin escapar**: el `` del evento llega como HTML. Si muestra datos capturados por usuarios, escápelos (por ejemplo con `html.encode` de [text.dkh](/es/devkron/2.0/bibliotecas/estandar/text.md)). - Los atributos `uielement` (`row`, `cell`, `row_summary`...) los pone siempre la biblioteca; sirven para darles estilo con CSS. - El formato numérico usa la cultura de presentación del servidor (`1,200.00` en `es-MX`). ## Eventos Las funciones de `before_row` y `after_row` reciben `¶ms, &row`; las de `before_cell` y `after_cell`, `¶ms, &row, &cell`. Miembros de `row` que pone la biblioteca (además de las columnas de la fila): | Miembro | Contenido | |---|---| | `_row_type` | `header`, `header_group`, `detail`, `summary_group` o `summary` | | `_row_index` | Posición de la fila de datos (desde 0) | | `_row_attributes` | Atributos de la fila (puede cambiarlos en `before_row`) | | `_row_element` | Elemento de la fila; predeterminado `tr` | | `_abort` | Póngalo en `@true` en `before_row` para no pintar la fila | Miembros de `cell`: | Miembro | Contenido | |---|---| | `text` | Texto (o HTML) de la celda; cámbielo en `before_cell` | | `field` | Campo de la consulta | | `column` | Columna | | `cell_type` | `header`, `header_group`, `data`, `summary_group`, `summary` (o `unknow` si la columna no existe en la fila) | | `element` | `th` en encabezados, `td` en las demás; puede cambiarlo | | `attributes` | Atributos de la celda; si no los pone, se usan los de la columna | | `_abort` | `@true` en `before_cell` para no pintar la celda | Ejemplo de `before_row`: no pintar las filas de un vendedor (con `value_field`, cada fila lleva su clave en `data`): ```dkl filtrar::¶ms, &row { if @@(row,"_row_type") == "detail" && @@(row,"vendedor") == "Pedro" { row<"_abort">: @true } } ``` ```html
sys_pkvendedorimporte
3Marta450.00
4Marta1550.00
``` (Esta tabla no define `columns`: muestra todas las de la consulta con su nombre como título.) `_abort` evita pintar la fila, pero la fila **sí cuenta** en los totales (se calculan al recorrer, antes del evento). ## En una vista de CRUD-L ```dkl ## #! new t { @"source": "select folio, fecha, total from factura where icliente=@sys_pk and ifnull(sys_deleted,0)=0 order by fecha desc;" } t<"db*">: @@(@crud_context,"&database") t<"parameters*">: @@(@crud_context,"&output") do uie.dbTable(t) #$ ## ``` La conexión de la petición está en `database` y la entidad leída sirve como parámetros de la consulta. La vista debe incluir `dbr.dkh`, `uielements.dkl` y `uielements.dbtable.dkl` (en el bloque `##` del inicio, junto a `functions.dkh`). Comprobado en el formulario de un cliente: la tabla de sus facturas salió con las columnas `folio`, `fecha` y `total`; como no se dio `format`, la fecha sale con el formato de la cultura invariante (`10/27/2026 00:00:00`): ponga `@"format":"dd/MM/yyyy"` en la columna.