@jvsoft/components 1.0.0-alpha.16 → 1.0.0-alpha.17
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 +188 -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-lista-arbol.mjs +1 -0
- package/fesm2022/jvsoft-components-lista-arbol.mjs.map +1 -1
- 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.mjs +472 -273
- package/fesm2022/jvsoft-components-tabla-mantenimiento.mjs.map +1 -1
- package/lista-arbol/README.md +1 -1
- package/package.json +2 -2
- package/src/styles/base-jvsoft-components.css +4 -5
- package/tabla-mantenimiento/README.md +204 -0
- package/types/jvsoft-components-dialog-flotante.d.ts +2 -0
- package/types/jvsoft-components-lista-arbol.d.ts +2 -1
- package/types/jvsoft-components-menu.d.ts +1 -0
- package/types/jvsoft-components-tabla-mantenimiento.d.ts +151 -9
package/lista-arbol/README.md
CHANGED
|
@@ -77,7 +77,7 @@ export class ExampleComponent {
|
|
|
77
77
|
|--------|------|-------------|
|
|
78
78
|
| `seleccionado` | `EventEmitter<any>` | Emite cuando se selecciona un item |
|
|
79
79
|
| `selectionModelChange` | `EventEmitter<any>` | Emite cambios en el modelo de selección |
|
|
80
|
-
| `listaCheck` | `
|
|
80
|
+
| `listaCheck` | `OutputEmitterRef<string>` | Emite los ids seleccionados separados por comas, p. ej. `"6,8"` (modo checkbox) |
|
|
81
81
|
| `listaCheckObj` | `EventEmitter<Record<string, any>>` | Emite objeto con items seleccionados (modo checkbox) |
|
|
82
82
|
|
|
83
83
|
## Ejemplos
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@jvsoft/components",
|
|
3
|
-
"version": "1.0.0-alpha.
|
|
3
|
+
"version": "1.0.0-alpha.17",
|
|
4
4
|
"description": "JVSOFT Angular Components",
|
|
5
5
|
"publishConfig": {
|
|
6
6
|
"tag": "alpha",
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
"@angular/core": ">=17.1.0",
|
|
12
12
|
"@angular/forms": ">=17.1.0",
|
|
13
13
|
"@angular/material": ">=17.1.0",
|
|
14
|
-
"@jvsoft/utils": "1.0.0-alpha.
|
|
14
|
+
"@jvsoft/utils": "1.0.0-alpha.17",
|
|
15
15
|
"tailwindcss": "3",
|
|
16
16
|
"xlsx": "^0.18.5"
|
|
17
17
|
},
|
|
@@ -554,6 +554,10 @@ video {
|
|
|
554
554
|
display: none;
|
|
555
555
|
}
|
|
556
556
|
|
|
557
|
+
.\!visible {
|
|
558
|
+
visibility: visible !important;
|
|
559
|
+
}
|
|
560
|
+
|
|
557
561
|
.visible {
|
|
558
562
|
visibility: visible;
|
|
559
563
|
}
|
|
@@ -1284,11 +1288,6 @@ video {
|
|
|
1284
1288
|
color: rgb(74 222 128 / var(--tw-text-opacity, 1));
|
|
1285
1289
|
}
|
|
1286
1290
|
|
|
1287
|
-
.text-green-600 {
|
|
1288
|
-
--tw-text-opacity: 1;
|
|
1289
|
-
color: rgb(22 163 74 / var(--tw-text-opacity, 1));
|
|
1290
|
-
}
|
|
1291
|
-
|
|
1292
1291
|
.text-green-700 {
|
|
1293
1292
|
--tw-text-opacity: 1;
|
|
1294
1293
|
color: rgb(21 128 61 / var(--tw-text-opacity, 1));
|
|
@@ -0,0 +1,204 @@
|
|
|
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()`, HTML o plantilla propia |
|
|
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` | Imagen |
|
|
72
|
+
| `expandir` | Botón que despliega la fila extra |
|
|
73
|
+
| `numeracion_automatica` | Numeración continua, respetando la página |
|
|
74
|
+
| `custom` | Lo pinta el consumidor con su propia plantilla |
|
|
75
|
+
| `estiloEstablecido` | Celda con estilo calculado |
|
|
76
|
+
|
|
77
|
+
Propiedades útiles en cualquier columna: `labelLista` (nombre alterno al exportar), `visible` y
|
|
78
|
+
`esVisible()` (que pueden ser funciones), `noMostrarEnLista` para ocultarla del menú de columnas,
|
|
79
|
+
`sticky`/`stickyEnd`, `sort: false`, `cssClasses`, `transformar(row)` y `transformarFooter()`.
|
|
80
|
+
|
|
81
|
+
Con `filtroCampos` (activo por defecto) el usuario elige qué columnas ve, y la elección se
|
|
82
|
+
recuerda por columna.
|
|
83
|
+
|
|
84
|
+
## Botones
|
|
85
|
+
|
|
86
|
+
`TablaMantenimientoService` trae un catálogo ya estilado: `nuevo`, `editar`, `eliminar`,
|
|
87
|
+
`eliminar_fila`, `imprimir`, `descargar`, `ver_archivos`, `exportar_pdf`, `exportar_excel`,
|
|
88
|
+
`exportacion_avanzada`, `guardar`, `cancelar`, `seleccionar`, `detalle`, `ver_mapa`, `activar`,
|
|
89
|
+
`desactivar`, `cerrar` y `abrir`. Basta nombrar el `tipo` y se hereda icono y color.
|
|
90
|
+
|
|
91
|
+
```typescript
|
|
92
|
+
botonesMenu: SeccionesBotonesMantenimiento = {
|
|
93
|
+
principal: [
|
|
94
|
+
{ tipo: 'nuevo' },
|
|
95
|
+
{ tipo: 'reportes', icono: 'roundPrint', subItems: [
|
|
96
|
+
{ tipo: 'imprimir', label: 'Listado' },
|
|
97
|
+
{ tipo: 'exportar_pdf' },
|
|
98
|
+
]},
|
|
99
|
+
],
|
|
100
|
+
};
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
Secciones disponibles: `crud`, `principal`, `izquierda`, `derecha`, `secundario`, `inferior`, y
|
|
104
|
+
cualquier clave propia. `botonesCRUD` es una máscara de texto: `'CUD'` muestra crear, actualizar
|
|
105
|
+
y eliminar; `'-'` no muestra ninguno.
|
|
106
|
+
|
|
107
|
+
**Permisos.** Cada botón se deshabilita solo según `derechosActuales[cDerechoCodigo ?? tipo]`,
|
|
108
|
+
que la tabla lee del `data.derechos` de la ruta en cada navegación. `ignorarDerechos` lo salta y
|
|
109
|
+
`ignorarDerecho` por botón, también.
|
|
110
|
+
|
|
111
|
+
**Solo lectura.** Con `readOnly` solo quedan los botones marcados con `ignorarReadOnly`, y no se
|
|
112
|
+
puede eliminar con `Supr` ni disparar la acción del doble clic. `readOnly="permitirSeleccion"`
|
|
113
|
+
deja elegir la fila sin ejecutar nada.
|
|
114
|
+
|
|
115
|
+
## Selección
|
|
116
|
+
|
|
117
|
+
**De una fila**: clic para elegir, clic otra vez sobre la misma para soltarla, flechas para
|
|
118
|
+
moverse, Enter para abrir. La selección sobrevive a las recargas: la tabla vuelve a
|
|
119
|
+
encontrar el registro por `idTabla` y entrega el objeto nuevo, no el anterior.
|
|
120
|
+
|
|
121
|
+
La forma recomendada de leerla es el enlace de dos sentidos:
|
|
122
|
+
|
|
123
|
+
```html
|
|
124
|
+
[(selectionModel)]="seleccionados.personas"
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
**De varias filas**: basta una columna `type: 'checkbox'`. La clave de cada casilla sale de
|
|
128
|
+
`chkField` (o del `property` de la columna), y con `chkFieldSeparador` se pueden combinar varios
|
|
129
|
+
campos. Con `chkFieldPersistente` lo marcado sobrevive al cambio de página. El evento
|
|
130
|
+
`opcionSelecionada` lleva entonces `idsSeleccionados` (texto separado por comas) e
|
|
131
|
+
`itemsSeleccionados` (los registros).
|
|
132
|
+
|
|
133
|
+
### Teclado
|
|
134
|
+
|
|
135
|
+
| Tecla | Qué hace |
|
|
136
|
+
|---|---|
|
|
137
|
+
| Flechas | Mueve el foco y la selección de fila en fila |
|
|
138
|
+
| Enter | Abre el registro enfocado (avisa `ver`) |
|
|
139
|
+
| Espacio | Marca o desmarca su casilla si la tabla tiene columna `checkbox`; si no, abre como Enter |
|
|
140
|
+
| Supr | Pide eliminar (no hace nada en solo lectura ni dentro de un campo de la celda) |
|
|
141
|
+
|
|
142
|
+
Las teclas pulsadas dentro de un campo de una celda se quedan en el campo.
|
|
143
|
+
|
|
144
|
+
## Eventos
|
|
145
|
+
|
|
146
|
+
| Salida | Cuándo |
|
|
147
|
+
|---|---|
|
|
148
|
+
| `opcionSelecionada` | Botón pulsado, fila elegida, doble clic, menú contextual o `Supr`. Lleva el botón, la fila, su índice y la selección |
|
|
149
|
+
| `resultados` | El servidor debe traer otra página, otro orden u otra búsqueda |
|
|
150
|
+
| `accionRecargar` | El usuario pidió actualizar |
|
|
151
|
+
| `selectionModelChange` | Cambió la fila seleccionada |
|
|
152
|
+
| `opcBusqueda` | Cambió el criterio de búsqueda |
|
|
153
|
+
|
|
154
|
+
## Búsqueda
|
|
155
|
+
|
|
156
|
+
`ctrlBusqueda="simple"` filtra en memoria; `ctrlBusqueda="query"` manda el término al servidor
|
|
157
|
+
dentro de `resultados`. `busquedaCompacta` reduce el buscador a un icono. El texto buscado se
|
|
158
|
+
mantiene al recargar.
|
|
159
|
+
|
|
160
|
+
El panel de filtros avanzados **no** es parte de esta tabla: es el componente hermano
|
|
161
|
+
`jvs-filtro-busqueda`, que se coloca aparte y devuelve sus resultados por `dataFiltro`.
|
|
162
|
+
|
|
163
|
+
## Fila extra y pie
|
|
164
|
+
|
|
165
|
+
`filaExtraTemplate` despliega contenido bajo cada fila, normalmente junto a una columna
|
|
166
|
+
`type: 'expandir'`. Con fila extra el ordenamiento se bloquea, porque reordenar rompería la
|
|
167
|
+
correspondencia con lo desplegado. `filaFooter` activa el pie, que cada columna calcula con
|
|
168
|
+
`transformarFooter()`.
|
|
169
|
+
|
|
170
|
+
## Exportación
|
|
171
|
+
|
|
172
|
+
`exportarExcel` (activo por defecto) añade el botón y exporta **lo que se ve**: respeta el
|
|
173
|
+
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.
|
|
175
|
+
|
|
176
|
+
## Notas de comportamiento
|
|
177
|
+
|
|
178
|
+
- La tabla **no escribe dentro de los datos ni de las columnas** que recibe. Si ves propiedades
|
|
179
|
+
que no declaraste, no vienen de aquí.
|
|
180
|
+
- Consultar los botones no los modifica; leer las columnas visibles, tampoco.
|
|
181
|
+
- `objThis.seleccionados[nombreColeccion]` se sigue consultando como respaldo cuando la fila
|
|
182
|
+
elegida no está entre los datos cargados, pero el canal recomendado es `[(selectionModel)]`.
|
|
183
|
+
|
|
184
|
+
## En retirada
|
|
185
|
+
|
|
186
|
+
Estas piezas siguen funcionando pero están marcadas como obsoletas y se quitarán en una
|
|
187
|
+
versión mayor. Si las usas, conviene ir migrando:
|
|
188
|
+
|
|
189
|
+
| En retirada | En su lugar |
|
|
190
|
+
|---|---|
|
|
191
|
+
| `row.isExpanded` dentro del registro | `estaExpandida(row)` y `alternarExpansion(row)` |
|
|
192
|
+
| `objThis.seleccionados[nombreColeccion]` como canal de selección | `[(selectionModel)]` |
|
|
193
|
+
| `dblclickItem` | `opcionSelecionada` con tipo `seleccionar` |
|
|
194
|
+
| `dataSourceChange` | — (entregaba la instancia interna del dataSource) |
|
|
195
|
+
| `DataModel.agregarControles` para casillas | `DataModel.prepararCasillas` |
|
|
196
|
+
|
|
197
|
+
## Para mirar el código
|
|
198
|
+
|
|
199
|
+
- `tabla-mantenimiento.component.ts` — componente principal
|
|
200
|
+
- `tabla-mantenimiento.service.ts` — catálogo de botones y columnas
|
|
201
|
+
- `tabla-mantenimiento-column-defs/` — un componente por tipo de columna
|
|
202
|
+
- `classes/data-model.ts` — estado de las casillas de selección múltiple
|
|
203
|
+
- `mat-row-keyboard-selection.directive.ts` — navegación con el teclado
|
|
204
|
+
- `tabla-mantenimiento.component.spec.ts` — el comportamiento descrito aquí, fijado en pruebas
|
|
@@ -26,6 +26,8 @@ declare class DialogFlotanteComponent {
|
|
|
26
26
|
btnCerrar: _angular_core.Signal<BotonDialog | undefined>;
|
|
27
27
|
btnGuardar: _angular_core.Signal<BotonDialog | undefined>;
|
|
28
28
|
guardarDialogo(): void;
|
|
29
|
+
/** El diálogo que contiene a este componente, para cerrarlo cuando no se pasa `matDialogRefActual`. */
|
|
30
|
+
private readonly dialogRefContenedor;
|
|
29
31
|
cerrarDialogo(): void;
|
|
30
32
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DialogFlotanteComponent, never>;
|
|
31
33
|
static ɵcmp: _angular_core.ɵɵComponentDeclaration<DialogFlotanteComponent, "[jvsDialogFlotante]", never, { "cssClases": { "alias": "cssClases"; "required": false; "isSignal": true; }; "sinTitulo": { "alias": "sinTitulo"; "required": false; "isSignal": true; }; "sinBarraDeAccion": { "alias": "sinBarraDeAccion"; "required": false; "isSignal": true; }; "btnCerrarBarra": { "alias": "btnCerrarBarra"; "required": false; "isSignal": true; }; "iconoTitulo": { "alias": "iconoTitulo"; "required": false; "isSignal": true; }; "matDialogRefActual": { "alias": "matDialogRefActual"; "required": false; "isSignal": true; }; "btnGuardarInput": { "alias": "btnGuardar"; "required": false; "isSignal": true; }; "btnCerrarInput": { "alias": "btnCerrar"; "required": false; "isSignal": true; }; }, { "btnGuardarClick": "btnGuardarClick"; "btnCerrarClick": "btnCerrarClick"; }, never, ["[tituloImagen]", "[titulo]", "[selectTitulo]", "[cuerpo]", "[pieIzquierda]", "[pieCentro]", "[pieDerecha]"], true, never>;
|
|
@@ -29,7 +29,8 @@ declare class ListaArbolComponent<T = any> {
|
|
|
29
29
|
selectionModel: _angular_core.InputSignal<any>;
|
|
30
30
|
selectionModelChange: _angular_core.OutputEmitterRef<any>;
|
|
31
31
|
seleccionado: _angular_core.OutputEmitterRef<any>;
|
|
32
|
-
|
|
32
|
+
/** Ids marcados, separados por comas (p. ej. "6,8"): es lo que arma `DataModel.generarLista()`. */
|
|
33
|
+
listaCheck: _angular_core.OutputEmitterRef<string>;
|
|
33
34
|
listaCheckObj: _angular_core.OutputEmitterRef<Record<string, any>>;
|
|
34
35
|
private _idTabla;
|
|
35
36
|
private _seleccionado;
|
|
@@ -2,13 +2,12 @@ import * as _jvsoft_components_tabla_mantenimiento from '@jvsoft/components/tabl
|
|
|
2
2
|
import * as _angular_core from '@angular/core';
|
|
3
3
|
import { OnInit, TemplateRef, AfterContentInit, OnChanges, ViewContainerRef, EventEmitter, QueryList, ElementRef, ChangeDetectorRef, SimpleChanges } from '@angular/core';
|
|
4
4
|
import { Overlay, OverlayRef } from '@angular/cdk/overlay';
|
|
5
|
-
import { FormGroup, FormControl
|
|
5
|
+
import { FormGroup, FormControl } from '@angular/forms';
|
|
6
6
|
import { MatMenuTrigger } from '@angular/material/menu';
|
|
7
7
|
import { MatPaginator } from '@angular/material/paginator';
|
|
8
8
|
import { MatSort } from '@angular/material/sort';
|
|
9
9
|
import { MatTableDataSource, MatTable, MatColumnDef } from '@angular/material/table';
|
|
10
10
|
import { BehaviorSubject, Observable, Subscription } from 'rxjs';
|
|
11
|
-
import { SelectionModel } from '@angular/cdk/collections';
|
|
12
11
|
import { Router, ActivatedRoute } from '@angular/router';
|
|
13
12
|
|
|
14
13
|
declare class DataModel {
|
|
@@ -18,6 +17,22 @@ declare class DataModel {
|
|
|
18
17
|
checkbox: ForCheckboxModel;
|
|
19
18
|
constructor();
|
|
20
19
|
generarId(row: any, campoValor: string[] | string, separador?: string): string;
|
|
20
|
+
/**
|
|
21
|
+
* Prepara una casilla por fila usando como clave el mismo identificador con el que la celda
|
|
22
|
+
* lee y escribe (`generarId`). `agregarControles` compone la clave de otra manera cuando el
|
|
23
|
+
* campo es un texto o un array sin separador, así que el modelo y la casilla acababan
|
|
24
|
+
* hablando de claves distintas: la casilla salía vacía y la lista de seleccionados
|
|
25
|
+
* devolvía filas que nadie había marcado.
|
|
26
|
+
*
|
|
27
|
+
* Con `limpiar` en false conserva lo ya marcado, que es lo que espera `chkFieldPersistente`
|
|
28
|
+
* cuando la selección tiene que sobrevivir al cambio de página.
|
|
29
|
+
*/
|
|
30
|
+
prepararCasillas(lista: any[], campoValor: string[] | string, separador?: string, limpiar?: boolean): void;
|
|
31
|
+
/**
|
|
32
|
+
* @deprecated Para las casillas de `tabla-mantenimiento` usar `prepararCasillas`, que
|
|
33
|
+
* compone la clave igual que la celda. Este método compone claves distintas según el tipo
|
|
34
|
+
* de `campoValor`, que es de donde venía el desajuste entre lo marcado y lo informado.
|
|
35
|
+
*/
|
|
21
36
|
agregarControles(lista: any[], idLista: string, limpiar?: boolean, campoValor?: string[] | string | null, campoValorSeparador?: string): void;
|
|
22
37
|
setState(idx: string, state: boolean): void;
|
|
23
38
|
getState(idx: string): boolean | any;
|
|
@@ -28,6 +43,12 @@ declare class DataModel {
|
|
|
28
43
|
declare class ForCheckboxModel {
|
|
29
44
|
private modeloCheck;
|
|
30
45
|
constructor(modeloCheck: DataModel);
|
|
46
|
+
/**
|
|
47
|
+
* Cuenta casillas y marcadas en un solo recorrido. La cabecera consulta el estado en cada
|
|
48
|
+
* ciclo de detección de cambios, y antes cada consulta recorría el modelo dos veces
|
|
49
|
+
* creando dos arrays intermedios; con mil filas marcadas eso era trabajo y basura de sobra.
|
|
50
|
+
*/
|
|
51
|
+
private contar;
|
|
31
52
|
get cantidadActivos(): number;
|
|
32
53
|
get existenActivados(): boolean;
|
|
33
54
|
get todosActivos(): boolean;
|
|
@@ -328,7 +349,6 @@ interface MantenimientoFilaExtraData {
|
|
|
328
349
|
}
|
|
329
350
|
type TiposControlBusqueda = 'query' | 'simple' | '';
|
|
330
351
|
declare class TablaMantenimientoComponent<T> implements OnInit, AfterContentInit, OnChanges {
|
|
331
|
-
private fb;
|
|
332
352
|
overlay: Overlay;
|
|
333
353
|
viewContainerRef: ViewContainerRef;
|
|
334
354
|
protected tablaMantenimientoService: TablaMantenimientoService;
|
|
@@ -352,6 +372,7 @@ declare class TablaMantenimientoComponent<T> implements OnInit, AfterContentInit
|
|
|
352
372
|
filaExtraHeader: MantenimientoFilaExtraData | any;
|
|
353
373
|
filaFooter: boolean;
|
|
354
374
|
botonesCRUD: string;
|
|
375
|
+
/** @deprecated El doble clic ya llega por `opcionSelecionada` con tipo `seleccionar`. */
|
|
355
376
|
dblclickItem: EventEmitter<any>;
|
|
356
377
|
objBotonesCRUD: BotonMantenimiento[];
|
|
357
378
|
classSeleccionado: string[];
|
|
@@ -361,8 +382,13 @@ declare class TablaMantenimientoComponent<T> implements OnInit, AfterContentInit
|
|
|
361
382
|
opcionSelecionada: EventEmitter<any>;
|
|
362
383
|
opcBusqueda: EventEmitter<any>;
|
|
363
384
|
accionRecargar: EventEmitter<any>;
|
|
364
|
-
|
|
365
|
-
|
|
385
|
+
/**
|
|
386
|
+
* Registro seleccionado. El nombre viene de cuando se pensó guardarlo en un
|
|
387
|
+
* `SelectionModel` del CDK; lo que viaja es la fila, y así lo usan las apps con el enlace
|
|
388
|
+
* de dos sentidos `[(selectionModel)]`.
|
|
389
|
+
*/
|
|
390
|
+
set selectionModel(val: T | null | undefined);
|
|
391
|
+
selectionModelChange: EventEmitter<T | null>;
|
|
366
392
|
isRecargarUsed: boolean;
|
|
367
393
|
filaExtraTemplate: TemplateRef<any> | undefined;
|
|
368
394
|
paginator: MatPaginator;
|
|
@@ -372,6 +398,10 @@ declare class TablaMantenimientoComponent<T> implements OnInit, AfterContentInit
|
|
|
372
398
|
alturaFull: _angular_core.InputSignal<boolean>;
|
|
373
399
|
pageSize: number;
|
|
374
400
|
pageSizeOptions: number[];
|
|
401
|
+
/**
|
|
402
|
+
* @deprecated Entrega la instancia interna del `MatTableDataSource`, que ahora se reutiliza
|
|
403
|
+
* entre cargas: quien la guarde estará tocando el estado de la tabla por la espalda.
|
|
404
|
+
*/
|
|
375
405
|
dataSourceChange: EventEmitter<any>;
|
|
376
406
|
resultados: EventEmitter<any>;
|
|
377
407
|
dataSource: MatTableDataSource<T, MatPaginator>;
|
|
@@ -386,9 +416,16 @@ declare class TablaMantenimientoComponent<T> implements OnInit, AfterContentInit
|
|
|
386
416
|
pageLength: null;
|
|
387
417
|
};
|
|
388
418
|
ignorarDerechos: boolean;
|
|
389
|
-
|
|
419
|
+
private derechosDelPadre;
|
|
420
|
+
private _derechosActuales;
|
|
421
|
+
get derechosActuales(): any;
|
|
422
|
+
/**
|
|
423
|
+
* Permisos con los que se habilitan los botones. Normalmente se leen solos del `data` de la
|
|
424
|
+
* ruta, pero si la pantalla los pasa a mano, mandan los suyos: antes cada navegación
|
|
425
|
+
* sobrescribía lo que el padre acababa de poner.
|
|
426
|
+
*/
|
|
427
|
+
set derechosActuales(val: any);
|
|
390
428
|
rows: QueryList<ElementRef<HTMLTableRowElement>>;
|
|
391
|
-
rowFooter: ElementRef<HTMLTableRowElement>;
|
|
392
429
|
mouseEvent$: Subscription | undefined;
|
|
393
430
|
overlayRef: OverlayRef | undefined;
|
|
394
431
|
userMenu: TemplateRef<any>;
|
|
@@ -400,7 +437,7 @@ declare class TablaMantenimientoComponent<T> implements OnInit, AfterContentInit
|
|
|
400
437
|
chkLista: DataModel;
|
|
401
438
|
bDireccionOrden: _angular_core.WritableSignal<number>;
|
|
402
439
|
mostrarBotonOrden: _angular_core.InputSignal<boolean>;
|
|
403
|
-
constructor(
|
|
440
|
+
constructor(overlay: Overlay, viewContainerRef: ViewContainerRef, tablaMantenimientoService: TablaMantenimientoService, cdRef: ChangeDetectorRef);
|
|
404
441
|
busquedaTipo: _angular_core.InputSignalWithTransform<TiposControlBusqueda, string>;
|
|
405
442
|
private _leyenda;
|
|
406
443
|
get leyenda(): {
|
|
@@ -416,15 +453,59 @@ declare class TablaMantenimientoComponent<T> implements OnInit, AfterContentInit
|
|
|
416
453
|
set idTabla(val: string[] | string);
|
|
417
454
|
private _columnasTabla;
|
|
418
455
|
get columnasTabla(): ColumnaTabla<any>[];
|
|
456
|
+
/**
|
|
457
|
+
* Columnas a pintar, mezcladas con el catálogo del servicio.
|
|
458
|
+
*
|
|
459
|
+
* Devuelve una lista nueva con copias: antes transformaba el array del consumidor en su
|
|
460
|
+
* sitio, así que su definición quedaba con el tipo cambiado (`estado` pasa a `icons`) y las
|
|
461
|
+
* columnas `custom` marcadas como no visibles. Reutilizar esa misma definición en otra
|
|
462
|
+
* tabla dejaba la columna `custom` oculta para siempre, porque la segunda pasada guardaba
|
|
463
|
+
* como visibilidad original el `false` que había dejado la primera.
|
|
464
|
+
*/
|
|
419
465
|
set columnasTabla(val: ColumnaTabla<any>[]);
|
|
420
466
|
private _botonesMenu;
|
|
421
467
|
get botonesMenu(): SeccionesBotonesMantenimiento;
|
|
468
|
+
/**
|
|
469
|
+
* Los botones que tocan pintar. En solo lectura quedan los marcados con `ignorarReadOnly`,
|
|
470
|
+
* y de los que tienen submenú quedan sus opciones permitidas.
|
|
471
|
+
*
|
|
472
|
+
* Devuelve estructuras nuevas y no toca `botonesMenu`. Antes filtraba sobre el propio
|
|
473
|
+
* estado, y como la plantilla lo consulta seis veces por ciclo, cada lectura se comía lo
|
|
474
|
+
* que quedaba: en solo lectura la tabla acababa sin ningún botón, ni siquiera los CRUD.
|
|
475
|
+
* La condición de los submenús estaba además al revés, así que descartaba justo los
|
|
476
|
+
* botones cuyas opciones sí estaban permitidas.
|
|
477
|
+
*/
|
|
422
478
|
get botonesMenuFinal(): SeccionesBotonesMantenimiento;
|
|
423
479
|
set botonesMenu(val: SeccionesBotonesMantenimiento);
|
|
424
480
|
get listaMenuCompleto(): BotonMantenimiento[];
|
|
481
|
+
/** Si la columna se ofrece en el menú de columnas. `noMostrar` es el alias antiguo. */
|
|
482
|
+
esColumnaEnLista(column: any): boolean;
|
|
483
|
+
/** Si la columna se pinta ahora mismo, sin escribir la respuesta dentro de la columna. */
|
|
484
|
+
esColumnaVisible(column: any): boolean;
|
|
485
|
+
/**
|
|
486
|
+
* Columnas que toca pintar. Consultarlo no escribe en las columnas del consumidor: antes
|
|
487
|
+
* copiaba `noMostrar` a `noMostrarEnLista` y fijaba `visible`, de modo que una columna
|
|
488
|
+
* declarada con una función dejaba de ser dinámica en cuanto se pintaba la tabla una vez.
|
|
489
|
+
*
|
|
490
|
+
* Sigue escribiendo `sort` cuando hay fila extra, porque es el único canal por el que la
|
|
491
|
+
* definición de columnas se entera de que no debe ofrecer el ordenamiento.
|
|
492
|
+
*/
|
|
425
493
|
get objVisibleColumns(): ColumnaTabla<any>[];
|
|
494
|
+
/**
|
|
495
|
+
* Columnas que recibe la definición de columnas. Con fila extra desplegable el
|
|
496
|
+
* ordenamiento se bloquea, y eso se resuelve aquí entregando copias: antes se lograba
|
|
497
|
+
* escribiendo `sort: false` dentro de la columna del consumidor, que quedaba marcada para
|
|
498
|
+
* siempre aunque la tabla dejara de usar la fila extra.
|
|
499
|
+
*/
|
|
500
|
+
get columnasParaDefinir(): ColumnaTabla<any>[];
|
|
426
501
|
get visibleColumns(): string[];
|
|
427
502
|
get tieneCheckbox(): false | _jvsoft_components_tabla_mantenimiento.ColumnaCheckbox<any>;
|
|
503
|
+
/**
|
|
504
|
+
* Última búsqueda del registro seleccionado, guardada para no repetirla. Vale mientras no
|
|
505
|
+
* cambien ni la selección ni los datos: `classFila` consulta esto una vez por fila y por
|
|
506
|
+
* ciclo, así que sin memoria una tabla de N filas hacía N búsquedas sobre N registros.
|
|
507
|
+
*/
|
|
508
|
+
private cacheSeleccionado;
|
|
428
509
|
get buscarItemSeleccionado(): any;
|
|
429
510
|
get objSeleccionado(): any;
|
|
430
511
|
set objSeleccionado(val: any);
|
|
@@ -435,6 +516,27 @@ declare class TablaMantenimientoComponent<T> implements OnInit, AfterContentInit
|
|
|
435
516
|
rowTooltip: (item: any) => string;
|
|
436
517
|
soloIconos?: TipoValorFuncion<boolean>;
|
|
437
518
|
ngOnInit(): void;
|
|
519
|
+
/** Filas desplegadas, por su identificador. El estado es de la tabla, no del registro. */
|
|
520
|
+
private filasExpandidas;
|
|
521
|
+
/** Se pasa a la definición de columnas, que pregunta por fila al pintar el icono. */
|
|
522
|
+
readonly estaExpandidaFn: (item: any) => boolean;
|
|
523
|
+
/**
|
|
524
|
+
* Si la fila está desplegada. Además del estado propio se mira `isExpanded` dentro del
|
|
525
|
+
* registro, porque varias pantallas lo traen puesto para abrir una fila de entrada
|
|
526
|
+
* (archivo digital hace `firstRow.isExpanded = true` antes de entregar los datos).
|
|
527
|
+
*/
|
|
528
|
+
estaExpandida(item: any): boolean;
|
|
529
|
+
/**
|
|
530
|
+
* Despliega o pliega la fila. El estado vive aquí.
|
|
531
|
+
*
|
|
532
|
+
* @deprecated El espejo `isExpanded` dentro del registro se mantiene solo por
|
|
533
|
+
* compatibilidad y se retirará: las pantallas que lo leen (`*ngIf="row.isExpanded"`) o lo
|
|
534
|
+
* escriben para abrir una fila de entrada deben pasar a `estaExpandida()` y
|
|
535
|
+
* `alternarExpansion()`.
|
|
536
|
+
*/
|
|
537
|
+
alternarExpansion(item: any): void;
|
|
538
|
+
/** Toma del `data` de la ruta lo que la pantalla no haya pasado por entrada. */
|
|
539
|
+
aplicarDerechosDeRuta(data: any): void;
|
|
438
540
|
ngAfterContentInit(): void;
|
|
439
541
|
ngOnChanges(changes: SimpleChanges): void;
|
|
440
542
|
trackByFn: (index: number, item: any) => string;
|
|
@@ -442,9 +544,19 @@ declare class TablaMantenimientoComponent<T> implements OnInit, AfterContentInit
|
|
|
442
544
|
agregarBotonesExportacion(): void;
|
|
443
545
|
actualizarCrud(): void;
|
|
444
546
|
classFila(item: any): any[];
|
|
547
|
+
/**
|
|
548
|
+
* Memoria del tooltip por registro. La plantilla lo pide tres veces por fila (texto,
|
|
549
|
+
* `matTooltipDisabled` y la clase `regTooltip`), y cada llamada ejecuta el `rowTooltip` del
|
|
550
|
+
* consumidor. Se recalcula cuando cambian los datos.
|
|
551
|
+
*/
|
|
552
|
+
private cacheTooltip;
|
|
445
553
|
procesarRowTooltip(item: any): string;
|
|
554
|
+
private calcularRowTooltip;
|
|
446
555
|
subItemsActivos(btn: any, item: any): boolean;
|
|
447
|
-
|
|
556
|
+
/** Se arma una sola vez: la plantilla lo consume con `async`, y devolver un observable nuevo
|
|
557
|
+
* en cada ciclo hacía que la tubería se desuscribiera y volviera a suscribirse sin parar. */
|
|
558
|
+
private noData$;
|
|
559
|
+
get noData(): Observable<boolean>;
|
|
448
560
|
onFilterChange(value: string): void;
|
|
449
561
|
toggleColumnVisibility(column: any, event: any): void;
|
|
450
562
|
cargarData(retorno?: boolean): any;
|
|
@@ -453,6 +565,36 @@ declare class TablaMantenimientoComponent<T> implements OnInit, AfterContentInit
|
|
|
453
565
|
botonDisabled(btn: BotonMantenimiento, item: any): boolean | undefined;
|
|
454
566
|
propiedadSeleccion(item: any): string;
|
|
455
567
|
esSeleccionActual(item: any): boolean;
|
|
568
|
+
/**
|
|
569
|
+
* `Supr` sobre la fila pide eliminar. Se ignora cuando la tecla viene de un campo de la
|
|
570
|
+
* celda: ahí el usuario está borrando texto, no el registro.
|
|
571
|
+
*/
|
|
572
|
+
teclaEliminarEnFila(item: any, evento: Event): void;
|
|
573
|
+
/**
|
|
574
|
+
* Espacio sobre la fila enfocada. Con columna de casillas marca o desmarca la suya, que es
|
|
575
|
+
* lo que se espera de esa tecla en una lista con selección múltiple; sin casillas se
|
|
576
|
+
* comporta como Enter y abre el registro.
|
|
577
|
+
*/
|
|
578
|
+
teclaEspacioEnFila(item: any): void;
|
|
579
|
+
/**
|
|
580
|
+
* El teclado movió el foco a otra fila: se selecciona, pero sin avisar `ver`. Recorrer la
|
|
581
|
+
* tabla con las flechas dispararía un aviso por fila, y los padres suelen cargar datos con él.
|
|
582
|
+
*/
|
|
583
|
+
seleccionarFilaPorId(id: string): void;
|
|
584
|
+
/**
|
|
585
|
+
* Clic sobre una fila. `evento.detail` es el contador de clics del navegador: en un clic
|
|
586
|
+
* suelto vale 1 y la selección alterna, así que volver a pulsar la fila la deselecciona.
|
|
587
|
+
* El segundo clic de un doble clic llega con 2: ahí la selección se fuerza —alternar dejaba
|
|
588
|
+
* la fila apagada justo al abrir el registro— y no se vuelve a avisar `ver`, porque los
|
|
589
|
+
* consumidores que alternan su propia selección con ese evento acababan en desacuerdo con
|
|
590
|
+
* la tabla.
|
|
591
|
+
*/
|
|
592
|
+
/**
|
|
593
|
+
* Doble clic sobre la fila. En solo lectura no dispara la acción: `permitirSeleccion` deja
|
|
594
|
+
* elegir la fila, pero ni ese modo ni el solo lectura completo ejecutan nada.
|
|
595
|
+
*/
|
|
596
|
+
dobleClicFila(item: any): void;
|
|
597
|
+
clicFila(item: any, tableDataIndex: number, evento: MouseEvent): void;
|
|
456
598
|
seleccionarItem(item?: any, forzado?: boolean): void;
|
|
457
599
|
opcMenu(item: any, objMenu: OpcionSeleccionada, modal?: null, retorno?: boolean): 1 | OpcionSeleccionada;
|
|
458
600
|
emitirResultados(evento?: {}): void;
|