@jvsoft/components 1.0.0-alpha.16 → 1.0.0-alpha.18
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.storybook/tema-demo.css +194 -0
- package/dialog-flotante/README.md +21 -1
- package/fesm2022/jvsoft-components-dialog-flotante.mjs +18 -12
- package/fesm2022/jvsoft-components-dialog-flotante.mjs.map +1 -1
- package/fesm2022/jvsoft-components-filtro-busqueda.mjs +11 -2
- package/fesm2022/jvsoft-components-filtro-busqueda.mjs.map +1 -1
- package/fesm2022/jvsoft-components-lista-arbol.mjs +58 -17
- package/fesm2022/jvsoft-components-lista-arbol.mjs.map +1 -1
- package/fesm2022/jvsoft-components-lista-detalle.mjs +70 -0
- package/fesm2022/jvsoft-components-lista-detalle.mjs.map +1 -0
- package/fesm2022/jvsoft-components-luces-navidad.mjs +2 -2
- package/fesm2022/jvsoft-components-luces-navidad.mjs.map +1 -1
- package/fesm2022/jvsoft-components-menu.mjs +4 -1
- package/fesm2022/jvsoft-components-menu.mjs.map +1 -1
- package/fesm2022/jvsoft-components-tabla-mantenimiento-components-progress-bar.mjs +2 -5
- package/fesm2022/jvsoft-components-tabla-mantenimiento-components-progress-bar.mjs.map +1 -1
- package/fesm2022/jvsoft-components-tabla-mantenimiento.mjs +2605 -394
- package/fesm2022/jvsoft-components-tabla-mantenimiento.mjs.map +1 -1
- package/fesm2022/jvsoft-components.mjs +1 -0
- package/fesm2022/jvsoft-components.mjs.map +1 -1
- package/lista-arbol/README.md +17 -1
- package/lista-detalle/README.md +85 -0
- package/package.json +6 -2
- package/src/styles/base-jvsoft-components.css +714 -15
- package/tabla-mantenimiento/README.md +628 -0
- package/tabla-mantenimiento/tabla-mantenimiento.component.scss +31 -0
- package/types/jvsoft-components-dialog-flotante.d.ts +2 -0
- package/types/jvsoft-components-filtro-busqueda.d.ts +6 -0
- package/types/jvsoft-components-lista-arbol.d.ts +19 -2
- package/types/jvsoft-components-lista-detalle.d.ts +44 -0
- package/types/jvsoft-components-menu.d.ts +1 -0
- package/types/jvsoft-components-tabla-mantenimiento-components-progress-bar.d.ts +1 -2
- package/types/jvsoft-components-tabla-mantenimiento.d.ts +1070 -21
- package/types/jvsoft-components.d.ts +1 -0
|
@@ -0,0 +1,628 @@
|
|
|
1
|
+
# tabla-mantenimiento
|
|
2
|
+
|
|
3
|
+
`@jvsoft/components/tabla-mantenimiento` es la tabla de mantenimiento genérica: una envoltura
|
|
4
|
+
sobre `MatTable` que resuelve de una vez lo que toda pantalla de listado necesita —columnas por
|
|
5
|
+
tipo, botones con permisos, selección, búsqueda, paginación y exportación—, de modo que el
|
|
6
|
+
componente que la usa solo declare qué datos trae y qué hacer con ellos.
|
|
7
|
+
|
|
8
|
+
## Lo mínimo
|
|
9
|
+
|
|
10
|
+
```typescript
|
|
11
|
+
import { ColumnaTabla, TablaMantenimientoComponent } from '@jvsoft/components/tabla-mantenimiento';
|
|
12
|
+
|
|
13
|
+
@Component({ imports: [TablaMantenimientoComponent] })
|
|
14
|
+
export class PersonasComponent {
|
|
15
|
+
seleccionados: Record<string, any> = {};
|
|
16
|
+
datos$ = new BehaviorSubject<Persona[]>([]);
|
|
17
|
+
|
|
18
|
+
columnas: ColumnaTabla<Persona>[] = [
|
|
19
|
+
{ label: '#', property: 'numeracion_automatica', type: 'numeracion_automatica' },
|
|
20
|
+
{ label: 'Nombre', property: 'cPersNombre', type: 'text' },
|
|
21
|
+
{ label: 'Ingreso', property: 'dFechaIngreso', type: 'date' },
|
|
22
|
+
{ label: 'Sueldo', property: 'nSueldo', type: 'money' },
|
|
23
|
+
];
|
|
24
|
+
}
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
```html
|
|
28
|
+
<jvs-tabla-mantenimiento
|
|
29
|
+
[objThis]="this"
|
|
30
|
+
nombreColeccion="personas"
|
|
31
|
+
[idTabla]="['iPersId']"
|
|
32
|
+
[columnasTabla]="columnas"
|
|
33
|
+
[dataSuscription]="datos$"
|
|
34
|
+
[(selectionModel)]="seleccionados.personas"
|
|
35
|
+
(opcionSelecionada)="alElegirOpcion($event)"
|
|
36
|
+
/>
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
`objThis` es el componente padre: la tabla lo necesita para resolver funciones en su contexto.
|
|
40
|
+
`nombreColeccion` identifica la tabla dentro de esa pantalla y es la clave con la que se guarda
|
|
41
|
+
la selección. `idTabla` dice qué campos identifican una fila; **conviene pasarlo siempre**: sin
|
|
42
|
+
él la fila se identifica por su contenido, lo que es más frágil y más caro.
|
|
43
|
+
|
|
44
|
+
## Datos y paginación
|
|
45
|
+
|
|
46
|
+
Los datos entran por `dataSuscription`, un `Observable`. La tabla pagina de dos maneras y elige
|
|
47
|
+
sola según lo que llegue:
|
|
48
|
+
|
|
49
|
+
- **En el cliente**: si los registros no traen `iTotalRegistros`, la tabla ordena, filtra y
|
|
50
|
+
pagina en memoria.
|
|
51
|
+
- **En el servidor**: si el primer registro trae `iTotalRegistros`, la tabla deja de paginar y
|
|
52
|
+
emite por `resultados` lo que el backend necesita —`iPaginacion`, `iPageSize`, `iPageNumber`,
|
|
53
|
+
`bDireccionOrden` y, en modo `query`, `cCampoBusqueda`—. El padre recarga con esos parámetros.
|
|
54
|
+
|
|
55
|
+
El ordenamiento usa el tipo de la columna (`sortType ?? type`) para comparar fechas y números
|
|
56
|
+
como tales, no como texto.
|
|
57
|
+
|
|
58
|
+
## Columnas
|
|
59
|
+
|
|
60
|
+
`ColumnaTabla<T>` es una unión discriminada por `type`:
|
|
61
|
+
|
|
62
|
+
| `type` | Para qué |
|
|
63
|
+
|---|---|
|
|
64
|
+
| `text` | Texto, con `transformar()`, piezas declarativas (`celda`, ver abajo) o HTML (`innerHTML`) |
|
|
65
|
+
| `number`, `money` | Números y montos, con `zeroFill` y `simboloMoneda` |
|
|
66
|
+
| `date` | Fechas con formato local |
|
|
67
|
+
| `checkbox` | Selección múltiple (ver abajo) |
|
|
68
|
+
| `icons` | Iconos según el valor, con `iconsDef` |
|
|
69
|
+
| `progress` | Barra de progreso |
|
|
70
|
+
| `yes_no`, `estado` | Sí/no y estados |
|
|
71
|
+
| `image` | En desuso: no se pinta (la celda sale vacía). Usa `text` con `celda` e `imagen()` |
|
|
72
|
+
| `expandir` | Botón que despliega la fila extra |
|
|
73
|
+
| `numeracion_automatica` | Numeración continua, respetando la página |
|
|
74
|
+
| `arbol` | Sangría y plegar/desplegar del modo árbol + el texto o `celda` (ver **Árbol**) |
|
|
75
|
+
| `custom` | Lo pinta el consumidor con su propia plantilla |
|
|
76
|
+
| `estiloEstablecido` | Celda con estilo calculado |
|
|
77
|
+
|
|
78
|
+
Propiedades útiles en cualquier columna: `labelLista` (nombre alterno al exportar), `labelTooltip`
|
|
79
|
+
(tooltip de la cabecera, p. ej. qué significa una columna de marcas), `visible` y
|
|
80
|
+
`esVisible()` (que pueden ser funciones), `noMostrarEnLista` para ocultarla del menú de columnas,
|
|
81
|
+
`sort: false`, `cssClasses`, `transformar(row)` y `transformarFooter()`. (Las columnas fijas
|
|
82
|
+
`sticky`/`stickyEnd` no existen todavía: están comentadas en la interfaz.)
|
|
83
|
+
|
|
84
|
+
### Celdas declarativas (`celda`)
|
|
85
|
+
|
|
86
|
+
Para una celda con más que texto (nota gris, badge de estado, marcas o íconos con tooltip, avatar)
|
|
87
|
+
no hace falta una `custom` con su `matColumnDef`: en una columna `text` (o `arbol`) se declara
|
|
88
|
+
`celda: (row) => piezas` y la tabla las pinta con sus tamaños y tonos (`<jvs-tabla-celda>`), igual en
|
|
89
|
+
todas las pantallas. Los ayudantes se importan de `@jvsoft/components/tabla-mantenimiento`:
|
|
90
|
+
|
|
91
|
+
| Ayudante | Qué pinta |
|
|
92
|
+
|---|---|
|
|
93
|
+
| `'texto'` o `texto(t, {negrita, tono})` | Texto principal |
|
|
94
|
+
| `nota(t, {bloque})` | Texto gris; después de otra pieza va con "·" ("ACTA · AC"). Sin texto devuelve `false` |
|
|
95
|
+
| `badge(t, {tono, tooltip, icono})` | Badge de 12 px ("Inactivo", "Oculto"); neutro si no se dice el tono. Con `icono`, uno de 10 px delante del texto |
|
|
96
|
+
| `marca(t, tooltip, {tono})` / `marcaIcono(icono, tooltip, {tono})` | Marca de 12 × 12 px con su significado en el tooltip; primaria si no se dice el tono |
|
|
97
|
+
| `icono(nombre, {tono, tooltip, ariaLabel, tamano, click})` | Ícono de 12 px (`tamano: 'grande'`, 14 px); con `click` es un botón que no selecciona la fila |
|
|
98
|
+
| `imagen(src, alt, {redonda})` | Avatar de 20 px |
|
|
99
|
+
| `salto` | Lo que sigue va en la línea de abajo |
|
|
100
|
+
|
|
101
|
+
**Tonos.** Todas las piezas con tono (`texto`, `badge`, `icono`, `marca`, `marcaIcono`) lo reciben igual,
|
|
102
|
+
en las opciones, y tienen además un atajo por tono: `badge.error('Inactivo', {tooltip})` es
|
|
103
|
+
`badge('Inactivo', {tono: 'error', tooltip})`. Al escribir `badge.` el editor lista los tonos con su
|
|
104
|
+
significado. El atajo es para el tono fijo; cuando el tono sale de un dato, la forma con `{tono}`.
|
|
105
|
+
|
|
106
|
+
| Tono | Para qué | Ejemplo |
|
|
107
|
+
|---|---|---|
|
|
108
|
+
| `neutro` | Clasificación sin juicio | `badge('Otros módulos')`, `badge.neutro('Múlt.')` |
|
|
109
|
+
| `exito` | Estado correcto o completo | `texto.exito('Activo')` |
|
|
110
|
+
| `aviso` | Requiere atención, no bloquea | `icono.aviso('roundWarning', {tooltip: 'Sigla repetida'})`, `texto.aviso('Sin firmante')` |
|
|
111
|
+
| `error` | Estado negativo o bloqueante | `badge.error('Inactivo')`, `badge.error('Sin padre')` |
|
|
112
|
+
| `info` | Dato informativo destacado | `badge.info('Planilla')` |
|
|
113
|
+
| `primario` | Marca de la entidad o categoría principal | `marca('E', 'Entrada')`, `icono.primario('roundFolder')` |
|
|
114
|
+
|
|
115
|
+
La lista está exportada (`TONOS`, con el uso de cada uno) y la historia `CeldasDeclarativas` de Storybook
|
|
116
|
+
la muestra en claro y en oscuro. Los colores son del Tailwind de la casa (`gray`, `green`, `amber`, `red`,
|
|
117
|
+
`cyan` y `primary`): fondo `-light` y texto en el tono oscuro de la misma familia (`text-red-700`…), porque
|
|
118
|
+
el `DEFAULT` sobre su `-light` no llega al contraste mínimo en texto pequeño; con el tema oscuro de Vex
|
|
119
|
+
(`.vex-style-dark`) el texto pasa al tono claro. `primario` depende del color de la entidad: el texto es
|
|
120
|
+
ese color oscurecido (aclarado en el tema oscuro), para que se lea aunque la entidad tenga un primario
|
|
121
|
+
claro. Un ícono con tono va del mismo color que el texto del tono.
|
|
122
|
+
|
|
123
|
+
Para pintar algo con el mismo tono fuera de la tabla (la ficha de un panel, una leyenda), importa las
|
|
124
|
+
clases en vez de copiarlas: `claseTono('exito')` (fondo y texto) o `CLASES_TONO.exito.texto`. Son clases
|
|
125
|
+
completas, así que el Tailwind de cada app las encuentra en `node_modules/@jvsoft/**` sin configurar nada.
|
|
126
|
+
|
|
127
|
+
Para una ficha o un contador fuera de la tabla con la forma de un badge, `claseBadge(tono, 'ficha')`
|
|
128
|
+
(18 px, el de los paneles) o `claseBadge(tono)` (12 px, el de la fila) da forma y tono juntos:
|
|
129
|
+
`fichaExito: claseBadge('exito', 'ficha')`. No hace falta copiar `inline-flex h-[18px]…` en la pantalla.
|
|
130
|
+
|
|
131
|
+
**`clase`**: todas las piezas aceptan `clase` con clases Tailwind adicionales, que van al final
|
|
132
|
+
(`badge.neutro(r.cSigla, {clase: 'uppercase tracking-wide'})`). Es un escape para lo que no es color:
|
|
133
|
+
un color en `clase` **no gana** al del tono, porque en CSS manda el orden de la hoja (Tailwind la ordena
|
|
134
|
+
a su modo) y no el del atributo; `bg-blue-100` pierde contra el `bg-gray-light` del neutro.
|
|
135
|
+
|
|
136
|
+
**Colores propios: `tono: false`.** La pieza conserva su forma y medidas pero la librería no pone ningún
|
|
137
|
+
color (ni fondo ni texto); la pantalla los pone en `clase`. Vale en `badge`, `marca`, `marcaIcono`,
|
|
138
|
+
`icono` y `texto`:
|
|
139
|
+
|
|
140
|
+
```ts
|
|
141
|
+
badge('Externo', {tono: false, clase: 'bg-purple-light text-purple-800 [.vex-style-dark_&]:text-purple-300'})
|
|
142
|
+
marca('C', 'Caja', {tono: false, clase: 'bg-excel-light text-excel-900'})
|
|
143
|
+
icono('roundToggleOn', {tamano: 'grande', tono: false, clase: 'text-green-600', tooltip: 'Habilitado'})
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
Con `tono: false` el contraste y el tema oscuro quedan a cargo de la pantalla. La regla que cumplen los
|
|
147
|
+
tonos: fondo `X-light` del Tailwind de la casa (`gray`, `red`, `orange`, `deep-orange`, `amber`, `green`,
|
|
148
|
+
`teal`, `cyan`, `purple`, `deep-purple`, `pink`, `pdf`, `excel`) y texto en el 700/800 de la misma familia,
|
|
149
|
+
con `[.vex-style-dark_&]:text-X-300` para el oscuro. Las clases van completas en el `.ts` de la pantalla
|
|
150
|
+
(sin concatenar), para que el Tailwind del MF las encuentre. Si varias pantallas repiten el mismo color
|
|
151
|
+
propio, conviene pedirlo como tono a la librería.
|
|
152
|
+
|
|
153
|
+
**Íconos.** El nombre lo da la pieza (`icono('roundStar')`, `marcaIcono(…)`, `badge(t, {icono})`); el
|
|
154
|
+
color, el tono (o `tono: false` + `clase`); el tamaño es fijo: 12 px en `icono`, 10 px dentro de badge y
|
|
155
|
+
marca, y 14 px con `icono(n, {tamano: 'grande'})`: lo más grande que cabe en la fila densa (15 px) sin
|
|
156
|
+
hacerla más alta; uno de 16 px, como los de las columnas `estado`, la haría crecer.
|
|
157
|
+
En el badge el ícono va siempre delante del texto y es decorativo: lo que dice el badge está en su texto.
|
|
158
|
+
Un badge con ícono y sin texto no existe: para eso está `marcaIcono`.
|
|
159
|
+
|
|
160
|
+
Los `false`, `null` y `undefined` se ignoran, así que las condiciones van en línea; ojo con los números:
|
|
161
|
+
`row.iActivo && badge(…)` pinta "0" cuando vale 0 (usa `!!row.iActivo && …`).
|
|
162
|
+
|
|
163
|
+
```ts
|
|
164
|
+
{label: 'Nombre', property: 'cTipoDocNombre', type: 'text',
|
|
165
|
+
celda: r => [r.cTipoDocNombre, nota(r.cTipoDocSigla), !esActivo(r) && badge.error('Inactivo')]},
|
|
166
|
+
{label: 'Estado', property: 'iCredEstado', type: 'text',
|
|
167
|
+
celda: r => r.iCredEstado == 1 ? texto.exito('Activo') : badge.error('Inactivo')},
|
|
168
|
+
{label: 'Despacho', property: 'colDespacho', type: 'arbol', lineas: 2, ordenarPor: r => r.cNombre,
|
|
169
|
+
celda: r => [icono.primario('roundFolder', {tooltip: r.cTipo}), r.cNombre, nota(r.cSigla)]},
|
|
170
|
+
// Tono desde un dato: la forma con {tono}.
|
|
171
|
+
const TONO_ESTADO: Record<number, TonoCelda> = {1: 'exito', 2: 'aviso', 3: 'error'};
|
|
172
|
+
{label: 'Estado', property: 'iEstadoId', type: 'text',
|
|
173
|
+
celda: r => badge(r.cEstadoNombre, {tono: TONO_ESTADO[r.iEstadoId] ?? 'neutro'})},
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
- **Tooltips**: de Material, con un retardo de 400 ms (`RETARDO_TOOLTIP_CELDA`, también en el recorte de
|
|
177
|
+
`lineas`) para que no se abran y cierren al pasar el cursor por la fila; su texto (o `ariaLabel`) se
|
|
178
|
+
repite oculto para los lectores de pantalla. No se enfocan con el teclado: lo que diga un tooltip
|
|
179
|
+
debe poder deducirse también de otra columna o del Excel.
|
|
180
|
+
- **`lineas: n`**: recorta a n líneas y pone el texto completo de la celda en el tooltip.
|
|
181
|
+
- **Excel**: sin `excel.valor`, la columna exporta el texto de sus piezas (`textoCelda`): textos,
|
|
182
|
+
notas, badges y marcas con texto; íconos e imágenes no. Una pieza con `soloPantalla: true` no
|
|
183
|
+
sale. `excel.valor` sigue mandando.
|
|
184
|
+
- **Orden**: por `property` u `ordenarPor`, como cualquier `text` (ordenan por defecto; `sort: false`
|
|
185
|
+
para no ofrecerlo). **Búsqueda simple**: busca en el registro, no en las piezas.
|
|
186
|
+
- **Columnas que no caben**: la medición cuenta el relleno de badges y marcas, sus íconos y las imágenes.
|
|
187
|
+
- `celda` se evalúa en cada ciclo, como `transformar`. En tablas muy grandes, si se nota, memoriza
|
|
188
|
+
por fila en la pantalla (`WeakMap<row, Celda>`).
|
|
189
|
+
- Si una columna trae `celda` e `innerHTML`, se pinta `celda` (con aviso en consola en desarrollo).
|
|
190
|
+
- Dentro de una `custom` (controles, botones) también sirve `<jvs-tabla-celda [piezas]="…" [fila]="row">`.
|
|
191
|
+
|
|
192
|
+
**Badge o texto**
|
|
193
|
+
|
|
194
|
+
1. **Un badge vale por ser pocos.** Si más de la mitad de las filas lo llevarían, no destaca nada y la
|
|
195
|
+
columna se llena de cajas. Para el valor normal, texto (con tono si aporta: `texto.exito('Activo')`) o
|
|
196
|
+
nota gris (`nota('No')`); badge solo para la excepción o lo que pide acción (`badge.error('Inactivo')`,
|
|
197
|
+
`badge.aviso('Vence hoy')`).
|
|
198
|
+
2. **Estados de varios valores con peso parecido** (Pendiente / En proceso / Atendido / Derivado): todos
|
|
199
|
+
badge, cada uno con su tono. La forma igual ayuda a recorrer la columna; el color dice cuál es cuál.
|
|
200
|
+
3. **Binario con un valor normal** (activo/inactivo, vigente/vencido, firmado/sin firmar): el normal como
|
|
201
|
+
texto, la excepción como badge. Si el normal no necesita decirse, también vale la celda vacía o la nota.
|
|
202
|
+
Ejemplo: Despachos, Estado (313 activos de 318), `texto.exito('Activo')` / `badge.error('Inactivo')`.
|
|
203
|
+
4. **Banderas sí/no**: `yes_no` o `marca`, no badges.
|
|
204
|
+
5. **Una pieza fuerte por celda.** Si el nombre ya lleva un badge ("Inactivo"), lo demás va en nota o marca.
|
|
205
|
+
6. **El badge no reemplaza al texto**: su texto sale en el Excel y lo lee el lector de pantalla; el color
|
|
206
|
+
solo refuerza.
|
|
207
|
+
|
|
208
|
+
Es el criterio de GOV.UK Design System (*Task list*: lo completado como texto, solo lo pendiente con
|
|
209
|
+
*tag*), Shopify Polaris (*Badge*: usar con moderación) y Atlassian (*Lozenge*). Aquí "badge" es la pieza
|
|
210
|
+
de la celda; el número sobre un botón es su **contador** (ver **Botones**). El badge de estado de los MF
|
|
211
|
+
(`span-dialog-flotante-X-light`, plugin de cada `tailwind.config.js`) es otra cosa y no se toca: en
|
|
212
|
+
pantallas nuevas, `badge()` en la tabla y `claseBadge()` fuera.
|
|
213
|
+
|
|
214
|
+
**Cuál usar**
|
|
215
|
+
|
|
216
|
+
- Solo texto o una concatenación: `text` con `property` o `transformar`. Nunca `innerHTML` para esto.
|
|
217
|
+
- Texto con nota, badges, marcas, íconos con tooltip o avatar: `text` (o `arbol`) con `celda`.
|
|
218
|
+
- Íconos de acción (descargar, abrir): `icons` con `iconsDef`. Sí/No con ícono: `yes_no`.
|
|
219
|
+
- HTML que ya llega armado (notificaciones, reporteadores): `innerHTML`. **Se pinta tal cual, sin
|
|
220
|
+
sanear**: escapa lo que venga de la base con `html` o `escaparHtml` de `@jvsoft/utils`
|
|
221
|
+
(`` innerHTML: r => html`<b>${r.cNombre}</b><br><small>${r.cCargo}</small>` ``; `sinEscapar(x)` para
|
|
222
|
+
un trozo de HTML de confianza).
|
|
223
|
+
- Controles, botones, popovers, pipes propios: `custom` con `excel.valor` y `ordenarPor`.
|
|
224
|
+
|
|
225
|
+
**Columnas que no caben.** Por defecto (`columnasSiNoCaben="ajustar"`) se pintan todas y, si falta
|
|
226
|
+
espacio, el texto se parte en líneas, como siempre. Con `columnasSiNoCaben="ocultar"` la tabla mide el
|
|
227
|
+
ancho que necesita cada columna (título y contenido de las primeras filas de la página, con mínimos y
|
|
228
|
+
topes por tipo que pone la librería) y oculta las de menor prioridad hasta que el resto quepa en su
|
|
229
|
+
contenedor. Lo decide el ancho de la tabla, no el de la ventana, y no se configura ningún px.
|
|
230
|
+
|
|
231
|
+
- La prioridad sale del orden: la primera columna de datos es la principal y nunca se oculta; las
|
|
232
|
+
utilitarias (casilla, expandir, numeración, íconos, sí/no) tampoco; el resto se oculta de derecha a
|
|
233
|
+
izquierda. El corte es acumulativo: en cuanto una no cabe, las de menor prioridad tampoco se pintan.
|
|
234
|
+
- `prioridad: n` cambia ese orden: 1 es la más importante y nunca se oculta, y una columna con
|
|
235
|
+
`prioridad` va antes que todas las que no la tienen.
|
|
236
|
+
- El botón de columnas muestra `+N` y su tooltip las nombra; en el menú salen desmarcadas con
|
|
237
|
+
"(sin espacio)". Si el usuario la marca, se muestra (y se acomodan las demás).
|
|
238
|
+
- Siguen saliendo en el Excel. Una `custom` oculta no está en el HTML de la tabla, así que conviene
|
|
239
|
+
darle `excel.valor`.
|
|
240
|
+
- `visible` (también como función) se evalúa antes: una columna apagada no ocupa espacio.
|
|
241
|
+
- Si se ordena por una columna que luego se oculta, los datos siguen ordenados aunque no se vea la
|
|
242
|
+
flecha.
|
|
243
|
+
- `columnasOcultasPorEspacio()` (señal de solo lectura) dice cuáles están ocultas ahora, por si la
|
|
244
|
+
pantalla quiere avisar.
|
|
245
|
+
|
|
246
|
+
```ts
|
|
247
|
+
// Sin configurar nada: se oculta Estado, luego Teléfono, luego Correo; Nombre nunca.
|
|
248
|
+
// Con `prioridad: 2` en Estado, se conserva antes que Correo y Teléfono.
|
|
249
|
+
columnas: ColumnaTabla<Persona>[] = [
|
|
250
|
+
{label: 'Nombre', property: 'cNombre', type: 'text'},
|
|
251
|
+
{label: 'Correo', property: 'cCorreo', type: 'text'},
|
|
252
|
+
{label: 'Teléfono', property: 'cTelefono', type: 'text'},
|
|
253
|
+
{label: 'Estado', property: 'cEstado', type: 'estado', prioridad: 2},
|
|
254
|
+
];
|
|
255
|
+
```
|
|
256
|
+
|
|
257
|
+
```html
|
|
258
|
+
<jvs-tabla-mantenimiento columnasSiNoCaben="ocultar" [columnasTabla]="columnas" …>
|
|
259
|
+
```
|
|
260
|
+
|
|
261
|
+
**Cabeceras.** Van centradas, como siempre. Si se quiere que sigan la alineación de su celda
|
|
262
|
+
(`text-center`/`text-right` en `cssClasses`, o la del tipo: iconos, casillas y sí/no centrados;
|
|
263
|
+
texto, números y fechas a la izquierda), se activa en la tabla con
|
|
264
|
+
`[alinearCabecerasConContenido]="true"` —y entonces una columna `custom` respeta `text-left` /
|
|
265
|
+
`text-right` en su `th`— o por columna con `alineacionCabecera: 'izquierda' | 'centro' | 'derecha'`.
|
|
266
|
+
|
|
267
|
+
**Columnas `custom` con orden.** Un `mat-sort-header` en el `th` de una columna `custom` usa el
|
|
268
|
+
`MatSort` de la tabla (la tabla lo provee a su contenido). El valor con el que se ordena lo da
|
|
269
|
+
`ordenarPor: (row) => …` en la columna; sin él se usa `row[property]`. En modo árbol se ordena
|
|
270
|
+
entre hermanos. El consumidor importa `MatSortModule`.
|
|
271
|
+
|
|
272
|
+
**Columnas agregadas después.** Una `custom` que se agrega a `columnasTabla` con la tabla ya
|
|
273
|
+
iniciada se muestra en cuanto existe su `matColumnDef` (antes quedaba oculta para siempre).
|
|
274
|
+
|
|
275
|
+
**Sí/no.** Los íconos de `yes_no` miden 12 px para no hacer la fila más alta que las de texto
|
|
276
|
+
(`compacto: false` vuelve a los de 20 px).
|
|
277
|
+
|
|
278
|
+
**Excel por columna.** `excel: { valor(row, i), titulo, ancho, ocultar, incluirOculta }`.
|
|
279
|
+
`valor` es lo que conviene dar en las columnas `custom`, que si no exportan el texto de su
|
|
280
|
+
celda; `incluirOculta` sirve para columnas que solo existen en el Excel (con `visible: false` y
|
|
281
|
+
`noMostrarEnLista: true`).
|
|
282
|
+
|
|
283
|
+
Con `filtroCampos` (activo por defecto) el usuario elige qué columnas ve, y la elección se
|
|
284
|
+
recuerda por columna.
|
|
285
|
+
|
|
286
|
+
## Botones
|
|
287
|
+
|
|
288
|
+
`TablaMantenimientoService` trae un catálogo ya estilado: `nuevo`, `editar`, `eliminar`,
|
|
289
|
+
`eliminar_fila`, `imprimir`, `descargar`, `ver_archivos`, `exportar_pdf`, `exportar_excel`,
|
|
290
|
+
`exportacion_avanzada`, `guardar`, `cancelar`, `seleccionar`, `detalle`, `ver_mapa`, `activar`,
|
|
291
|
+
`desactivar`, `cerrar` y `abrir`. Basta nombrar el `tipo` y se hereda icono y color.
|
|
292
|
+
|
|
293
|
+
```typescript
|
|
294
|
+
botonesMenu: SeccionesBotonesMantenimiento = {
|
|
295
|
+
principal: [
|
|
296
|
+
{ tipo: 'nuevo' },
|
|
297
|
+
{ tipo: 'reportes', icono: 'roundPrint', subItems: [
|
|
298
|
+
{ tipo: 'imprimir', label: 'Listado' },
|
|
299
|
+
{ tipo: 'exportar_pdf' },
|
|
300
|
+
]},
|
|
301
|
+
],
|
|
302
|
+
};
|
|
303
|
+
```
|
|
304
|
+
|
|
305
|
+
Secciones disponibles: `crud`, `principal`, `izquierda`, `derecha`, `secundario`, `inferior`, y
|
|
306
|
+
cualquier clave propia. `botonesCRUD` es una máscara de texto: `'CUD'` muestra crear, actualizar
|
|
307
|
+
y eliminar; `'-'` no muestra ninguno.
|
|
308
|
+
|
|
309
|
+
**Permisos.** Cada botón se deshabilita solo según `derechosActuales[cDerechoCodigo ?? tipo]`,
|
|
310
|
+
que la tabla lee del `data.derechos` de la ruta en cada navegación. `ignorarDerechos` lo salta y
|
|
311
|
+
`ignorarDerecho` por botón, también.
|
|
312
|
+
|
|
313
|
+
**Motivo del deshabilitado.** Un botón deshabilitado muestra al pasar el cursor el
|
|
314
|
+
`tooltipDeshabilitado` del botón (texto o `(item, tablaRef) => string`); sin él, la tabla dice
|
|
315
|
+
"Selecciona un registro" o "No tienes permiso para esta acción" cuando esa es la causa, y si no
|
|
316
|
+
queda el `tooltip` normal. Vale para la barra y para el menú contextual.
|
|
317
|
+
|
|
318
|
+
**Botón elegido.** `activo` (booleano o `(item, tablaRef) => boolean`) marca el elegido de un
|
|
319
|
+
grupo, típicamente los filtros de la fila `secundario`: va relleno con el acento de la tabla, y
|
|
320
|
+
los que declaran `activo` sin estarlo van en tono claro del mismo acento con borde (ver
|
|
321
|
+
**Colores**). Ese aspecto manda sobre la `class` del botón y lleva `aria-pressed`. Sin `activo`,
|
|
322
|
+
nada cambia.
|
|
323
|
+
|
|
324
|
+
**Colores.** Por defecto la tabla usa colores estándar fijos, iguales en todas las pantallas: la
|
|
325
|
+
fila elegida (`--tabla-mantenimiento-seleccion-fondo/texto`) y el acento de los botones `activo`,
|
|
326
|
+
segmentados y su badge (`--tabla-mantenimiento-acento`, tripleta "r, g, b", el mismo azul). Para
|
|
327
|
+
usar el color del tema de la entidad (`--color-primary` y `--color-primary-contrast`):
|
|
328
|
+
|
|
329
|
+
```typescript
|
|
330
|
+
// app.config.ts: todas las tablas de la app
|
|
331
|
+
provideTablaMantenimiento({coloresTema: true})
|
|
332
|
+
```
|
|
333
|
+
|
|
334
|
+
o por tabla `[coloresTema]="true"`, que manda sobre el global (también `false` para forzar el
|
|
335
|
+
estándar). Con la opción, el host lleva la clase `jvs-colores-tema`, que solo reasigna esas
|
|
336
|
+
variables.
|
|
337
|
+
|
|
338
|
+
**Configuración global.** `provideTablaMantenimiento` también fija, para toda la app, dos
|
|
339
|
+
comportamientos que vienen activos por defecto: `exportacionArriba` (las exportaciones suben junto a
|
|
340
|
+
Recargar) y `seguirSeleccion` (la tabla lleva a la vista la fila elegida desde fuera). Un MF que
|
|
341
|
+
prefiera el comportamiento anterior en todas sus tablas:
|
|
342
|
+
|
|
343
|
+
```typescript
|
|
344
|
+
provideTablaMantenimiento({exportacionArriba: false, seguirSeleccion: false})
|
|
345
|
+
```
|
|
346
|
+
|
|
347
|
+
El input de cada tabla manda sobre el global (`[seguirSeleccion]="true"` lo activa en una tabla
|
|
348
|
+
aunque el global lo apague).
|
|
349
|
+
|
|
350
|
+
**Contador.** `badge` en un botón es su contador (el número sobre el botón; dentro, como texto, en
|
|
351
|
+
el control segmentado). Material lo oculta a los lectores de pantalla, así que la tabla le pone una
|
|
352
|
+
descripción: "3 registros" ("1 registro"), o lo que diga `badgeDescripcion` ("3 pendientes" con
|
|
353
|
+
`badgeDescripcion: 'pendientes'`). No se ve.
|
|
354
|
+
|
|
355
|
+
**Control segmentado.** `grupo` en un botón: los consecutivos de una misma sección con el
|
|
356
|
+
mismo `grupo` se dibujan juntos, como un `mat-button-toggle-group` (borde común, divisores
|
|
357
|
+
finos, el `activo` relleno y los demás en tono claro, el `badge` como texto dentro del botón).
|
|
358
|
+
Tooltip, `tooltipDeshabilitado`, `estaDeshabilitado`, derechos, `esIndependiente`, `esVisible` y
|
|
359
|
+
el evento funcionan igual que en un botón suelto; del grupo quedan los visibles. En los menús ≡ y
|
|
360
|
+
contextual se listan como ítems normales. Sin `grupo`, nada cambia.
|
|
361
|
+
|
|
362
|
+
**Filtros dinámicos.** `generarBotonesDinamicos(data, config)` arma un botón por registro:
|
|
363
|
+
`tipo`, `labelField`, `tooltipField`, `badgeField`, `extraDataField`, `class` (opcional), el
|
|
364
|
+
elegido con `campoValor` + `valorActivo` (valor o función; van juntos, y con uno solo la función
|
|
365
|
+
avisa por consola y no marca ninguno), y
|
|
366
|
+
`includeAll: {label, posicion: 'inicio' | 'fin', badge (valor o true = suma), valor}` y
|
|
367
|
+
`estilo: 'chips' | 'segmentado'` (por defecto `'chips'`, separados con `ml-1`; `'segmentado'`
|
|
368
|
+
pone a todos, "Todos" incluido, en un mismo `grupo`) y `ocultarCero` (sin contador cuando vale 0,
|
|
369
|
+
también en "Todos"; por defecto el "0" se ve). No pone colores: el aspecto lo da la tabla.
|
|
370
|
+
|
|
371
|
+
Para un elegido que no sea "un campo igual a un valor" (varios campos, varios elegidos…), aplica
|
|
372
|
+
`.map()` a lo que devuelve y pon `activo` a cada botón:
|
|
373
|
+
|
|
374
|
+
```ts
|
|
375
|
+
const botones = generarBotonesDinamicos(estados, {tipo: 'estado', labelField: 'cNombre'})
|
|
376
|
+
.map(btn => ({...btn, activo: () => this.elegidos().includes(btn.datosExtra.item?.iEstadoId)}));
|
|
377
|
+
```
|
|
378
|
+
|
|
379
|
+
**Herramientas.** La sección `herramientas` se dibuja junto a Recargar con botones de solo ícono
|
|
380
|
+
y tooltip; con más de tres se agrupan en un menú "Exportar ▾". Las exportaciones conocidas
|
|
381
|
+
(`exportar_pdf`, `ver_pdf`, `exportar_excel`, `descargar_excel`, `ver_resumen_pdf`,
|
|
382
|
+
`ver_resumen_excel`, `exportar_jasper`, `exportacion_avanzada`) se mudan ahí aunque vengan en
|
|
383
|
+
`inferior`, igual que el Excel automático; `[exportacionArriba]="false"` las deja donde estaban (en toda la app: `provideTablaMantenimiento({exportacionArriba: false})`, ver **Configuración global**).
|
|
384
|
+
PDF y Excel usan íconos propios de la tabla (Material Round `picture-as-pdf` y MDI `file-excel-outline`), en
|
|
385
|
+
línea, sin depender del CDN, y sin color propio: se ven como Recargar y Columnas.
|
|
386
|
+
|
|
387
|
+
**Menú de columnas.** Una casilla por línea. Lo que el usuario marca o desmarca se guarda aparte
|
|
388
|
+
de la definición, así una columna con `visible` como función sigue su condición hasta que el
|
|
389
|
+
usuario la toque.
|
|
390
|
+
|
|
391
|
+
**Tablas angostas.** Cuando la banda de la tabla es angosta (menos de 36 rem, 576 px; lo mide la
|
|
392
|
+
tabla, no la ventana, así un panel angosto en una pantalla ancha también cuenta), los grupos de la
|
|
393
|
+
barra pasan al menú ≡, pero la fila `secundario` y lo proyectado en `objetosMenuPegado` siguen a la
|
|
394
|
+
vista (con salto de línea). Los botones de `secundario` no se repiten dentro del menú ≡. El pie
|
|
395
|
+
(botones inferiores y paginador) se apila con el mismo criterio. El host lleva la clase
|
|
396
|
+
`jvs-banda-angosta` (o `jvs-banda-media`, hasta 48 rem) por si la pantalla necesita acomodar algo.
|
|
397
|
+
|
|
398
|
+
**Solo lectura.** Con `readOnly` solo quedan los botones marcados con `ignorarReadOnly`, y no se
|
|
399
|
+
puede eliminar con `Supr` ni disparar la acción del doble clic. `readOnly="permitirSeleccion"`
|
|
400
|
+
deja elegir la fila sin ejecutar nada.
|
|
401
|
+
|
|
402
|
+
## Tooltips
|
|
403
|
+
|
|
404
|
+
Todos son de Material (`matTooltip`). Qué muestra cada parte de la tabla y cómo se configura:
|
|
405
|
+
|
|
406
|
+
| Dónde | Cómo |
|
|
407
|
+
|---|---|
|
|
408
|
+
| Botones de la barra y del menú ≡ | `tooltip` del botón; sin él, su etiqueta. Inmediatos (sin retardo) |
|
|
409
|
+
| Botón deshabilitado | `tooltipDeshabilitado` (texto o función); sin él, "Selecciona un registro" o "No tienes permiso para esta acción" (ver **Motivo del deshabilitado**) |
|
|
410
|
+
| Menú contextual | Solo el motivo del deshabilitado |
|
|
411
|
+
| Herramientas (solo ícono) | El nombre de la herramienta, también como `aria-label` |
|
|
412
|
+
| Fila | `rowTooltip(item)` y, si está anulada, el mensaje de anulado, unidos con " \| ". Va en rojo con "⚠️": úsalo para avisos de la fila |
|
|
413
|
+
| Cabecera | `labelTooltip` de la columna |
|
|
414
|
+
| Columna `icons` | `tooltip` o `tooltipField` (campo del registro) por ícono. `toolTip` / `toolTipField` siguen funcionando, en retirada |
|
|
415
|
+
| Columna `yes_no` | `yesTooltip` / `noTooltip` |
|
|
416
|
+
| `popover` de una columna | `{content \| template, trigger: 'hover' \| 'click' \| 'focus', position, customClass}` |
|
|
417
|
+
| Piezas de `celda` | `tooltip` (y `ariaLabel`) en badge, marca e ícono; `lineas` pone el texto completo. Retardo de 400 ms (`RETARDO_TOOLTIP_CELDA`) |
|
|
418
|
+
|
|
419
|
+
- La columna `estado` se pinta como un ícono verde o gris de 16 px **sin tooltip ni texto**. Para que se
|
|
420
|
+
entienda (y lo lea un lector de pantalla), en pantallas nuevas usa `celda` (`texto.exito('Activo')` /
|
|
421
|
+
`badge.error('Inactivo')`, criterio de **Badge o texto**) o `yes_no` con `yesTooltip`/`noTooltip`.
|
|
422
|
+
- Si la fila tiene `rowTooltip` y una pieza de la celda también tiene tooltip, se pueden ver los dos a la vez.
|
|
423
|
+
- La tabla no configura `MAT_TOOLTIP_DEFAULT_OPTIONS`: los retardos del resto de la app son los de cada MF.
|
|
424
|
+
|
|
425
|
+
## Selección
|
|
426
|
+
|
|
427
|
+
**De una fila**: clic para elegir, clic otra vez sobre la misma para soltarla, flechas para
|
|
428
|
+
moverse, Enter para abrir. La selección sobrevive a las recargas: la tabla vuelve a
|
|
429
|
+
encontrar el registro por `idTabla` y entrega el objeto nuevo, no el anterior.
|
|
430
|
+
|
|
431
|
+
La forma recomendada de leerla es el enlace de dos sentidos:
|
|
432
|
+
|
|
433
|
+
```html
|
|
434
|
+
[(selectionModel)]="seleccionados.personas"
|
|
435
|
+
```
|
|
436
|
+
|
|
437
|
+
**Ir a la fila seleccionada (`seguirSeleccion`, activo por defecto).** Cuando la selección cambia
|
|
438
|
+
desde fuera —la pantalla fija `[selectionModel]` con el registro recién guardado, o llama a
|
|
439
|
+
`seleccionarPorId()`— la tabla lleva esa fila a la vista: con paginación en cliente va a la página
|
|
440
|
+
que la contiene (respetando el orden y el filtro activos), limpia el buscador simple si la ocultaba,
|
|
441
|
+
la desplaza a la vista si hace falta y la resalta un instante (`animate-pulse`). No se mueve por un
|
|
442
|
+
clic ni por el teclado (la fila ya se ve), ni en una recarga que mantiene la misma fila: así una
|
|
443
|
+
tabla que se refresca sola no salta de página mientras se lee. Con paginación en el servidor no hay
|
|
444
|
+
página que calcular: solo desplaza si la fila vino en la página cargada; traer la página correcta
|
|
445
|
+
sigue siendo de la pantalla. `[seguirSeleccion]="false"` lo apaga en una tabla; `provideTablaMantenimiento({seguirSeleccion: false})`, en toda la app (ver **Configuración global**).
|
|
446
|
+
|
|
447
|
+
Después de guardar, lo que queda en la pantalla es saber qué registro elegir (el id que devuelve el
|
|
448
|
+
procedimiento) y sus filtros propios:
|
|
449
|
+
|
|
450
|
+
```ts
|
|
451
|
+
// Registro nuevo: el id cambia y la tabla lo sigue sola.
|
|
452
|
+
this.seleccionado.set(lista.find(r => r.iTipoDocId === idGuardado) ?? null);
|
|
453
|
+
// o, sin buscar el registro (si la recarga aún no llegó, se aplica y avisa cuando llegue):
|
|
454
|
+
this.tabla().seleccionarPorId(idGuardado);
|
|
455
|
+
// Registro editado: la selección no cambia, y si el campo editado lo movió de página hay que pedirlo.
|
|
456
|
+
this.tabla().irASeleccion();
|
|
457
|
+
```
|
|
458
|
+
|
|
459
|
+
Si la fila fijada no está en los datos (la recarga viene en camino), la selección queda fijada y
|
|
460
|
+
se aplica —avisando por `selectionModelChange`— cuando llega.
|
|
461
|
+
|
|
462
|
+
**De varias filas**: basta una columna `type: 'checkbox'`. La clave de cada casilla sale de
|
|
463
|
+
`chkField` (o del `property` de la columna), y con `chkFieldSeparador` se pueden combinar varios
|
|
464
|
+
campos. Con `chkFieldPersistente` lo marcado sobrevive al cambio de página. El evento
|
|
465
|
+
`opcionSelecionada` lleva entonces `idsSeleccionados` (texto separado por comas) e
|
|
466
|
+
`itemsSeleccionados` (los registros).
|
|
467
|
+
|
|
468
|
+
### Teclado
|
|
469
|
+
|
|
470
|
+
| Tecla | Qué hace |
|
|
471
|
+
|---|---|
|
|
472
|
+
| Flechas | Mueve el foco y la selección de fila en fila |
|
|
473
|
+
| Enter | Abre el registro enfocado (avisa `ver`) |
|
|
474
|
+
| Espacio | Marca o desmarca su casilla si la tabla tiene columna `checkbox`; si no, abre como Enter |
|
|
475
|
+
| Supr | Pide eliminar (no hace nada en solo lectura ni dentro de un campo de la celda) |
|
|
476
|
+
|
|
477
|
+
Las teclas pulsadas dentro de un campo de una celda se quedan en el campo.
|
|
478
|
+
|
|
479
|
+
## Eventos
|
|
480
|
+
|
|
481
|
+
| Salida | Cuándo |
|
|
482
|
+
|---|---|
|
|
483
|
+
| `opcionSelecionada` | Botón pulsado, fila elegida, doble clic, menú contextual o `Supr`. Lleva el botón, la fila, su índice y la selección |
|
|
484
|
+
| `resultados` | El servidor debe traer otra página, otro orden u otra búsqueda |
|
|
485
|
+
| `accionRecargar` | El usuario pidió actualizar |
|
|
486
|
+
| `selectionModelChange` | Cambió la fila seleccionada |
|
|
487
|
+
| `opcBusqueda` | Cambió el criterio de búsqueda |
|
|
488
|
+
|
|
489
|
+
## Búsqueda
|
|
490
|
+
|
|
491
|
+
`ctrlBusqueda="simple"` filtra en memoria; `ctrlBusqueda="query"` manda el término al servidor
|
|
492
|
+
dentro de `resultados`. `busquedaCompacta` reduce el buscador a un icono que abre un menú con el campo: `true` siempre, `false` nunca y `'auto'` (por defecto) cuando la banda de la tabla es angosta (el mismo umbral de los botones, ver **Tablas angostas**). Decide el ancho de la tabla, no el de la ventana, así un panel angosto también lo compacta; con texto buscado el icono lleva un punto. La búsqueda simple no
|
|
493
|
+
distingue tildes ni mayúsculas ("memorandum" encuentra "MEMORÁNDUM"; la ñ se respeta).
|
|
494
|
+
`ctrlBusquedaAncho` fija el ancho máximo del buscador (por defecto `150px`). `[ctrlBusquedaCampos]="['cNombre', 'cSigla']"` limita la búsqueda simple a
|
|
495
|
+
esos campos (por defecto busca en todos los del registro, también en los que no se ven, como el nombre
|
|
496
|
+
del padre). El texto buscado se
|
|
497
|
+
mantiene al recargar.
|
|
498
|
+
|
|
499
|
+
**La búsqueda suelta la selección que oculta.** Si el texto deja fuera la fila elegida, la tabla
|
|
500
|
+
la suelta y avisa `selectionModelChange(null)`, para que los botones no actúen sobre una fila que no
|
|
501
|
+
se ve (en árbol, una fila que queda como camino atenuado sigue elegida). Precedencia con
|
|
502
|
+
`seguirSeleccion`: manda lo último que pasó. Si la pantalla fija una selección que la búsqueda
|
|
503
|
+
oculta, la tabla limpia la búsqueda; si el usuario escribe un texto que oculta la selección, la
|
|
504
|
+
selección se suelta. Una selección fijada que aún no llegó en los datos no se suelta.
|
|
505
|
+
|
|
506
|
+
El panel de filtros avanzados **no** es parte de esta tabla: es el componente hermano
|
|
507
|
+
`jvs-filtro-busqueda`, que se coloca aparte y devuelve sus resultados por `dataFiltro`.
|
|
508
|
+
|
|
509
|
+
## Árbol (`[arbol]`)
|
|
510
|
+
|
|
511
|
+
Para listas jerárquicas (despachos, dependencias, plan de cuentas…): la tabla recibe la lista
|
|
512
|
+
**plana y completa** —cada registro con su id y el de su padre— y la pinta como árbol, sin perder
|
|
513
|
+
búsqueda, orden, Excel, `[cargando]`, selección ni teclado.
|
|
514
|
+
|
|
515
|
+
```typescript
|
|
516
|
+
readonly arbol = computed<ConfigArbolTabla<Despacho>>(() => ({
|
|
517
|
+
campoId: 'iDespachoId',
|
|
518
|
+
campoIdPadre: 'iDespachoDependeId',
|
|
519
|
+
nivelesAbiertos: 2, // raíz y primer nivel desplegados (por defecto 1)
|
|
520
|
+
plano: this.plano(), // "Lista plana": sin jerarquía
|
|
521
|
+
filtro: d => d.iTipoDespachoId === 4, // filtro propio (tipo, estado…), se suma al buscador
|
|
522
|
+
filtroActivo: this.hayFiltro(), // ¿el filtro cuenta como búsqueda? (ver abajo)
|
|
523
|
+
}));
|
|
524
|
+
```
|
|
525
|
+
|
|
526
|
+
```html
|
|
527
|
+
<jvs-tabla-mantenimiento [arbol]="arbol()" [columnasTabla]="columnas" …>
|
|
528
|
+
```
|
|
529
|
+
|
|
530
|
+
La sangría y el botón de plegar van en una columna `type: 'arbol'` (pinta el texto de `property`
|
|
531
|
+
o de `transformar`) o, para un contenido propio, dentro de una `custom`:
|
|
532
|
+
|
|
533
|
+
```html
|
|
534
|
+
<td *matCellDef="let row" mat-cell>
|
|
535
|
+
<jvs-tabla-arbol-celda [fila]="row">{{ row.cNombre }} <small>{{ row.cSigla }}</small></jvs-tabla-arbol-celda>
|
|
536
|
+
</td>
|
|
537
|
+
```
|
|
538
|
+
|
|
539
|
+
Cómo se comporta:
|
|
540
|
+
|
|
541
|
+
- **Sin búsqueda ni filtro**: árbol con `nivelesAbiertos` niveles desplegados.
|
|
542
|
+
- **Con búsqueda o filtro**: se ven las coincidencias **y sus antepasados**, todo desplegado; los
|
|
543
|
+
antepasados que no coinciden van atenuados (clase `jvs-arbol-contexto`). El árbol nunca queda en
|
|
544
|
+
blanco porque el padre de una coincidencia no pase el filtro. Por defecto el filtro propio
|
|
545
|
+
"cuenta" cuando deja fuera alguna fila; `filtroActivo: false` lo evita para un filtro que está
|
|
546
|
+
siempre puesto (p. ej. ocultar inactivos), que así no despliega todo.
|
|
547
|
+
- Un registro cuyo padre **no está en la lista** sale como raíz; uno que forma un **ciclo** (o es
|
|
548
|
+
su propio padre) también, y el ciclo se corta. Nada desaparece.
|
|
549
|
+
- El botón de plegar no selecciona la fila. `expandirTodoArbol(true | false)` abre o cierra todo.
|
|
550
|
+
- `seleccionarPorId()`, `[selectionModel]` e `irASeleccion()` abren el camino de una fila plegada.
|
|
551
|
+
- Ordenar por una columna reordena **entre hermanos**, sin romper la jerarquía; `comparar` da el
|
|
552
|
+
orden por defecto entre hermanos.
|
|
553
|
+
- El paginador cuenta las filas a la vista. El **Excel** exporta las coincidencias y sus
|
|
554
|
+
antepasados en orden de árbol, aunque estén plegados.
|
|
555
|
+
- **Modo plano** (`plano: true`): sin sangría ni plegado; la búsqueda y el filtro dejan solo las
|
|
556
|
+
coincidencias y el orden por columnas es el de siempre.
|
|
557
|
+
- `infoArbol(fila)` devuelve `{nivel, tieneHijos, abierto, contexto}` (o `null` sin árbol).
|
|
558
|
+
|
|
559
|
+
La lógica vive en `TablaMantenimientoDataSource` (exportado) y en funciones puras de
|
|
560
|
+
`@jvsoft/utils` que sirven sueltas: `indexarArbol`, `filtrarArbolConAntepasados`, `aplanarArbol`,
|
|
561
|
+
`antepasadosArbol`, `descendientesArbol`, `puedeSerPadreArbol` (p. ej. para que un "depende de"
|
|
562
|
+
no ofrezca al propio registro ni a sus descendientes).
|
|
563
|
+
|
|
564
|
+
## Fila extra y pie
|
|
565
|
+
|
|
566
|
+
`filaExtraTemplate` despliega contenido bajo cada fila, normalmente junto a una columna
|
|
567
|
+
`type: 'expandir'`. Con fila extra el ordenamiento se bloquea, porque reordenar rompería la
|
|
568
|
+
correspondencia con lo desplegado. `filaFooter` activa el pie, que cada columna calcula con
|
|
569
|
+
`transformarFooter()`.
|
|
570
|
+
|
|
571
|
+
## Exportación
|
|
572
|
+
|
|
573
|
+
`exportarExcel` (activo por defecto) añade el botón y exporta **lo que se ve**: respeta el
|
|
574
|
+
filtro, el orden y las columnas visibles, y usa `labelLista` como encabezado. Fechas, números y
|
|
575
|
+
montos salen con su tipo, no como texto. `nombreExcel` da nombre a la hoja y al archivo (por
|
|
576
|
+
defecto, `nombreColeccion`).
|
|
577
|
+
|
|
578
|
+
`datosExcel()` devuelve las filas tal como saldrían en el Excel (un objeto por fila, con el
|
|
579
|
+
encabezado de cada columna como clave), sin descargar nada: sirve para revisarlo desde la consola o
|
|
580
|
+
en pruebas.
|
|
581
|
+
|
|
582
|
+
## Animación
|
|
583
|
+
|
|
584
|
+
`[animarFilas]="false"` quita la entrada animada fila por fila (por defecto sigue activa).
|
|
585
|
+
|
|
586
|
+
`[cargando]="cargando()"` muestra una barra de carga indeterminada entre la banda y la cabecera
|
|
587
|
+
mientras es `true`. Sin el input no se dibuja nada; con él, el hueco de 4 px queda reservado para que
|
|
588
|
+
la tabla no salte al cargar.
|
|
589
|
+
|
|
590
|
+
Si el buscador no deja filas, la tabla muestra "Ningún registro coincide con "…"" con un botón
|
|
591
|
+
"Limpiar búsqueda" (en la búsqueda `query` vuelve a pedir los datos). Mientras `cargando` es `true`
|
|
592
|
+
no muestra ningún mensaje de "sin datos".
|
|
593
|
+
|
|
594
|
+
## Notas de comportamiento
|
|
595
|
+
|
|
596
|
+
- La tabla **no escribe dentro de los datos ni de las columnas** que recibe. Si ves propiedades
|
|
597
|
+
que no declaraste, no vienen de aquí.
|
|
598
|
+
- Consultar los botones no los modifica; leer las columnas visibles, tampoco.
|
|
599
|
+
- Si los datos llegan antes de que exista la vista (un `BehaviorSubject` con valor, `toObservable`
|
|
600
|
+
de una señal), el paginador y el orden se enganchan igual: antes la tabla pintaba todas las filas.
|
|
601
|
+
- `objThis.seleccionados[nombreColeccion]` se sigue consultando como respaldo cuando la fila
|
|
602
|
+
elegida no está entre los datos cargados, pero el canal recomendado es `[(selectionModel)]`.
|
|
603
|
+
|
|
604
|
+
## En retirada
|
|
605
|
+
|
|
606
|
+
Estas piezas siguen funcionando pero están marcadas como obsoletas y se quitarán en una
|
|
607
|
+
versión mayor. Si las usas, conviene ir migrando:
|
|
608
|
+
|
|
609
|
+
| En retirada | En su lugar |
|
|
610
|
+
|---|---|
|
|
611
|
+
| `row.isExpanded` dentro del registro | `estaExpandida(row)` y `alternarExpansion(row)` |
|
|
612
|
+
| `objThis.seleccionados[nombreColeccion]` como canal de selección | `[(selectionModel)]` |
|
|
613
|
+
| `dblclickItem` | `opcionSelecionada` con tipo `seleccionar` |
|
|
614
|
+
| `dataSourceChange` | — (entregaba la instancia interna del dataSource) |
|
|
615
|
+
| `DataModel.agregarControles` para casillas | `DataModel.prepararCasillas` |
|
|
616
|
+
| `type: 'image'` y `type: 'badge'` (no se pintan) | `type: 'text'` con `celda` (`imagen()`, `badge()`) |
|
|
617
|
+
| `toolTip` / `toolTipField` en los íconos de `icons` | `tooltip` / `tooltipField` (mismo efecto) |
|
|
618
|
+
| `innerHTMLInvisible` (la librería no lo lee; tampoco el Excel) | `excel.valor` |
|
|
619
|
+
|
|
620
|
+
## Para mirar el código
|
|
621
|
+
|
|
622
|
+
- `tabla-mantenimiento.component.ts` — componente principal
|
|
623
|
+
- `tabla-mantenimiento.service.ts` — catálogo de botones y columnas
|
|
624
|
+
- `tabla-mantenimiento-column-defs/` — un componente por tipo de columna
|
|
625
|
+
- `tabla-celda/` — celdas declarativas: `<jvs-tabla-celda>` y los ayudantes (`piezas.ts`)
|
|
626
|
+
- `classes/data-model.ts` — estado de las casillas de selección múltiple
|
|
627
|
+
- `mat-row-keyboard-selection.directive.ts` — navegación con el teclado
|
|
628
|
+
- `tabla-mantenimiento.component.spec.ts` — el comportamiento descrito aquí, fijado en pruebas
|