# 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
| Vendedor | Fecha | Importe |
| Centro |
| Ana | 01/10/2026 | 1,200.00 |
| Luis | 02/10/2026 | 800.50 |
| 2 | | 2,000.50 |
| Norte |
| Marta | 01/10/2026 | 450.00 |
| Marta | 03/10/2026 | 1,550.00 |
| Pedro | 04/10/2026 | 300.00 |
| 3 | | 2,300.00 |
| 5 | | 4,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_pk | vendedor | importe |
|---|
| 3 | Marta | 450.00 |
| 4 | Marta | 1550.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.