@jvsoft/components 1.0.0-alpha.17 → 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 +21 -15
- 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 +57 -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-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 +2160 -148
- 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 +16 -0
- package/lista-detalle/README.md +85 -0
- package/package.json +6 -2
- package/src/styles/base-jvsoft-components.css +715 -15
- package/tabla-mantenimiento/README.md +430 -6
- package/tabla-mantenimiento/tabla-mantenimiento.component.scss +31 -0
- package/types/jvsoft-components-filtro-busqueda.d.ts +6 -0
- package/types/jvsoft-components-lista-arbol.d.ts +17 -1
- package/types/jvsoft-components-lista-detalle.d.ts +44 -0
- package/types/jvsoft-components-tabla-mantenimiento-components-progress-bar.d.ts +1 -2
- package/types/jvsoft-components-tabla-mantenimiento.d.ts +921 -14
- package/types/jvsoft-components.d.ts +1 -0
|
@@ -61,22 +61,224 @@ como tales, no como texto.
|
|
|
61
61
|
|
|
62
62
|
| `type` | Para qué |
|
|
63
63
|
|---|---|
|
|
64
|
-
| `text` | Texto, con `transformar()`,
|
|
64
|
+
| `text` | Texto, con `transformar()`, piezas declarativas (`celda`, ver abajo) o HTML (`innerHTML`) |
|
|
65
65
|
| `number`, `money` | Números y montos, con `zeroFill` y `simboloMoneda` |
|
|
66
66
|
| `date` | Fechas con formato local |
|
|
67
67
|
| `checkbox` | Selección múltiple (ver abajo) |
|
|
68
68
|
| `icons` | Iconos según el valor, con `iconsDef` |
|
|
69
69
|
| `progress` | Barra de progreso |
|
|
70
70
|
| `yes_no`, `estado` | Sí/no y estados |
|
|
71
|
-
| `image` |
|
|
71
|
+
| `image` | En desuso: no se pinta (la celda sale vacía). Usa `text` con `celda` e `imagen()` |
|
|
72
72
|
| `expandir` | Botón que despliega la fila extra |
|
|
73
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**) |
|
|
74
75
|
| `custom` | Lo pinta el consumidor con su propia plantilla |
|
|
75
76
|
| `estiloEstablecido` | Celda con estilo calculado |
|
|
76
77
|
|
|
77
|
-
Propiedades útiles en cualquier columna: `labelLista` (nombre alterno al exportar), `
|
|
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
|
|
78
80
|
`esVisible()` (que pueden ser funciones), `noMostrarEnLista` para ocultarla del menú de columnas,
|
|
79
|
-
`
|
|
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`).
|
|
80
282
|
|
|
81
283
|
Con `filtroCampos` (activo por defecto) el usuario elige qué columnas ve, y la elección se
|
|
82
284
|
recuerda por columna.
|
|
@@ -108,10 +310,118 @@ y eliminar; `'-'` no muestra ninguno.
|
|
|
108
310
|
que la tabla lee del `data.derechos` de la ruta en cada navegación. `ignorarDerechos` lo salta y
|
|
109
311
|
`ignorarDerecho` por botón, también.
|
|
110
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
|
+
|
|
111
398
|
**Solo lectura.** Con `readOnly` solo quedan los botones marcados con `ignorarReadOnly`, y no se
|
|
112
399
|
puede eliminar con `Supr` ni disparar la acción del doble clic. `readOnly="permitirSeleccion"`
|
|
113
400
|
deja elegir la fila sin ejecutar nada.
|
|
114
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
|
+
|
|
115
425
|
## Selección
|
|
116
426
|
|
|
117
427
|
**De una fila**: clic para elegir, clic otra vez sobre la misma para soltarla, flechas para
|
|
@@ -124,6 +434,31 @@ La forma recomendada de leerla es el enlace de dos sentidos:
|
|
|
124
434
|
[(selectionModel)]="seleccionados.personas"
|
|
125
435
|
```
|
|
126
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
|
+
|
|
127
462
|
**De varias filas**: basta una columna `type: 'checkbox'`. La clave de cada casilla sale de
|
|
128
463
|
`chkField` (o del `property` de la columna), y con `chkFieldSeparador` se pueden combinar varios
|
|
129
464
|
campos. Con `chkFieldPersistente` lo marcado sobrevive al cambio de página. El evento
|
|
@@ -154,12 +489,78 @@ Las teclas pulsadas dentro de un campo de una celda se quedan en el campo.
|
|
|
154
489
|
## Búsqueda
|
|
155
490
|
|
|
156
491
|
`ctrlBusqueda="simple"` filtra en memoria; `ctrlBusqueda="query"` manda el término al servidor
|
|
157
|
-
dentro de `resultados`. `busquedaCompacta` reduce el buscador a un icono.
|
|
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
|
|
158
497
|
mantiene al recargar.
|
|
159
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
|
+
|
|
160
506
|
El panel de filtros avanzados **no** es parte de esta tabla: es el componente hermano
|
|
161
507
|
`jvs-filtro-busqueda`, que se coloca aparte y devuelve sus resultados por `dataFiltro`.
|
|
162
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
|
+
|
|
163
564
|
## Fila extra y pie
|
|
164
565
|
|
|
165
566
|
`filaExtraTemplate` despliega contenido bajo cada fila, normalmente junto a una columna
|
|
@@ -171,13 +572,32 @@ correspondencia con lo desplegado. `filaFooter` activa el pie, que cada columna
|
|
|
171
572
|
|
|
172
573
|
`exportarExcel` (activo por defecto) añade el botón y exporta **lo que se ve**: respeta el
|
|
173
574
|
filtro, el orden y las columnas visibles, y usa `labelLista` como encabezado. Fechas, números y
|
|
174
|
-
montos salen con su tipo, no como texto.
|
|
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".
|
|
175
593
|
|
|
176
594
|
## Notas de comportamiento
|
|
177
595
|
|
|
178
596
|
- La tabla **no escribe dentro de los datos ni de las columnas** que recibe. Si ves propiedades
|
|
179
597
|
que no declaraste, no vienen de aquí.
|
|
180
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.
|
|
181
601
|
- `objThis.seleccionados[nombreColeccion]` se sigue consultando como respaldo cuando la fila
|
|
182
602
|
elegida no está entre los datos cargados, pero el canal recomendado es `[(selectionModel)]`.
|
|
183
603
|
|
|
@@ -193,12 +613,16 @@ versión mayor. Si las usas, conviene ir migrando:
|
|
|
193
613
|
| `dblclickItem` | `opcionSelecionada` con tipo `seleccionar` |
|
|
194
614
|
| `dataSourceChange` | — (entregaba la instancia interna del dataSource) |
|
|
195
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` |
|
|
196
619
|
|
|
197
620
|
## Para mirar el código
|
|
198
621
|
|
|
199
622
|
- `tabla-mantenimiento.component.ts` — componente principal
|
|
200
623
|
- `tabla-mantenimiento.service.ts` — catálogo de botones y columnas
|
|
201
624
|
- `tabla-mantenimiento-column-defs/` — un componente por tipo de columna
|
|
625
|
+
- `tabla-celda/` — celdas declarativas: `<jvs-tabla-celda>` y los ayudantes (`piezas.ts`)
|
|
202
626
|
- `classes/data-model.ts` — estado de las casillas de selección múltiple
|
|
203
627
|
- `mat-row-keyboard-selection.directive.ts` — navegación con el teclado
|
|
204
628
|
- `tabla-mantenimiento.component.spec.ts` — el comportamiento descrito aquí, fijado en pruebas
|
|
@@ -7,8 +7,18 @@
|
|
|
7
7
|
--tabla-mantenimiento-seleccion-fondo: rgb(179, 217, 252);
|
|
8
8
|
--tabla-mantenimiento-seleccion-texto: rgb(1, 84, 164);
|
|
9
9
|
|
|
10
|
+
// Acento de la tabla (botones `activo`, segmentados y su badge), en tripleta "r, g, b" para
|
|
11
|
+
// poder usarlo con opacidad: `rgba(var(--tabla-mantenimiento-acento), .1)`. El estándar es el
|
|
12
|
+
// mismo azul del texto de la fila elegida, para que selección y botones armonicen.
|
|
13
|
+
--tabla-mantenimiento-acento: 1, 84, 164;
|
|
14
|
+
--tabla-mantenimiento-acento-contraste: 255, 255, 255;
|
|
15
|
+
|
|
10
16
|
--mat-paginator-container-size: 30px;
|
|
11
17
|
|
|
18
|
+
// Nº de fila: gris de apoyo (no sigue el tema). Las plantillas lo usan en una clase de
|
|
19
|
+
// Tailwind con valor arbitrario (`text-[var(--…)]`), así una app puede cambiarlo.
|
|
20
|
+
--tabla-mantenimiento-numeracion-texto: rgb(107, 114, 128);
|
|
21
|
+
|
|
12
22
|
/*
|
|
13
23
|
"--tabla-mantenimiento-seleccion-fondo": "rgb(179,217,252)",
|
|
14
24
|
"--tabla-mantenimiento-seleccion-texto": "rgb(1,84,164)"
|
|
@@ -39,6 +49,16 @@
|
|
|
39
49
|
}
|
|
40
50
|
|
|
41
51
|
|
|
52
|
+
// Badge de los botones que declaran `activo`: con el acento de la tabla y su contraste, y
|
|
53
|
+
// anillo blanco, que lo separa también del botón elegido, que va relleno del mismo acento. Se queda en SCSS porque `.mat-badge-content` lo crea la directiva
|
|
54
|
+
// `matBadge` de Material dentro del botón, fuera de la plantilla, y sus colores vienen de
|
|
55
|
+
// tokens de Material que hay que vencer.
|
|
56
|
+
.contenedor-botones button[aria-pressed] .mat-badge-content {
|
|
57
|
+
background-color: rgb(var(--tabla-mantenimiento-acento)) !important;
|
|
58
|
+
color: rgb(var(--tabla-mantenimiento-acento-contraste)) !important;
|
|
59
|
+
box-shadow: 0 0 0 1px #fff;
|
|
60
|
+
}
|
|
61
|
+
|
|
42
62
|
/* 1. Si hay un <div> dentro del primer td/th, insertar en el primer div */
|
|
43
63
|
tr.regTooltip > td:first-child div:first-child::before,
|
|
44
64
|
tr.regTooltip > th:first-child div:first-child::before {
|
|
@@ -248,3 +268,14 @@
|
|
|
248
268
|
}
|
|
249
269
|
}
|
|
250
270
|
}
|
|
271
|
+
|
|
272
|
+
// `coloresTema`: la tabla toma los colores del tema de la entidad en vez de los estándar. Solo
|
|
273
|
+
// reasigna las variables; las plantillas no cambian. Se deja en SCSS, junto a los valores
|
|
274
|
+
// estándar de arriba, para tener los dos modos en un solo lugar (con Tailwind serían propiedades
|
|
275
|
+
// arbitrarias `[--tabla-mantenimiento-acento:…]` repartidas en el host).
|
|
276
|
+
.jvs-tabla-mantenimiento.jvs-colores-tema {
|
|
277
|
+
--tabla-mantenimiento-acento: var(--color-primary);
|
|
278
|
+
--tabla-mantenimiento-acento-contraste: var(--color-primary-contrast);
|
|
279
|
+
--tabla-mantenimiento-seleccion-fondo: rgba(var(--color-primary), .15);
|
|
280
|
+
--tabla-mantenimiento-seleccion-texto: rgb(var(--color-primary));
|
|
281
|
+
}
|
|
@@ -157,6 +157,12 @@ declare class FiltroBusquedaComponent implements OnInit, OnDestroy {
|
|
|
157
157
|
mostrarValorEnBusqueda: typeof mostrarValorEnBusqueda;
|
|
158
158
|
campoValorEval(campoFiltro: CampoFiltro, itemSelect: any): any;
|
|
159
159
|
campoTextEval(campoFiltro: CampoFiltro, itemSelect: any): string;
|
|
160
|
+
/**
|
|
161
|
+
* Texto recortado para las opciones de un <select> nativo. El navegador abre la lista
|
|
162
|
+
* tan ancha como la opción más larga y en pantallas angostas la corta por la izquierda;
|
|
163
|
+
* el texto completo queda en el title de la opción.
|
|
164
|
+
*/
|
|
165
|
+
textoOpcionSelect(campoFiltro: CampoFiltro, itemSelect: any, maxCaracteres?: number): string;
|
|
160
166
|
concatenarCadenasArray(array: string | string[], objData: any): any;
|
|
161
167
|
filtrarData(): void;
|
|
162
168
|
actualizarEnFormArray(name: string, value: any, extra?: {
|
|
@@ -25,6 +25,16 @@ declare class ListaArbolComponent<T = any> {
|
|
|
25
25
|
templateTxtData: _angular_core.InputSignal<TemplateRef<any> | undefined>;
|
|
26
26
|
condicionMostrar: _angular_core.InputSignal<((item: T) => boolean) | undefined>;
|
|
27
27
|
condicionesClaseFila: _angular_core.InputSignal<(item: T) => string[]>;
|
|
28
|
+
/**
|
|
29
|
+
* Pulsar el texto de un nodo con hijos, además de seleccionarlo, lo abre o cierra (lo de
|
|
30
|
+
* siempre). Con `false` el texto solo selecciona. El chevron abre o cierra sin seleccionar.
|
|
31
|
+
*/
|
|
32
|
+
abrirAlSeleccionar: _angular_core.InputSignal<boolean>;
|
|
33
|
+
/**
|
|
34
|
+
* Mensaje cuando no hay nada que pintar (lista vacía). Sin definir no se muestra nada, como
|
|
35
|
+
* antes: hay pantallas que ponen su propio mensaje debajo.
|
|
36
|
+
*/
|
|
37
|
+
mensajeVacio: _angular_core.InputSignal<string | null | undefined>;
|
|
28
38
|
idTabla: _angular_core.InputSignalWithTransform<string | string[], string | string[]>;
|
|
29
39
|
selectionModel: _angular_core.InputSignal<any>;
|
|
30
40
|
selectionModelChange: _angular_core.OutputEmitterRef<any>;
|
|
@@ -36,6 +46,8 @@ declare class ListaArbolComponent<T = any> {
|
|
|
36
46
|
private _seleccionado;
|
|
37
47
|
listaMuestraArbol: _angular_core.WritableSignal<T[]>;
|
|
38
48
|
listaOriginal: _angular_core.WritableSignal<T[]>;
|
|
49
|
+
/** Ya llegó al menos una lista: antes de eso no se muestra el mensaje de vacío. */
|
|
50
|
+
datosRecibidos: _angular_core.WritableSignal<boolean>;
|
|
39
51
|
chkLista: DataModel;
|
|
40
52
|
idTablaValue: _angular_core.Signal<string[]>;
|
|
41
53
|
buscarItemSeleccionado: _angular_core.Signal<NonNullable<T> | null>;
|
|
@@ -47,6 +59,10 @@ declare class ListaArbolComponent<T = any> {
|
|
|
47
59
|
propiedadSeleccion(item: any): string;
|
|
48
60
|
esSeleccionActual(item: any): boolean;
|
|
49
61
|
seleccionarItem(item?: any, forzado?: boolean): void;
|
|
62
|
+
/** Clic en el texto del nodo: lo selecciona y, con `abrirAlSeleccionar`, abre o cierra su rama. */
|
|
63
|
+
clicNodo(node: any, conHijos: boolean): void;
|
|
64
|
+
/** Abre o cierra la rama (recursivo con `expandirRecursivo`), sin tocar la selección. */
|
|
65
|
+
alternarNodo(node: any): void;
|
|
50
66
|
hasChild: (_: number, node: any) => boolean;
|
|
51
67
|
opcMenu(v: any): void;
|
|
52
68
|
emitirModeloCheck(): void;
|
|
@@ -55,7 +71,7 @@ declare class ListaArbolComponent<T = any> {
|
|
|
55
71
|
hijosActivos(tipo: 'checked' | 'indeterminate', checkActual: T): boolean;
|
|
56
72
|
classFila(item: any): string[];
|
|
57
73
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ListaArbolComponent<any>, never>;
|
|
58
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ListaArbolComponent<any>, "jvs-lista-arbol", never, { "listaSuscription": { "alias": "listaSuscription"; "required": true; "isSignal": true; }; "nombreColeccion": { "alias": "nombreColeccion"; "required": true; "isSignal": true; }; "checkbox": { "alias": "checkbox"; "required": false; "isSignal": true; }; "expandirRecursivo": { "alias": "expandirRecursivo"; "required": false; "isSignal": true; }; "checkboxSeleccionados": { "alias": "checkboxSeleccionados"; "required": false; "isSignal": true; }; "campoId": { "alias": "campoId"; "required": true; "isSignal": true; }; "campoIdPadre": { "alias": "campoIdPadre"; "required": true; "isSignal": true; }; "campoStr": { "alias": "campoStr"; "required": false; "isSignal": true; }; "campoOrden": { "alias": "campoOrden"; "required": false; "isSignal": true; }; "strHijoContainer": { "alias": "strHijoContainer"; "required": false; "isSignal": true; }; "menuContextual": { "alias": "menuContextual"; "required": false; "isSignal": true; }; "classSeleccionado": { "alias": "classSeleccionado"; "required": false; "isSignal": true; }; "classAnulado": { "alias": "classAnulado"; "required": false; "isSignal": true; }; "campoAnulado": { "alias": "campoAnulado"; "required": false; "isSignal": true; }; "templateTxtData": { "alias": "templateTxtData"; "required": false; "isSignal": true; }; "condicionMostrar": { "alias": "condicionMostrar"; "required": false; "isSignal": true; }; "condicionesClaseFila": { "alias": "condicionesClaseFila"; "required": false; "isSignal": true; }; "idTabla": { "alias": "idTabla"; "required": true; "isSignal": true; }; "selectionModel": { "alias": "selectionModel"; "required": false; "isSignal": true; }; }, { "selectionModelChange": "selectionModelChange"; "seleccionado": "seleccionado"; "listaCheck": "listaCheck"; "listaCheckObj": "listaCheckObj"; }, never, never, true, never>;
|
|
74
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ListaArbolComponent<any>, "jvs-lista-arbol", never, { "listaSuscription": { "alias": "listaSuscription"; "required": true; "isSignal": true; }; "nombreColeccion": { "alias": "nombreColeccion"; "required": true; "isSignal": true; }; "checkbox": { "alias": "checkbox"; "required": false; "isSignal": true; }; "expandirRecursivo": { "alias": "expandirRecursivo"; "required": false; "isSignal": true; }; "checkboxSeleccionados": { "alias": "checkboxSeleccionados"; "required": false; "isSignal": true; }; "campoId": { "alias": "campoId"; "required": true; "isSignal": true; }; "campoIdPadre": { "alias": "campoIdPadre"; "required": true; "isSignal": true; }; "campoStr": { "alias": "campoStr"; "required": false; "isSignal": true; }; "campoOrden": { "alias": "campoOrden"; "required": false; "isSignal": true; }; "strHijoContainer": { "alias": "strHijoContainer"; "required": false; "isSignal": true; }; "menuContextual": { "alias": "menuContextual"; "required": false; "isSignal": true; }; "classSeleccionado": { "alias": "classSeleccionado"; "required": false; "isSignal": true; }; "classAnulado": { "alias": "classAnulado"; "required": false; "isSignal": true; }; "campoAnulado": { "alias": "campoAnulado"; "required": false; "isSignal": true; }; "templateTxtData": { "alias": "templateTxtData"; "required": false; "isSignal": true; }; "condicionMostrar": { "alias": "condicionMostrar"; "required": false; "isSignal": true; }; "condicionesClaseFila": { "alias": "condicionesClaseFila"; "required": false; "isSignal": true; }; "abrirAlSeleccionar": { "alias": "abrirAlSeleccionar"; "required": false; "isSignal": true; }; "mensajeVacio": { "alias": "mensajeVacio"; "required": false; "isSignal": true; }; "idTabla": { "alias": "idTabla"; "required": true; "isSignal": true; }; "selectionModel": { "alias": "selectionModel"; "required": false; "isSignal": true; }; }, { "selectionModelChange": "selectionModelChange"; "seleccionado": "seleccionado"; "listaCheck": "listaCheck"; "listaCheckObj": "listaCheckObj"; }, never, never, true, never>;
|
|
59
75
|
}
|
|
60
76
|
|
|
61
77
|
export { ListaArbolComponent };
|