@acropole/skills 1.1.0 → 1.3.0
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/README.md +3 -1
- package/bin/install.js +4 -3
- package/package.json +4 -4
- package/skills/acropole/SKILL.md +2 -0
- package/skills/acropole/references/fluxos/tela-nova.md +1 -1
- package/skills/auto-servico/SKILL.md +153 -0
- package/skills/auto-servico/references/diagnostico.md +42 -0
- package/skills/auto-servico/references/roteiros.md +63 -0
- package/skills/auto-servico/references/tools.md +108 -0
- package/skills/orfeu/SKILL.md +1 -1
- package/skills/orquestracao/SKILL.md +118 -0
- package/skills/orquestracao/references/paralelismo.md +48 -0
- package/skills/orquestracao/scripts/coord.sh +131 -0
- package/skills/orquestracao/templates/permissoes-argos.sql +28 -0
- package/skills/orquestracao/templates/plan.md +45 -0
- package/skills/orquestracao/templates/spec.md +54 -0
- package/skills/orquestracao/templates/tasks.md +21 -0
- package/skills/trismegisto/SKILL.md +2 -2
- package/skills/trismegisto/references/angular-api.md +649 -505
- package/skills/trismegisto/references/angular-exports.md +530 -130
- package/skills/trismegisto/references/angular-types.md +1 -1
- package/skills/trismegisto/references/angular.md +18 -8
- package/skills/trismegisto/references/catalogo/icones.json +5 -0
- package/skills/trismegisto/references/catalogo/seletores.json +444 -31
- package/skills/trismegisto/references/catalogo/tokens.json +136 -16
- package/skills/trismegisto/references/spine-api.md +36 -38
- package/skills/trismegisto/references/spine.md +3 -2
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Catálogo de API — @trismegisto/angular
|
|
2
2
|
|
|
3
|
-
> **Gerado** a partir do código-fonte da versão 1.0.
|
|
4
|
-
> Gerado do código-fonte do `@trismegisto/angular` 1.0.
|
|
3
|
+
> **Gerado** a partir do código-fonte da versão 1.0.2, a cada `npm run sync` do @acropole/skills.
|
|
4
|
+
> Gerado do código-fonte do `@trismegisto/angular` 1.0.2. Confira a versão instalada no `package.json` do pacote em `node_modules`.
|
|
5
5
|
|
|
6
6
|
Legenda: `input` = `[prop]`; `model` = two-way `[(prop)]`; `output` = `(evento)`.
|
|
7
7
|
Slots são os seletores de `<ng-content>`: projete com o atributo (ex.: `<div footer>`).
|
|
@@ -13,7 +13,7 @@ Membros "herdados" vêm da classe base (ex.: `HermesFormFieldBase` dá `disabled
|
|
|
13
13
|
|
|
14
14
|
`AccordionContentDirective` — import de `@trismegisto/angular/accordion` (também na raiz)
|
|
15
15
|
|
|
16
|
-
|
|
16
|
+
Corpo preguiçoso de um `hm-accordion-panel`: `<ng-template hmAccordionContent>…</ng-template>` (ou `*hmAccordionContent`) como filho direto. Criado na primeira abertura e mantido ao fechar, a menos que o painel tenha `destroyOnClose`.
|
|
17
17
|
|
|
18
18
|
_Sem inputs/outputs._
|
|
19
19
|
|
|
@@ -21,7 +21,7 @@ _Sem inputs/outputs._
|
|
|
21
21
|
|
|
22
22
|
`AccordionPanelComponent` — import de `@trismegisto/angular/accordion` (também na raiz)
|
|
23
23
|
|
|
24
|
-
Um
|
|
24
|
+
Um painel de acordeão: cabeçalho (`[heading]` e, opcional, `[description]`) que abre e fecha o corpo.
|
|
25
25
|
|
|
26
26
|
Slots: `[heading]`, `[description]`, `(padrão)`
|
|
27
27
|
|
|
@@ -30,15 +30,15 @@ Métodos públicos: `close(): void`
|
|
|
30
30
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
31
31
|
|---|---|---|---|---|
|
|
32
32
|
| `disabled` | input | `boolean` | `false` | |
|
|
33
|
-
| `headingLevel` | input | `number` | `3` | Nível do
|
|
34
|
-
| `open` | model | `boolean` | `false` |
|
|
35
|
-
| `destroyOnClose` | input | `boolean` | `false` | Com
|
|
33
|
+
| `headingLevel` | input | `number` | `3` | Nível do título (`aria-level`) dentro da hierarquia da página. |
|
|
34
|
+
| `open` | model | `boolean` | `false` | |
|
|
35
|
+
| `destroyOnClose` | input | `boolean` | `false` | Com `hmAccordionContent`: destrói o corpo ao fechar (recria ao abrir). |
|
|
36
36
|
|
|
37
37
|
## `hm-accordion`
|
|
38
38
|
|
|
39
39
|
`AccordionComponent` — import de `@trismegisto/angular/accordion` (também na raiz)
|
|
40
40
|
|
|
41
|
-
Grupo de
|
|
41
|
+
Grupo de painéis que abrem e fecham (`hm-accordion-panel`). Por padrão só um fica aberto por vez; `multi` permite vários. As setas ↑/↓ e Home/End passeiam pelos cabeçalhos do grupo (só movem o foco).
|
|
42
42
|
|
|
43
43
|
Slots: `(padrão)`
|
|
44
44
|
|
|
@@ -46,26 +46,26 @@ Métodos públicos: `closeOthers(opened: { close(): void }): void`
|
|
|
46
46
|
|
|
47
47
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
48
48
|
|---|---|---|---|---|
|
|
49
|
-
| `multi` | input | `boolean` | `false` | Permite mais de um painel aberto
|
|
49
|
+
| `multi` | input | `boolean` | `false` | Permite mais de um painel aberto ao mesmo tempo. |
|
|
50
50
|
|
|
51
51
|
## `hm-account-avatar`
|
|
52
52
|
|
|
53
53
|
`AccountAvatarComponent` — import de `@trismegisto/angular/account-avatar` (também na raiz)
|
|
54
54
|
|
|
55
|
-
|
|
55
|
+
Círculo que identifica uma pessoa ao lado do nome dela (menu da conta, autor de comentário, responsável numa lista).
|
|
56
56
|
|
|
57
57
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
58
58
|
|---|---|---|---|---|
|
|
59
|
-
| `name` | input | `string` | `''` | Nome da
|
|
60
|
-
| `imageUrl` | input | `string \| null \| undefined` | `null` |
|
|
61
|
-
| `size` | input | `AccountAvatarSize \| null` | `null` |
|
|
62
|
-
| `loading` | input | `boolean` | `false` |
|
|
59
|
+
| `name` | input | `string` | `''` | Nome da pessoa, de onde saem as iniciais. Vazio e sem foto, aparece o ícone genérico. |
|
|
60
|
+
| `imageUrl` | input | `string \| null \| undefined` | `null` | Endereço da foto (opcional). Se não carregar, ficam as iniciais. |
|
|
61
|
+
| `size` | input | `AccountAvatarSize \| null` | `null` | Diâmetro na escala do sistema. Sem valor, segue o `--hm-avatar-size` herdado. |
|
|
62
|
+
| `loading` | input | `boolean` | `false` | Os dados da pessoa ainda não chegaram: mostra o placeholder de carregamento. |
|
|
63
63
|
|
|
64
64
|
## `hm-alert-group`
|
|
65
65
|
|
|
66
66
|
`AlertGroupComponent` — import de `@trismegisto/angular/alert` (também na raiz)
|
|
67
67
|
|
|
68
|
-
|
|
68
|
+
Empilha vários `hm-alert` numa faixa só e mostra um por vez, com paginador ("2 de 3") quando há mais de um aberto. Alertas fechados saem da conta. `[(current)]` é o índice pedido; o mostrado é esse índice preso ao número de abertos, então fechar o último não deixa a faixa vazia.
|
|
69
69
|
|
|
70
70
|
Slots: `hm-alert`
|
|
71
71
|
|
|
@@ -73,14 +73,14 @@ Métodos públicos: `isCurrent(alert: object): boolean`
|
|
|
73
73
|
|
|
74
74
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
75
75
|
|---|---|---|---|---|
|
|
76
|
-
| `label` | input | `string` | `''` | Nome da
|
|
77
|
-
| `current` | model | `number` | `0` |
|
|
76
|
+
| `label` | input | `string` | `''` | Nome da região; vazio usa a contagem ("3 alertas"). |
|
|
77
|
+
| `current` | model | `number` | `0` | Índice pedido entre os alertas abertos. |
|
|
78
78
|
|
|
79
79
|
## `hm-alert`
|
|
80
80
|
|
|
81
81
|
`AlertComponent` — import de `@trismegisto/angular/alert` (também na raiz)
|
|
82
82
|
|
|
83
|
-
|
|
83
|
+
Aviso dentro do conteúdo (`inline`) ou faixa do app (`banner`). O erro interrompe o leitor de tela (`role="alert"`); os outros tons são `status`. Cada tom tem glifo próprio, então a cor nunca é o único sinal.
|
|
84
84
|
|
|
85
85
|
Slots: `(padrão)`, `[actions]`
|
|
86
86
|
|
|
@@ -89,16 +89,16 @@ Métodos públicos: `close(): void`
|
|
|
89
89
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
90
90
|
|---|---|---|---|---|
|
|
91
91
|
| `variant` | input | `AlertVariant` | `'info'` | |
|
|
92
|
-
| `appearance` | input | `AlertAppearance` | `'inline'` |
|
|
93
|
-
| `heading` | input | `string` | `''` |
|
|
92
|
+
| `appearance` | input | `AlertAppearance` | `'inline'` | |
|
|
93
|
+
| `heading` | input | `string` | `''` | |
|
|
94
94
|
| `closable` | input | `boolean` | `false` | |
|
|
95
|
-
| `size` | input | `AlertSize` | `'medium'` |
|
|
95
|
+
| `size` | input | `AlertSize` | `'medium'` | |
|
|
96
96
|
| `showIcon` | input | `boolean` | `true` | |
|
|
97
|
-
| `link` | input | `string` | `''` | URL
|
|
98
|
-
| `linkLabel` | input | `string` | `''` | Texto do
|
|
99
|
-
| `linkTarget` | input | `string` | `''` |
|
|
100
|
-
| `dismissKey` | input | `string` | `''` | Chave para lembrar o fechamento entre visitas
|
|
101
|
-
| `duration` | input | `number` | `0` | Fecha sozinho depois de N ms
|
|
97
|
+
| `link` | input | `string` | `''` | URL do atalho de ação. |
|
|
98
|
+
| `linkLabel` | input | `string` | `''` | Texto do atalho; vazio usa o do catálogo. |
|
|
99
|
+
| `linkTarget` | input | `string` | `''` | |
|
|
100
|
+
| `dismissKey` | input | `string` | `''` | Chave para lembrar o fechamento entre visitas. |
|
|
101
|
+
| `duration` | input | `number` | `0` | Fecha sozinho depois de N ms (0 = nunca). |
|
|
102
102
|
| `closed` | output | `void` | | |
|
|
103
103
|
|
|
104
104
|
## `hm-attachment-group`
|
|
@@ -147,46 +147,46 @@ Slots: `(padrão)`
|
|
|
147
147
|
|
|
148
148
|
`AvatarGroupComponent` — import de `@trismegisto/angular/avatar-group` (também na raiz)
|
|
149
149
|
|
|
150
|
-
|
|
150
|
+
Rostos sobrepostos de quem participa de algo (responsáveis, membros, revisores), com "+N" para o que passar do limite.
|
|
151
151
|
|
|
152
152
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
153
153
|
|---|---|---|---|---|
|
|
154
154
|
| `people` | input (obrigatório) | `readonly AvatarGroupPerson[]` | | |
|
|
155
|
-
| `max` | input | `number` | `3` | Quantos rostos aparecem antes do "+N". 0 =
|
|
155
|
+
| `max` | input | `number` | `3` | Quantos rostos aparecem antes do "+N". `0` = sem limite. |
|
|
156
156
|
| `size` | input | `AvatarGroupSize` | `'medium'` | |
|
|
157
|
-
| `label` | input | `string` | `''` |
|
|
157
|
+
| `label` | input | `string` | `''` | Nome da lista. Vazio usa o texto padrão do catálogo. |
|
|
158
158
|
|
|
159
159
|
## `hm-badge`
|
|
160
160
|
|
|
161
161
|
`BadgeComponent` — import de `@trismegisto/angular/badge` (também na raiz)
|
|
162
162
|
|
|
163
|
-
Contador
|
|
163
|
+
Contador pequeno ao lado de um rótulo (itens novos, pendências) ou só um ponto de "tem novidade".
|
|
164
164
|
|
|
165
165
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
166
166
|
|---|---|---|---|---|
|
|
167
|
-
| `value` | input | `number` | `0` |
|
|
168
|
-
| `max` | input |
|
|
169
|
-
| `dot` | input | `boolean` | `false` | Só o ponto, sem número. |
|
|
167
|
+
| `value` | input | `number` | `0` | |
|
|
168
|
+
| `max` | input | `number` | `BADGE_DEFAULT_MAX` | Teto do número exibido; acima dele aparece `max+`. |
|
|
169
|
+
| `dot` | input | `boolean` | `false` | Só o ponto, sem número (aparece mesmo com `value` 0). |
|
|
170
170
|
| `intent` | input | `BadgeIntent` | `'danger'` | |
|
|
171
|
-
| `label` | input | `string` | `''` |
|
|
171
|
+
| `label` | input | `string` | `''` | Nome acessível. Vazio deixa o contador fora do leitor de tela. |
|
|
172
172
|
|
|
173
173
|
## `hm-breadcrumb`
|
|
174
174
|
|
|
175
175
|
`BreadcrumbComponent` — import de `@trismegisto/angular/breadcrumb` (também na raiz)
|
|
176
176
|
|
|
177
|
-
Trilha "você está aqui":
|
|
177
|
+
Trilha de navegação ("você está aqui"): `<nav>` nomeado com uma lista ordenada; o último degrau é a página atual (`aria-current="page"`, nunca link).
|
|
178
178
|
|
|
179
179
|
Slots: `[actions]`
|
|
180
180
|
|
|
181
181
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
182
182
|
|---|---|---|---|---|
|
|
183
183
|
| `items` | input (obrigatório) | `readonly BreadcrumbItem[]` | | |
|
|
184
|
-
| `maxItems` | input | `number` | `4` | Acima disto o meio
|
|
185
|
-
| `itemsBeforeCollapse` | input | `number` | `1` |
|
|
186
|
-
| `itemsAfterCollapse` | input | `number` | `2` |
|
|
187
|
-
| `label` | input | `string` | `''` | Nome do
|
|
188
|
-
| `loading` | input | `boolean` | `false` |
|
|
189
|
-
| `itemClick` | output | `BreadcrumbItem` | | Clique num degrau com link
|
|
184
|
+
| `maxItems` | input | `number` | `4` | Acima disto a trilha recolhe o meio. `0` nunca recolhe. |
|
|
185
|
+
| `itemsBeforeCollapse` | input | `number` | `1` | Degraus visíveis antes do "…" (mínimo 1). |
|
|
186
|
+
| `itemsAfterCollapse` | input | `number` | `2` | Degraus visíveis depois do "…" (mínimo 1). |
|
|
187
|
+
| `label` | input | `string` | `''` | Nome do `<nav>`. Vazio = texto do catálogo. |
|
|
188
|
+
| `loading` | input | `boolean` | `false` | Mostra a silhueta no lugar da trilha. |
|
|
189
|
+
| `itemClick` | output | `BreadcrumbItem` | | Clique num degrau com link (além da navegação). |
|
|
190
190
|
|
|
191
191
|
## `hm-bubble`
|
|
192
192
|
|
|
@@ -207,29 +207,29 @@ Slots: `(padrão)`
|
|
|
207
207
|
|
|
208
208
|
`BulkInputComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/bulk-input` (também na raiz)
|
|
209
209
|
|
|
210
|
-
|
|
210
|
+
Campo para colar ou digitar vários itens de uma vez (e-mails, códigos, matrículas). O valor do formulário é sempre a lista de itens válidos lida do texto; o texto continua sendo o que a pessoa escreveu, para ela corrigir no lugar o que foi recusado.
|
|
211
211
|
|
|
212
212
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
213
213
|
|---|---|---|---|---|
|
|
214
|
-
| `value` | model | `string[]` | `[]` |
|
|
214
|
+
| `value` | model | `string[]` | `[]` | |
|
|
215
215
|
| `label` | input (obrigatório) | `string` | | |
|
|
216
|
-
| `hint` | input | `string` | `''` |
|
|
216
|
+
| `hint` | input | `string` | `''` | |
|
|
217
217
|
| `placeholder` | input | `string` | `''` | |
|
|
218
218
|
| `rows` | input | `number` | `5` | |
|
|
219
|
-
| `labelHidden` | input | `boolean` | `false` |
|
|
219
|
+
| `labelHidden` | input | `boolean` | `false` | Tira o rótulo da vista sem tirá-lo do leitor de tela. |
|
|
220
220
|
| `loading` | input | `boolean` | `false` | |
|
|
221
|
-
| `separators` | input | `readonly BulkSeparator[]` | `BULK_DEFAULT_SEPARATORS` |
|
|
222
|
-
| `trim` | input | `boolean` | `true` |
|
|
223
|
-
| `textCase` | input | `BulkCase` | `'preserve'` |
|
|
224
|
-
| `ignoreCaseDuplicates` | input | `boolean` | `false` |
|
|
225
|
-
| `validate` | input | `BulkValidator \| null` | `null` |
|
|
226
|
-
| `max` | input | `number \| null` | `null` |
|
|
227
|
-
| `announceDelay` | input | `number` | `800` | Pausa
|
|
228
|
-
| `parsed` | output | `BulkParseResult` | |
|
|
229
|
-
| `disabled` | input (herdado) | `boolean` | `false` |
|
|
230
|
-
| `required` | input (herdado) | `boolean` | `false` |
|
|
231
|
-
| `error` | input (herdado) | `string` | `''` | Erro definido
|
|
232
|
-
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro
|
|
221
|
+
| `separators` | input | `readonly BulkSeparator[]` | `BULK_DEFAULT_SEPARATORS` | |
|
|
222
|
+
| `trim` | input | `boolean` | `true` | |
|
|
223
|
+
| `textCase` | input | `BulkCase` | `'preserve'` | |
|
|
224
|
+
| `ignoreCaseDuplicates` | input | `boolean` | `false` | |
|
|
225
|
+
| `validate` | input | `BulkValidator \| null` | `null` | |
|
|
226
|
+
| `max` | input | `number \| null` | `null` | |
|
|
227
|
+
| `announceDelay` | input | `number` | `800` | Pausa (ms) sem digitar antes de o resumo ser falado. |
|
|
228
|
+
| `parsed` | output | `BulkParseResult` | | Leitura completa do texto (válidos, inválidos, repetidos) a cada mudança dela. |
|
|
229
|
+
| `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
|
|
230
|
+
| `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
|
|
231
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
|
|
232
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
|
|
233
233
|
|
|
234
234
|
## `hm-button-group`
|
|
235
235
|
|
|
@@ -251,6 +251,8 @@ Métodos públicos: `register(button: ButtonComponent): void`, `unregister(butto
|
|
|
251
251
|
|
|
252
252
|
`ButtonComponent` — import de `@trismegisto/angular/button` (também na raiz)
|
|
253
253
|
|
|
254
|
+
Botão de ação (`<button>`) ou de navegação (`<a>`, com `link`).
|
|
255
|
+
|
|
254
256
|
Slots: `[mark]`, `(padrão)`
|
|
255
257
|
|
|
256
258
|
Métodos públicos: `activateFromMenu(): void`
|
|
@@ -260,22 +262,22 @@ Métodos públicos: `activateFromMenu(): void`
|
|
|
260
262
|
| `emphasis` | input | `ButtonEmphasis` | `'high'` | |
|
|
261
263
|
| `intent` | input | `ButtonIntent` | `'primary'` | |
|
|
262
264
|
| `size` | input | `ButtonSize` | `'medium'` | |
|
|
263
|
-
| `type` | input | `'button' \| 'submit'` | `'button'` |
|
|
264
|
-
| `icon` | input | `string` | `''` | Ícone
|
|
265
|
-
| `iconDirection` | input | `string` | `''` |
|
|
266
|
-
| `iconEnd` | input | `string` | `''` |
|
|
265
|
+
| `type` | input | `'button' \| 'submit'` | `'button'` | Tipo do `<button>`. Sem efeito com `link`. |
|
|
266
|
+
| `icon` | input | `string` | `''` | Ícone decorativo antes do rótulo (quem usa registra o ícone). |
|
|
267
|
+
| `iconDirection` | input | `string` | `''` | Direção do `icon`, para os ícones direcionais (`angle`, `arrow`). |
|
|
268
|
+
| `iconEnd` | input | `string` | `''` | Ícone decorativo depois do rótulo. |
|
|
267
269
|
| `disabled` | input | `boolean` | `false` | |
|
|
268
|
-
| `loading` | input | `boolean` | `false` |
|
|
269
|
-
| `busy` | input | `boolean` | `false` | Depreciado
|
|
270
|
-
| `loadingState` | input | `HermesLoadingState` | `HermesLoadingState.DEFAULT` |
|
|
271
|
-
| `loadingStateChange` | output | `HermesLoadingState` | |
|
|
270
|
+
| `loading` | input | `boolean` | `false` | |
|
|
271
|
+
| `busy` | input | `boolean` | `false` | Depreciado use `loading`. |
|
|
272
|
+
| `loadingState` | input | `HermesLoadingState` | `HermesLoadingState.DEFAULT` | |
|
|
273
|
+
| `loadingStateChange` | output | `HermesLoadingState` | | Pede a volta a `DEFAULT` depois de mostrar sucesso/erro (par de `[(loadingState)]`). |
|
|
272
274
|
| `block` | input | `boolean` | `false` | Ocupa a largura toda do contêiner. |
|
|
273
|
-
| `link` | input | `string` | `''` |
|
|
274
|
-
| `newTab` | input | `boolean` | `false` |
|
|
275
|
-
| `caret` | input | `boolean` | `false` | Seta de "abre
|
|
276
|
-
| `inMenu` | input | `boolean` | `false` |
|
|
277
|
-
| `toggle` | input | `boolean` | `false` | Botão de alternância
|
|
278
|
-
| `pressed` | model | `boolean` | `false` |
|
|
275
|
+
| `link` | input | `string` | `''` | Endereço: preenchido, o botão vira `<a href>`. |
|
|
276
|
+
| `newTab` | input | `boolean` | `false` | Com `link`, abre em outra aba. |
|
|
277
|
+
| `caret` | input | `boolean` | `false` | Seta de "abre menu" no fim. |
|
|
278
|
+
| `inMenu` | input | `boolean` | `false` | Num `hm-button-group`, sai da fileira e vai para o menu "…". |
|
|
279
|
+
| `toggle` | input | `boolean` | `false` | Botão de alternância (`aria-pressed`). Sem efeito com `link`. |
|
|
280
|
+
| `pressed` | model | `boolean` | `false` | |
|
|
279
281
|
| `clicked` | output | `void` | | |
|
|
280
282
|
|
|
281
283
|
## `hm-card-container`
|
|
@@ -346,13 +348,13 @@ Slots: `[media]`, `[actions]`, `(padrão)`, `[footer]`
|
|
|
346
348
|
|
|
347
349
|
`CarouselComponent` — import de `@trismegisto/angular/carousel` (também na raiz)
|
|
348
350
|
|
|
349
|
-
Carrossel de slides com
|
|
351
|
+
Carrossel de slides com título, texto e imagem opcional (novidades, apresentação de recursos).
|
|
350
352
|
|
|
351
353
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
352
354
|
|---|---|---|---|---|
|
|
353
|
-
| `label` | input (obrigatório) | `string` | | Nome da região
|
|
355
|
+
| `label` | input (obrigatório) | `string` | | Nome da região (ex.: "Novidades"). |
|
|
354
356
|
| `slides` | input (obrigatório) | `readonly CarouselSlide[]` | | |
|
|
355
|
-
| `interval` | input | `number` | `0` | Milissegundos entre trocas automáticas. `0`
|
|
357
|
+
| `interval` | input | `number` | `0` | Milissegundos entre trocas automáticas. `0` desliga. |
|
|
356
358
|
|
|
357
359
|
## `hm-certificate-viewer`
|
|
358
360
|
|
|
@@ -383,10 +385,10 @@ Grupo de caixas de seleção com valor `string[]` (os `value` marcados, na ordem
|
|
|
383
385
|
| `options` | input (obrigatório) | `readonly CheckboxGroupOption[]` | | |
|
|
384
386
|
| `layout` | input | `CheckboxGroupLayout \| undefined` | `undefined` | Ver `CheckboxGroupLayout`. Sem padrão literal: vazio = `'stacked'`. |
|
|
385
387
|
| `hint` | input | `string` | `''` | Texto de apoio embaixo do grupo. |
|
|
386
|
-
| `disabled` | input (herdado) | `boolean` | `false` |
|
|
387
|
-
| `required` | input (herdado) | `boolean` | `false` |
|
|
388
|
-
| `error` | input (herdado) | `string` | `''` | Erro definido
|
|
389
|
-
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro
|
|
388
|
+
| `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
|
|
389
|
+
| `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
|
|
390
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
|
|
391
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
|
|
390
392
|
|
|
391
393
|
## `hm-checkbox`
|
|
392
394
|
|
|
@@ -400,10 +402,10 @@ Checkbox com rótulo clicável e o visual `.hm-check` (o mesmo do hm-tree e da s
|
|
|
400
402
|
| `labelHidden` | input | `boolean` | `false` | Esconde o rótulo visualmente (continua sendo o nome acessível). |
|
|
401
403
|
| `checked` | model | `boolean` | `false` | Two-way sem formulário. |
|
|
402
404
|
| `indeterminate` | input | `boolean` | `false` | |
|
|
403
|
-
| `disabled` | input (herdado) | `boolean` | `false` |
|
|
404
|
-
| `required` | input (herdado) | `boolean` | `false` |
|
|
405
|
-
| `error` | input (herdado) | `string` | `''` | Erro definido
|
|
406
|
-
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro
|
|
405
|
+
| `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
|
|
406
|
+
| `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
|
|
407
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
|
|
408
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
|
|
407
409
|
|
|
408
410
|
## `hm-chip-group`
|
|
409
411
|
|
|
@@ -426,7 +428,7 @@ Métodos públicos: `isSelected(value: string): boolean`, `isDisabled(): boolean
|
|
|
426
428
|
|
|
427
429
|
`ChipComponent` — import de `@trismegisto/angular/chip` (também na raiz)
|
|
428
430
|
|
|
429
|
-
Ficha (
|
|
431
|
+
Ficha (`hm-chip`): uma escolha já feita que dá para retirar — cada valor de uma seleção múltipla, cada filtro aplicado a uma lista. Não serve para sinalizar estado de nada; status com cor e nome é o `hm-tag`.
|
|
430
432
|
|
|
431
433
|
Slots: `(padrão)`
|
|
432
434
|
|
|
@@ -444,6 +446,42 @@ Slots: `(padrão)`
|
|
|
444
446
|
| `value` | input | `string` | `''` | Identifica a ficha dentro de `hm-chip-group` (é o que entra no `value` do grupo). |
|
|
445
447
|
| `removed` | output | `void` | | O ✕ foi acionado (clique, Enter/Espaço ou Backspace/Delete). Quem escuta remove o item. |
|
|
446
448
|
|
|
449
|
+
## `hm-code-diff`
|
|
450
|
+
|
|
451
|
+
`CodeDiffComponent` — import de `@trismegisto/angular/code-diff` (também na raiz)
|
|
452
|
+
|
|
453
|
+
Diferenças entre dois textos, somente leitura: lado a lado ou unificado, com realce de sintaxe, realce intra-linha, regiões inalteradas recolhidas e navegação entre mudanças.
|
|
454
|
+
|
|
455
|
+
Métodos públicos: `nextChange(): void`, `previousChange(): void`, `goToChange(index: number): void`, `expandAll(): void`, `collapseAll(): void`, `copy(): Promise<boolean>`
|
|
456
|
+
|
|
457
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
458
|
+
|---|---|---|---|---|
|
|
459
|
+
| `original` | input (obrigatório) | `string \| null \| undefined` | | Texto anterior. |
|
|
460
|
+
| `modified` | input (obrigatório) | `string \| null \| undefined` | | Texto novo. |
|
|
461
|
+
| `language` | input | `string \| CodeLanguage \| null \| undefined` | `undefined` | Linguagem dos dois lados (id/alias ou objeto). Sem ela, infere pelo `filename`. |
|
|
462
|
+
| `filename` | input | `string` | `''` | |
|
|
463
|
+
| `originalLabel` | input | `string` | `''` | Títulos das colunas. Vazio = catálogo ("Original"/"Modificado"). |
|
|
464
|
+
| `modifiedLabel` | input | `string` | `''` | |
|
|
465
|
+
| `layout` | input | `CodeDiffLayoutInput` | `'auto'` | `auto` = lado a lado a partir de `--hm-code-diff-split-min` de largura, senão unificado. |
|
|
466
|
+
| `layoutToggle` | input | `boolean` | `false` | Alternância "Lado a lado / Unificado" no cabeçalho. |
|
|
467
|
+
| `intraline` | input | `TextDiffIntraline` | `'word'` | |
|
|
468
|
+
| `whitespace` | input | `TextDiffWhitespace` | `'exact'` | |
|
|
469
|
+
| `ignoreLineEndings` | input | `boolean` | `true` | |
|
|
470
|
+
| `collapseUnchanged` | input | `boolean` | `true` | |
|
|
471
|
+
| `contextLines` | input | `number` | `3` | Linhas inalteradas visíveis em volta de cada mudança (0–100). |
|
|
472
|
+
| `minCollapsed` | input | `number` | `4` | Trecho inalterado só é recolhido se esconder pelo menos isto. |
|
|
473
|
+
| `showLineNumbers` | input | `boolean` | `true` | |
|
|
474
|
+
| `wrap` | input | `boolean` | `false` | |
|
|
475
|
+
| `tabSize` | input | `number` | `4` | |
|
|
476
|
+
| `copyTarget` | input | `CodeDiffCopyTarget` | `'modified'` | O que o botão copiar do cabeçalho copia (`patch` = diff unificado). |
|
|
477
|
+
| `virtualize` | input | `CodeViewerVirtualize` | `'auto'` | |
|
|
478
|
+
| `virtualizeThreshold` | input | `number` | `2000` | |
|
|
479
|
+
| `maxComputeMs` | input | `number` | `500` | Orçamento do cálculo (ms). |
|
|
480
|
+
| `revealInvisibles` | input | `boolean` | `true` | Revela espaços de largura zero e controles C0/C1 (bidi sempre). |
|
|
481
|
+
| `activeChange` | model | `number` | `-1` | Mudança corrente na navegação (0-based); `-1` = nenhuma. |
|
|
482
|
+
| `computed` | output | `TextDiffSummary` | | Cada novo resultado de diff. |
|
|
483
|
+
| `copied` | output | `string` | | Copiou pelo botão do cabeçalho. |
|
|
484
|
+
|
|
447
485
|
## `hm-code-input`
|
|
448
486
|
|
|
449
487
|
`CodeInputComponent` · `ControlValueAccessor` — import de `@trismegisto/angular/code-input` (também na raiz)
|
|
@@ -455,54 +493,98 @@ N caixas de dígito único, com avanço automático ao digitar e retrocesso ao a
|
|
|
455
493
|
| `length` | input | `number` | `6` | |
|
|
456
494
|
| `completed` | output | `string` | | |
|
|
457
495
|
|
|
496
|
+
## `[hmCodeLine]`
|
|
497
|
+
|
|
498
|
+
`CodeLineDirective` — import de `@trismegisto/angular/code-viewer`
|
|
499
|
+
|
|
500
|
+
Desenha UMA linha de código no elemento: tokens como `<span class="hm-code-token--<kind>">` (só classe, `kind` validado contra a lista fechada), texto sempre por nó de texto (nunca HTML), trechos intra-linha do diff e caracteres invisíveis/bidi como marcador visível com nome acessível. Monta o DOM direto (sem uma view do Angular por token): uma linha tem dezenas de nós e um arquivo, milhares de l…
|
|
501
|
+
|
|
502
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
503
|
+
|---|---|---|---|---|
|
|
504
|
+
| `hmCodeLine` | input (obrigatório) | `string` | | Texto da linha (sem o terminador). |
|
|
505
|
+
| `hmCodeLineTokens` | input | `readonly CodeToken[] \| null` | `null` | Tokens (ou `null` enquanto não tokenizada: sai tudo `plain`). |
|
|
506
|
+
| `hmCodeLineReveal` | input | `boolean` | `true` | Revela largura zero e controles C0/C1 (bidi sempre). |
|
|
507
|
+
| `hmCodeLineFirst` | input | `boolean` | `false` | A linha é a primeira do documento (o BOM U+FEFF na posição 0 não é revelado). |
|
|
508
|
+
| `hmCodeLineRanges` | input | `readonly (readonly [number, number])[]` | `[]` | Trechos intra-linha `[início, fim)` e a classe que recebem. |
|
|
509
|
+
| `hmCodeLineRangeClass` | input | `string` | `''` | |
|
|
510
|
+
| `hmCodeLineInvisibleLabel` | input | `string` | `'{code}'` | Nome do marcador: `Caractere invisível {code}`. |
|
|
511
|
+
| `hmCodeLineRef` | input | `CodeLineRef \| null` | `null` | Onde a linha mora no modelo (cópia). |
|
|
512
|
+
|
|
513
|
+
## `hm-code-viewer`
|
|
514
|
+
|
|
515
|
+
`CodeViewerComponent` — import de `@trismegisto/angular/code-viewer` (também na raiz)
|
|
516
|
+
|
|
517
|
+
Visualizador de código somente leitura, com realce de sintaxe por linguagem.
|
|
518
|
+
|
|
519
|
+
Métodos públicos: `copyAll(): Promise<boolean>`, `scrollToLine(line: number, align: 'start' \| 'center' = 'start'): void`
|
|
520
|
+
|
|
521
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
522
|
+
|---|---|---|---|---|
|
|
523
|
+
| `code` | input (obrigatório) | `string \| null \| undefined` | | Texto a exibir. `null`/`undefined` viram `''` (com aviso de desenvolvimento). |
|
|
524
|
+
| `language` | input | `string \| CodeLanguage \| null \| undefined` | `undefined` | Id/alias registrado ou o próprio objeto da linguagem. Sem ele, infere pelo `filename` (senão, texto puro). |
|
|
525
|
+
| `filename` | input | `string` | `''` | Nome no cabeçalho; também infere a linguagem. |
|
|
526
|
+
| `label` | input | `string` | `''` | Nome acessível da região. Vazio = gerado do catálogo. |
|
|
527
|
+
| `showLineNumbers` | input | `boolean` | `true` | |
|
|
528
|
+
| `firstLineNumber` | input | `number` | `1` | Número da primeira linha (inteiro ≥ 0). |
|
|
529
|
+
| `highlightLines` | input | `string \| readonly number[]` | `''` | Linhas destacadas na numeração exibida: `"3, 5-8, 12"` ou `[3, 5]`. |
|
|
530
|
+
| `wrap` | input | `boolean` | `false` | |
|
|
531
|
+
| `tabSize` | input | `number` | `4` | Largura visual do TAB (1–16). Não altera o texto copiado. |
|
|
532
|
+
| `copyable` | input | `boolean` | `true` | |
|
|
533
|
+
| `header` | input | `CodeViewerHeader` | `'auto'` | |
|
|
534
|
+
| `virtualize` | input | `CodeViewerVirtualize` | `'auto'` | |
|
|
535
|
+
| `virtualizeThreshold` | input | `number` | `2000` | |
|
|
536
|
+
| `revealInvisibles` | input | `boolean` | `true` | Revela espaços de largura zero e controles C0/C1. Os controles bidi aparecem sempre. |
|
|
537
|
+
| `copied` | output | `string` | | Copiou pelo botão (ou `copyAll()`): o texto exato. |
|
|
538
|
+
| `tokenized` | output | `void` | | A tokenização do documento inteiro terminou. |
|
|
539
|
+
|
|
458
540
|
## `hm-combobox-multi`
|
|
459
541
|
|
|
460
542
|
`ComboboxMultiComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/combobox-multi` (também na raiz)
|
|
461
543
|
|
|
462
|
-
Escolha de
|
|
544
|
+
Escolha de **vários** valores: fichas no campo (na ordem em que foram escolhidos) e, ao abrir, um cartão com busca e a lista marcável (APG Combobox + Listbox multisseleção). Marcar não fecha a lista; o foco fica na busca do cartão enquanto ela está aberta.
|
|
463
545
|
|
|
464
546
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
465
547
|
|---|---|---|---|---|
|
|
466
548
|
| `label` | input (obrigatório) | `string` | | |
|
|
467
549
|
| `options` | input (obrigatório) | `readonly ComboboxOption[]` | | |
|
|
468
|
-
| `selected` | model | `readonly string[]` | `[]` |
|
|
469
|
-
| `extraOptions` | input | `readonly ComboboxOption[]` | `[]` |
|
|
470
|
-
| `unknownLabel` | input | `string` | `''` |
|
|
471
|
-
| `placeholder` | input | `string` | `''` |
|
|
472
|
-
| `hint` | input | `string` | `''` |
|
|
550
|
+
| `selected` | model | `readonly string[]` | `[]` | Itens marcados, preservando a sequência em que entraram. |
|
|
551
|
+
| `extraOptions` | input | `readonly ComboboxOption[]` | `[]` | Só dão nome a fichas de valores que saíram de `options`; não aparecem na lista. |
|
|
552
|
+
| `unknownLabel` | input | `string` | `''` | Nome da ficha de um valor que ninguém conhece; vazio = o próprio valor. |
|
|
553
|
+
| `placeholder` | input | `string` | `''` | Aparece só sem nenhuma ficha. |
|
|
554
|
+
| `hint` | input | `string` | `''` | |
|
|
473
555
|
| `help` | input | `string` | `''` | Depreciado desde 0.2.0 — use `hint`. |
|
|
474
|
-
| `max` | input | `number \| null` | `null` |
|
|
475
|
-
| `visibleChipsLimit` | input | `number \| null` | `1` |
|
|
476
|
-
| `disabled` | input (herdado) | `boolean` | `false` |
|
|
477
|
-
| `required` | input (herdado) | `boolean` | `false` |
|
|
478
|
-
| `error` | input (herdado) | `string` | `''` | Erro definido
|
|
479
|
-
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro
|
|
556
|
+
| `max` | input | `number \| null` | `null` | Quantidade máxima de itens marcados (`null` libera). |
|
|
557
|
+
| `visibleChipsLimit` | input | `number \| null` | `1` | Fichas visíveis com a lista fechada; `null` = todas. |
|
|
558
|
+
| `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
|
|
559
|
+
| `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
|
|
560
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
|
|
561
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
|
|
480
562
|
|
|
481
563
|
## `hm-combobox`
|
|
482
564
|
|
|
483
565
|
`ComboboxComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/combobox` (também na raiz)
|
|
484
566
|
|
|
485
|
-
Escolha de
|
|
567
|
+
Escolha de **um** valor numa lista longa, filtrando pelo que se digita (padrão Combobox do APG com lista e `aria-activedescendant`: o foco nunca sai do campo).
|
|
486
568
|
|
|
487
569
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
488
570
|
|---|---|---|---|---|
|
|
489
571
|
| `label` | input (obrigatório) | `string` | | |
|
|
490
572
|
| `options` | input (obrigatório) | `readonly ComboboxOption[]` | | |
|
|
491
|
-
| `value` | model | `string` | `''` | `''` =
|
|
573
|
+
| `value` | model | `string` | `''` | Valor escolhido; `''` = nenhum. |
|
|
492
574
|
| `placeholder` | input | `string` | `''` | |
|
|
493
|
-
| `icon` | input | `string` | `''` |
|
|
575
|
+
| `icon` | input | `string` | `''` | Ícone decorativo no início do campo. |
|
|
494
576
|
| `hint` | input | `string` | `''` | Texto de apoio embaixo do campo. |
|
|
495
577
|
| `help` | input | `string` | `''` | Depreciado desde 0.2.0 — use `hint`. |
|
|
496
578
|
| `size` | input | `ComboboxSize` | `'medium'` | |
|
|
497
|
-
| `labelHidden` | input | `boolean` | `false` |
|
|
498
|
-
| `clearable` | input | `boolean` | `false` | Botão
|
|
579
|
+
| `labelHidden` | input | `boolean` | `false` | Rótulo só para tecnologia assistiva (fica visualmente oculto, mas segue como nome acessível). |
|
|
580
|
+
| `clearable` | input | `boolean` | `false` | Botão para limpar a escolha. |
|
|
499
581
|
| `requiredManual` | input | `boolean` | `false` | Depreciado desde 0.2.0 — use `required`. |
|
|
500
|
-
| `loading` | input | `boolean` | `false` |
|
|
501
|
-
| `allowCustomValue` | input | `boolean` | `false` | Aceita texto livre
|
|
502
|
-
| `disabled` | input (herdado) | `boolean` | `false` |
|
|
503
|
-
| `required` | input (herdado) | `boolean` | `false` |
|
|
504
|
-
| `error` | input (herdado) | `string` | `''` | Erro definido
|
|
505
|
-
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro
|
|
582
|
+
| `loading` | input | `boolean` | `false` | Silhueta no lugar do campo enquanto as opções chegam. |
|
|
583
|
+
| `allowCustomValue` | input | `boolean` | `false` | Aceita texto livre: as opções passam a ser sugestões. |
|
|
584
|
+
| `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
|
|
585
|
+
| `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
|
|
586
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
|
|
587
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
|
|
506
588
|
|
|
507
589
|
## `hm-command-palette`
|
|
508
590
|
|
|
@@ -552,21 +634,21 @@ Métodos públicos: `close(): void`
|
|
|
552
634
|
|
|
553
635
|
`CopyButtonComponent` — import de `@trismegisto/angular/copy-button` (também na raiz)
|
|
554
636
|
|
|
555
|
-
Botão
|
|
637
|
+
Botão de copiar um valor para a área de transferência.
|
|
556
638
|
|
|
557
639
|
Métodos públicos: `copy(): Promise<boolean>`
|
|
558
640
|
|
|
559
641
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
560
642
|
|---|---|---|---|---|
|
|
561
|
-
| `value` | input (obrigatório) | `string` | |
|
|
562
|
-
| `label` | input (obrigatório) | `string` | |
|
|
563
|
-
| `copiedLabel` | input | `string` | `''` |
|
|
643
|
+
| `value` | input (obrigatório) | `string` | | Valor copiado ao clicar. |
|
|
644
|
+
| `label` | input (obrigatório) | `string` | | O que o botão faz ("Copiar token"): nome acessível (`icon`) ou texto visível (`text`). |
|
|
645
|
+
| `copiedLabel` | input | `string` | `''` | Confirmação depois de copiar. Vazio = texto do catálogo. |
|
|
564
646
|
| `variant` | input | `CopyButtonVariant` | `'icon'` | |
|
|
565
647
|
| `size` | input | `ButtonSize` | `'medium'` | |
|
|
566
648
|
| `disabled` | input | `boolean` | `false` | |
|
|
567
|
-
| `feedbackDuration` | input | `number` | `2000` |
|
|
649
|
+
| `feedbackDuration` | input | `number` | `2000` | Por quanto tempo (ms) a confirmação ou a falha fica à vista. |
|
|
568
650
|
| `copied` | output | `string` | | Copiou: emite o texto copiado. |
|
|
569
|
-
| `copyFailed` | output | `unknown` | | Nenhuma
|
|
651
|
+
| `copyFailed` | output | `unknown` | | Nenhuma via funcionou: emite o erro da API de clipboard (ou `null`). |
|
|
570
652
|
|
|
571
653
|
## `hm-data-grid-action-bar`
|
|
572
654
|
|
|
@@ -596,13 +678,13 @@ Troca o desenho de uma célula por um template projetado, sem trocar o DADO dela
|
|
|
596
678
|
|
|
597
679
|
`DataGridColumnFilterComponent` — import de `@trismegisto/angular/data-grid` (também na raiz)
|
|
598
680
|
|
|
599
|
-
|
|
681
|
+
Per-column filter card of `hm-data-grid`: a free-text field, or a checkbox list when `options` is given. Fully controlled — it shows `term`/`values` as received and only reports intents; whoever opened it clears `anchor` on `closed`.
|
|
600
682
|
|
|
601
683
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
602
684
|
|---|---|---|---|---|
|
|
603
|
-
| `anchor` | input (obrigatório) | `PopoverAnchor \| null` | |
|
|
604
|
-
| `label` | input (obrigatório) | `string` | |
|
|
605
|
-
| `options` | input | `readonly GridFilterOption[] \| null` | `null` |
|
|
685
|
+
| `anchor` | input (obrigatório) | `PopoverAnchor \| null` | | Trigger rectangle in viewport px; `null` keeps the card closed. |
|
|
686
|
+
| `label` | input (obrigatório) | `string` | | Accessible name of the card and of the text field. |
|
|
687
|
+
| `options` | input | `readonly GridFilterOption[] \| null` | `null` | Checkbox choices; `null` switches to the text field. |
|
|
606
688
|
| `term` | input | `string` | `''` | |
|
|
607
689
|
| `values` | input | `readonly string[]` | `[]` | |
|
|
608
690
|
| `termChanged` | output | `string` | | |
|
|
@@ -624,7 +706,7 @@ Troca o desenho do TÍTULO de uma coluna (não a célula) por um template projet
|
|
|
624
706
|
|
|
625
707
|
`DataGridComponent` — import de `@trismegisto/angular/data-grid` (também na raiz)
|
|
626
708
|
|
|
627
|
-
|
|
709
|
+
Tabela de dados: busca e filtro por coluna, filtro composto, ordenação, agrupamento, paginação, seleção, detalhe por linha (abaixo ou em painel), ações por linha, colunas redimensionáveis, reordenáveis e fixas, exportação, persistência e rolagem virtual. O template é o mesmo para todos os modos; cada recurso mora numa feature em `features/` e esta classe só as liga.
|
|
628
710
|
|
|
629
711
|
Slots: `[dataGridActions]`
|
|
630
712
|
|
|
@@ -636,58 +718,58 @@ Métodos públicos: `exportCsv(options: DataGridExportOptions = {}): string`, `c
|
|
|
636
718
|
|---|---|---|---|---|
|
|
637
719
|
| `columns` | input (obrigatório) | `readonly GridColumn<T>[]` | | |
|
|
638
720
|
| `rows` | input (obrigatório) | `readonly T[]` | | |
|
|
639
|
-
| `rowId` | input (obrigatório) | `(row: T) => string` | |
|
|
640
|
-
| `caption` | input (obrigatório) | `string` | |
|
|
721
|
+
| `rowId` | input (obrigatório) | `(row: T) => string` | | |
|
|
722
|
+
| `caption` | input (obrigatório) | `string` | | Nome acessível da tabela (`<caption>`). |
|
|
641
723
|
| `rowActions` | input | `readonly DataGridRowAction<T>[]` | `[]` | |
|
|
642
724
|
| `loading` | input | `boolean` | `false` | |
|
|
643
725
|
| `error` | input | `string` | `''` | |
|
|
644
|
-
| `emptyMessage` | input | `string` | `''` |
|
|
645
|
-
| `noResultsMessage` | input | `string` | `''` |
|
|
646
|
-
| `filterable` | input | `boolean` | `true` |
|
|
647
|
-
| `paginated` | input | `boolean` | `true` | Corta
|
|
726
|
+
| `emptyMessage` | input | `string` | `''` | |
|
|
727
|
+
| `noResultsMessage` | input | `string` | `''` | Mensagem quando há filtro ativo e nada passou; vazia, vale a de vazio. |
|
|
728
|
+
| `filterable` | input | `boolean` | `true` | |
|
|
729
|
+
| `paginated` | input | `boolean` | `true` | Corta em páginas no cliente. |
|
|
648
730
|
| `pageState` | model | `PaginationState` | `INITIAL_PAGE` | |
|
|
649
|
-
| `pagination` | input | `boolean` | `true` | Mostra
|
|
650
|
-
| `totalItems` | input | `number \| null` | `null` | Total
|
|
731
|
+
| `pagination` | input | `boolean` | `true` | Mostra contagem, itens por página e paginador no rodapé. |
|
|
732
|
+
| `totalItems` | input | `number \| null` | `null` | Total do servidor (paginação remota); `null` = o total filtrado local. |
|
|
651
733
|
| `sort` | model | `readonly GridSort[]` | `[]` | |
|
|
652
|
-
| `selectable` | input | `boolean` | `false` |
|
|
653
|
-
| `selectionMode` | input | `DataGridSelectionMode` | `'none'` |
|
|
734
|
+
| `selectable` | input | `boolean` | `false` | |
|
|
735
|
+
| `selectionMode` | input | `DataGridSelectionMode` | `'none'` | |
|
|
654
736
|
| `selection` | model | `GridSelection` | `EMPTY_SELECTION` | |
|
|
655
|
-
| `rowSelectable` | input | `((row: T) => boolean) \| null` | `null` |
|
|
656
|
-
| `rowSelectableReason` | input | `((row: T) => string) \| null` | `null` |
|
|
657
|
-
| `rowDetailDisabled` | input | `((row: T) => boolean) \| null` | `null` |
|
|
658
|
-
| `rowDetailHidden` | input | `((row: T) => boolean) \| null` | `null` |
|
|
659
|
-
| `virtual` | input | `boolean` | `false` |
|
|
660
|
-
| `rowHeight` | input | `number` | `40` | Altura estimada
|
|
661
|
-
| `pinnedColumns` | model | `GridPinnedColumns` | `NO_PINNED_COLUMNS` |
|
|
662
|
-
| `columnState` | model | `readonly GridColumnState[]` | `[]` |
|
|
663
|
-
| `pageSizes` | input | `readonly number[]` | `[10, 25, 50, 100]` |
|
|
737
|
+
| `rowSelectable` | input | `((row: T) => boolean) \| null` | `null` | |
|
|
738
|
+
| `rowSelectableReason` | input | `((row: T) => string) \| null` | `null` | |
|
|
739
|
+
| `rowDetailDisabled` | input | `((row: T) => boolean) \| null` | `null` | |
|
|
740
|
+
| `rowDetailHidden` | input | `((row: T) => boolean) \| null` | `null` | |
|
|
741
|
+
| `virtual` | input | `boolean` | `false` | |
|
|
742
|
+
| `rowHeight` | input | `number` | `40` | Altura estimada da linha (px) na rolagem virtual, até ela ser medida. |
|
|
743
|
+
| `pinnedColumns` | model | `GridPinnedColumns` | `NO_PINNED_COLUMNS` | |
|
|
744
|
+
| `columnState` | model | `readonly GridColumnState[]` | `[]` | |
|
|
745
|
+
| `pageSizes` | input | `readonly number[]` | `[10, 25, 50, 100]` | |
|
|
664
746
|
| `fillHeight` | input | `boolean` | `false` | |
|
|
665
747
|
| `maxHeight` | input | `string` | `''` | |
|
|
666
|
-
| `bordered` | input | `boolean` | `false` |
|
|
748
|
+
| `bordered` | input | `boolean` | `false` | |
|
|
667
749
|
| `rowState` | input | `(row: T) => DataGridRowState \| null` | `() => null` | |
|
|
668
750
|
| `rowClickable` | input | `boolean` | `false` | |
|
|
669
751
|
| `actionTriggered` | output | `DataGridActionTriggered<T>` | | |
|
|
670
752
|
| `detailToggled` | output | `{ row: T; open: boolean }` | | |
|
|
671
753
|
| `rowClicked` | output | `T` | | |
|
|
672
754
|
| `clearFiltersRequested` | output | `void` | | |
|
|
673
|
-
| `filteredChange` | output | `readonly T[]` | |
|
|
674
|
-
| `remoteSearch` | input | `boolean` | `false` |
|
|
755
|
+
| `filteredChange` | output | `readonly T[]` | | Todas as linhas depois de filtrar e ordenar (todas as páginas). |
|
|
756
|
+
| `remoteSearch` | input | `boolean` | `false` | |
|
|
675
757
|
| `searchTermChanged` | output | `string` | | |
|
|
676
|
-
| `remoteSort` | input | `boolean` | `false` |
|
|
677
|
-
| `itemsLabel` | input | `string` | `''` |
|
|
678
|
-
| `pageSizeLabel` | input | `string` | `''` |
|
|
679
|
-
| `exportable` | input | `boolean` | `false` |
|
|
680
|
-
| `exportFileName` | input | `string` | `''` |
|
|
681
|
-
| `groupBy` | model | `string \| null` | `null` |
|
|
682
|
-
| `aggregates` | input | `GridAggregates` | `{}` |
|
|
683
|
-
| `aggregateFormatter` | input | `GridAggregateFormatter \| null` | `null` |
|
|
684
|
-
| `persistKey` | input | `string` | `''` |
|
|
758
|
+
| `remoteSort` | input | `boolean` | `false` | |
|
|
759
|
+
| `itemsLabel` | input | `string` | `''` | |
|
|
760
|
+
| `pageSizeLabel` | input | `string` | `''` | |
|
|
761
|
+
| `exportable` | input | `boolean` | `false` | |
|
|
762
|
+
| `exportFileName` | input | `string` | `''` | |
|
|
763
|
+
| `groupBy` | model | `string \| null` | `null` | |
|
|
764
|
+
| `aggregates` | input | `GridAggregates` | `{}` | |
|
|
765
|
+
| `aggregateFormatter` | input | `GridAggregateFormatter \| null` | `null` | |
|
|
766
|
+
| `persistKey` | input | `string` | `''` | |
|
|
685
767
|
| `persistStorage` | input | `DataGridPersistStorage` | `'local'` | |
|
|
686
|
-
| `advancedFilter` | input | `boolean` | `false` |
|
|
768
|
+
| `advancedFilter` | input | `boolean` | `false` | |
|
|
687
769
|
| `filterQuery` | model | `GridFilterQuery` | `EMPTY_GRID_QUERY` | |
|
|
688
|
-
| `columnManager` | input | `boolean` | `false` |
|
|
689
|
-
| `columnOrder` | model | `readonly string[]` | `[]` |
|
|
690
|
-
| `detailPaneToggled` | output | `{ row: T; open: boolean }` | |
|
|
770
|
+
| `columnManager` | input | `boolean` | `false` | |
|
|
771
|
+
| `columnOrder` | model | `readonly string[]` | `[]` | |
|
|
772
|
+
| `detailPaneToggled` | output | `{ row: T; open: boolean }` | | |
|
|
691
773
|
|
|
692
774
|
## `hm-calendar`
|
|
693
775
|
|
|
@@ -723,10 +805,10 @@ Campo de data — o `hermes-date-container` + `hermesDate` do hermes-ui antigo,
|
|
|
723
805
|
| `min` | input | `IsoDate \| null` | `null` | |
|
|
724
806
|
| `max` | input | `IsoDate \| null` | `null` | |
|
|
725
807
|
| `valueFormat` | input | `DateValueFormat` | `'iso'` | Formato do valor gravado no controle/`value`: `'iso'` (AAAA-MM-DD, padrão) ou `'dd/mm/yyyy'` (formulário que já guardava a data como texto brasileiro). A LEITU… |
|
|
726
|
-
| `disabled` | input (herdado) | `boolean` | `false` |
|
|
727
|
-
| `required` | input (herdado) | `boolean` | `false` |
|
|
728
|
-
| `error` | input (herdado) | `string` | `''` | Erro definido
|
|
729
|
-
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro
|
|
808
|
+
| `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
|
|
809
|
+
| `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
|
|
810
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
|
|
811
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
|
|
730
812
|
|
|
731
813
|
## `hm-date-range-picker`
|
|
732
814
|
|
|
@@ -748,10 +830,10 @@ Intervalo de datas num campo só — o `hermesStartDate`/`hermesEndDate` do herm
|
|
|
748
830
|
| `max` | input | `IsoDate \| null` | `null` | |
|
|
749
831
|
| `valueFormat` | input | `DateValueFormat` | `'iso'` | Formato das duas pontas: `'iso'` (AAAA-MM-DD, padrão) ou `'dd/mm/yyyy'`. A LEITURA aceita os dois (e ISO com hora) em qualquer caso — um formato inesperado não… |
|
|
750
832
|
| `presets` | input | `readonly DateRangePresetOption[]` | `[]` | Atalhos de intervalo ao lado do calendário (ver acima). Vazio = sem lista. |
|
|
751
|
-
| `disabled` | input (herdado) | `boolean` | `false` |
|
|
752
|
-
| `required` | input (herdado) | `boolean` | `false` |
|
|
753
|
-
| `error` | input (herdado) | `string` | `''` | Erro definido
|
|
754
|
-
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro
|
|
833
|
+
| `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
|
|
834
|
+
| `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
|
|
835
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
|
|
836
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
|
|
755
837
|
|
|
756
838
|
## `hm-description-item`
|
|
757
839
|
|
|
@@ -890,21 +972,21 @@ Métodos públicos: `register(item: HermesDragItemRef): void`, `unregister(item:
|
|
|
890
972
|
|
|
891
973
|
`DrawerComponent` — import de `@trismegisto/angular/drawer` (também na raiz)
|
|
892
974
|
|
|
893
|
-
Painel que desliza
|
|
975
|
+
Painel que desliza de uma borda da tela, para conteúdo que não cabe bem num modal sem que a tela de origem desapareça por completo (detalhe de um registro, formulário longo, filtros).
|
|
894
976
|
|
|
895
977
|
Slots: `(padrão)`, `[footer]`
|
|
896
978
|
|
|
897
979
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
898
980
|
|---|---|---|---|---|
|
|
899
|
-
| `open` | model (obrigatório) | `boolean` | |
|
|
900
|
-
| `heading` | input (obrigatório) | `string` | | Título do
|
|
901
|
-
| `size` | input | `ModalSize` | `'medium'` | Largura (
|
|
902
|
-
| `position` | input | `DrawerPosition` | `'end'` | Borda de
|
|
903
|
-
| `pinned` | input | `boolean` | `false` | Fixa o painel no layout
|
|
904
|
-
| `closeLabel` | input | `string` | `''` |
|
|
905
|
-
| `closable` | input | `boolean` | `true` |
|
|
906
|
-
| `beforeClose` | input | `(() => boolean \| Promise<boolean>) \| null` | `null` | Guarda
|
|
907
|
-
| `closed` | output | `void` | |
|
|
981
|
+
| `open` | model (obrigatório) | `boolean` | | Aberto ou fechado, em mão dupla (`[(open)]`); o X e o `Esc` gravam `false` sozinhos. |
|
|
982
|
+
| `heading` | input (obrigatório) | `string` | | Título do cabeçalho e nome acessível do painel (do diálogo ou, fixado, da região). |
|
|
983
|
+
| `size` | input | `ModalSize` | `'medium'` | Largura (painel lateral) ou altura máxima (folha inferior), com os mesmos valores do `hm-modal`: `small`, `medium` (padrão), `large`, `xlarge` e `full`. `full`… |
|
|
984
|
+
| `position` | input | `DrawerPosition` | `'end'` | Borda de entrada; ver `DrawerPosition`. |
|
|
985
|
+
| `pinned` | input | `boolean` | `false` | Fixa o painel no layout: deixa de ser sobreposição e passa a dividir o espaço com a página, sem véu nem bloqueio. Vira uma região complementar nomeada pelo tít… |
|
|
986
|
+
| `closeLabel` | input | `string` | `''` | Nome acessível do X. Vazio usa `drawer.close` do catálogo. |
|
|
987
|
+
| `closable` | input | `boolean` | `true` | `false` tira o X e ignora o `Esc`. |
|
|
988
|
+
| `beforeClose` | input | `(() => boolean \| Promise<boolean>) \| null` | `null` | Guarda consultada quando a pessoa tenta sair pelo X ou pelo `Esc`, igual à do `hm-modal`: `false` (ou Promise com `false`) mantém aberto. Não é chamada quando… |
|
|
989
|
+
| `closed` | output | `void` | | Emitido depois que a pessoa fechou pelo X ou pelo `Esc`. |
|
|
908
990
|
|
|
909
991
|
## `hm-dropdown`
|
|
910
992
|
|
|
@@ -978,10 +1060,10 @@ Métodos públicos: `moveMarked(from: DualListSide): void`, `moveAll(from: DualL
|
|
|
978
1060
|
| `searchable` | input | `boolean` | `true` | Mostra a busca em cada lado. |
|
|
979
1061
|
| `size` | input | `DualListSize` | `'medium'` | |
|
|
980
1062
|
| `loading` | input | `boolean` | `false` | |
|
|
981
|
-
| `disabled` | input (herdado) | `boolean` | `false` |
|
|
982
|
-
| `required` | input (herdado) | `boolean` | `false` |
|
|
983
|
-
| `error` | input (herdado) | `string` | `''` | Erro definido
|
|
984
|
-
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro
|
|
1063
|
+
| `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
|
|
1064
|
+
| `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
|
|
1065
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
|
|
1066
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
|
|
985
1067
|
|
|
986
1068
|
## `hm-empty`
|
|
987
1069
|
|
|
@@ -1037,7 +1119,7 @@ Botão de ação flutuante, com o que faltava para ser componente de biblioteca:
|
|
|
1037
1119
|
| `fixed` | input | `boolean` | `true` | `false` deixa o botão no fluxo do documento (quem monta decide onde). |
|
|
1038
1120
|
| `size` | input | `FabSize` | `'medium'` | |
|
|
1039
1121
|
| `disabled` | input | `boolean` | `false` | |
|
|
1040
|
-
| `highlight` | input | `boolean` | `false` |
|
|
1122
|
+
| `highlight` | input | `boolean` | `false` | Contorna o botão com um anel estático de destaque (sem animação). |
|
|
1041
1123
|
| `actions` | input | `readonly FabAction[]` | `[]` | Ações do speed dial; vazio, o botão age sozinho (`triggered`). |
|
|
1042
1124
|
| `hideOnScroll` | input | `boolean` | `false` | Esconde ao rolar para baixo e volta ao rolar para cima. |
|
|
1043
1125
|
| `avoid` | input | `string \| HTMLElement \| null` | `'footer, [role="contentinfo"]'` | Seletor (ou elemento) que o botão não pode cobrir; `''` desliga. |
|
|
@@ -1061,7 +1143,7 @@ Slots: `[hmPrefix]`, `[hmSuffix]`
|
|
|
1061
1143
|
| `type` | input (herdado) | `InputType` | `'text'` | |
|
|
1062
1144
|
| `placeholder` | input (herdado) | `string` | `''` | |
|
|
1063
1145
|
| `icon` | input (herdado) | `string` | `''` | Ícone decorativo no fim do campo. |
|
|
1064
|
-
| `labelHidden` | input (herdado) | `boolean` | `false` |
|
|
1146
|
+
| `labelHidden` | input (herdado) | `boolean` | `false` | Rótulo só para tecnologia assistiva (fica visualmente oculto, mas segue como nome acessível). |
|
|
1065
1147
|
| `hint` | input (herdado) | `string` | `''` | Texto de apoio embaixo do campo (formato esperado, efeito automático...). |
|
|
1066
1148
|
| `prefix` | input (herdado) | `string` | `''` | Texto antes do valor ("R$"). Anunciado como descrição do campo. |
|
|
1067
1149
|
| `suffix` | input (herdado) | `string` | `''` | Texto depois do valor ("kg"). Anunciado como descrição do campo. |
|
|
@@ -1075,42 +1157,42 @@ Slots: `[hmPrefix]`, `[hmSuffix]`
|
|
|
1075
1157
|
| `maxLength` | input (herdado) | `number \| null, unknown` | `null` | Limite de caracteres, com contador visível. Ignorado com `mask`. |
|
|
1076
1158
|
| `autocomplete` | input (herdado) | `string` | `''` | |
|
|
1077
1159
|
| `inputMode` | input (herdado) | `InputMode \| ''` | `''` | Sobrescreve o `inputmode` derivado do tipo/máscara. |
|
|
1078
|
-
| `disabled` | input (herdado) | `boolean` | `false` |
|
|
1079
|
-
| `required` | input (herdado) | `boolean` | `false` |
|
|
1080
|
-
| `error` | input (herdado) | `string` | `''` | Erro definido
|
|
1081
|
-
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro
|
|
1160
|
+
| `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
|
|
1161
|
+
| `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
|
|
1162
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
|
|
1163
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
|
|
1082
1164
|
|
|
1083
1165
|
## `hm-file-upload`
|
|
1084
1166
|
|
|
1085
1167
|
`FileUploadComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/file-upload` (também na raiz)
|
|
1086
1168
|
|
|
1087
|
-
|
|
1169
|
+
Campo de envio de arquivos: um `<input type="file">` nativo (o caminho por teclado e leitor de tela) dentro de uma área onde também se pode soltar arquivos arrastados, mais a lista do que foi escolhido com situação, progresso, remover e tentar de novo.
|
|
1088
1170
|
|
|
1089
1171
|
Métodos públicos: `addFiles(list: readonly File[]): UploadFile[]`, `update(id: string, patch: UploadFilePatch): void`, `remove(id: string): void`, `retry(id: string): void`
|
|
1090
1172
|
|
|
1091
1173
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1092
1174
|
|---|---|---|---|---|
|
|
1093
|
-
| `files` | model | `readonly UploadFile[]` | `[]` |
|
|
1175
|
+
| `files` | model | `readonly UploadFile[]` | `[]` | |
|
|
1094
1176
|
| `label` | input (obrigatório) | `string` | | |
|
|
1095
|
-
| `labelHidden` | input | `boolean` | `false` |
|
|
1096
|
-
| `hint` | input | `string` | `''` |
|
|
1097
|
-
| `accept` | input | `string` | `''` |
|
|
1098
|
-
| `multiple` | input | `boolean` | `false` |
|
|
1099
|
-
| `maxFiles` | input | `number` | `0` |
|
|
1100
|
-
| `maxSize` | input | `number` | `0` |
|
|
1101
|
-
| `maxTotalSize` | input | `number` | `0` |
|
|
1102
|
-
| `size` | input | `FileUploadSize` | `'medium'` |
|
|
1177
|
+
| `labelHidden` | input | `boolean` | `false` | |
|
|
1178
|
+
| `hint` | input | `string` | `''` | |
|
|
1179
|
+
| `accept` | input | `string` | `''` | Formatos aceitos, como no atributo nativo (`'.pdf,image/*'`). |
|
|
1180
|
+
| `multiple` | input | `boolean` | `false` | |
|
|
1181
|
+
| `maxFiles` | input | `number` | `0` | Quantidade máxima de arquivos (com `multiple`); 0 = sem limite. |
|
|
1182
|
+
| `maxSize` | input | `number` | `0` | Bytes por arquivo; 0 = sem limite. |
|
|
1183
|
+
| `maxTotalSize` | input | `number` | `0` | Bytes somando a lista inteira; 0 = sem limite. |
|
|
1184
|
+
| `size` | input | `FileUploadSize` | `'medium'` | |
|
|
1103
1185
|
| `loading` | input | `boolean` | `false` | |
|
|
1104
|
-
| `browseLabel` | input | `string` | `''` | Texto do botão
|
|
1105
|
-
| `uploader` | input | `FileUploader \| null` | `null` |
|
|
1106
|
-
| `added` | output | `UploadFile[]` | | Arquivos que
|
|
1107
|
-
| `rejected` | output | `FileRejection[]` | | Arquivos recusados, com o motivo
|
|
1108
|
-
| `removed` | output | `UploadFile` | |
|
|
1109
|
-
| `retried` | output | `UploadFile` | |
|
|
1110
|
-
| `disabled` | input (herdado) | `boolean` | `false` |
|
|
1111
|
-
| `required` | input (herdado) | `boolean` | `false` |
|
|
1112
|
-
| `error` | input (herdado) | `string` | `''` | Erro definido
|
|
1113
|
-
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro
|
|
1186
|
+
| `browseLabel` | input | `string` | `''` | Texto do botão de escolher; vazio usa o do catálogo. |
|
|
1187
|
+
| `uploader` | input | `FileUploader \| null` | `null` | Com ele, cada arquivo aceito é enviado pelo próprio campo. |
|
|
1188
|
+
| `added` | output | `UploadFile[]` | | Arquivos que entraram na lista nesta seleção. |
|
|
1189
|
+
| `rejected` | output | `FileRejection[]` | | Arquivos recusados nesta seleção, com o motivo. |
|
|
1190
|
+
| `removed` | output | `UploadFile` | | |
|
|
1191
|
+
| `retried` | output | `UploadFile` | | "Tentar de novo" sem `uploader`: o item voltou para a fila e o app reenvia. |
|
|
1192
|
+
| `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
|
|
1193
|
+
| `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
|
|
1194
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
|
|
1195
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
|
|
1114
1196
|
|
|
1115
1197
|
## `hm-filter-bar`
|
|
1116
1198
|
|
|
@@ -1180,12 +1262,12 @@ Legenda de obrigatório do formulário ("Campos marcados com “obrigatório”
|
|
|
1180
1262
|
|
|
1181
1263
|
`GeometricTextureComponent` — import de `@trismegisto/angular/geometric-texture` (também na raiz)
|
|
1182
1264
|
|
|
1183
|
-
Malha
|
|
1265
|
+
Malha de greca decorativa que se traça sozinha, fica, some e recomeça (ciclo longo, calmo). Cobre a caixa do contêiner posicionado mais próximo, atrás do conteúdo dele.
|
|
1184
1266
|
|
|
1185
1267
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1186
1268
|
|---|---|---|---|---|
|
|
1187
|
-
| `columns` | input | `number` | `6` |
|
|
1188
|
-
| `rows` | input | `number` | `5` |
|
|
1269
|
+
| `columns` | input | `number` | `6` | Ladrilhos na largura. |
|
|
1270
|
+
| `rows` | input | `number` | `5` | Ladrilhos na altura. |
|
|
1189
1271
|
|
|
1190
1272
|
## `hm-global-search`
|
|
1191
1273
|
|
|
@@ -1208,34 +1290,35 @@ Busca global: o mesmo contêiner da `hm-command-palette` (diálogo ancorado no a
|
|
|
1208
1290
|
|
|
1209
1291
|
`HeaderComponent` — import de `@trismegisto/angular/header` (também na raiz)
|
|
1210
1292
|
|
|
1211
|
-
Faixa
|
|
1293
|
+
Faixa superior do shell: gatilho do menu lateral (só no celular), marca, atalhos de módulo, gatilho da busca global e ações. O componente não busca nada — só avisa, por `searchRequested`, que a pessoa pediu a busca (clique no gatilho ou Ctrl/⌘+K em qualquer ponto da página).
|
|
1212
1294
|
|
|
1213
|
-
Slots: `(padrão)`, `[shortcuts]
|
|
1295
|
+
Slots: `(padrão)`, `[shortcuts]`, `[actions]`
|
|
1214
1296
|
|
|
1215
1297
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1216
1298
|
|---|---|---|---|---|
|
|
1217
|
-
| `searchRequested` | output | `void` | |
|
|
1218
|
-
| `searchPlaceholder` | input |
|
|
1219
|
-
| `searchLabel` | input |
|
|
1299
|
+
| `searchRequested` | output | `void` | | A pessoa pediu a busca global; quem consome decide como abri-la. |
|
|
1300
|
+
| `searchPlaceholder` | input | `string` | `this.#messages.search` | Texto visível dentro do gatilho da busca. |
|
|
1301
|
+
| `searchLabel` | input | `string` | `this.#messages.searchLabel` | Nome acessível do gatilho da busca (não há rótulo visível). |
|
|
1220
1302
|
|
|
1221
1303
|
## `hm-icon-button`
|
|
1222
1304
|
|
|
1223
1305
|
`IconButtonComponent` — import de `@trismegisto/angular/icon-button` (também na raiz)
|
|
1224
1306
|
|
|
1225
|
-
Botão
|
|
1307
|
+
Botão só com ícone. O `label` é obrigatório: vira o nome acessível do `<button>` (não há texto visível). Em modo `toggle` o nome não muda entre os estados — quem diz o estado é `aria-pressed`.
|
|
1226
1308
|
|
|
1227
1309
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1228
1310
|
|---|---|---|---|---|
|
|
1229
1311
|
| `label` | input (obrigatório) | `string` | | |
|
|
1230
1312
|
| `icon` | input (obrigatório) | `string` | | |
|
|
1231
|
-
| `solid` | input | `boolean` | `false` | Variante preenchida do
|
|
1232
|
-
| `iconDirection` | input | `string` | `''` | Direção
|
|
1313
|
+
| `solid` | input | `boolean` | `false` | Variante preenchida do desenho, quando o ícone tem. |
|
|
1314
|
+
| `iconDirection` | input | `string` | `''` | Direção, para os ícones direcionais (`angle`, `arrow`). |
|
|
1233
1315
|
| `emphasis` | input | `IconButtonEmphasis` | `'outlined'` | |
|
|
1234
1316
|
| `intent` | input | `ButtonIntent` | `'primary'` | |
|
|
1235
1317
|
| `size` | input | `ButtonSize` | `'medium'` | |
|
|
1236
1318
|
| `disabled` | input | `boolean` | `false` | |
|
|
1237
|
-
| `toggle` | input | `boolean` | `false` |
|
|
1238
|
-
| `pressed` | model | `boolean` | `false` |
|
|
1319
|
+
| `toggle` | input | `boolean` | `false` | |
|
|
1320
|
+
| `pressed` | model | `boolean` | `false` | |
|
|
1321
|
+
| `keyShortcuts` | input | `string` | `''` | Atalho que aciona o botão, na forma ARIA (`aria-keyshortcuts`: `'Control+B'`, `'Meta+B'`). |
|
|
1239
1322
|
| `clicked` | output | `void` | | |
|
|
1240
1323
|
|
|
1241
1324
|
## `hm-icon`
|
|
@@ -1260,7 +1343,7 @@ Botão cuja única marca visível é o ícone. Aqui `label` é obrigatório porq
|
|
|
1260
1343
|
|
|
1261
1344
|
`IllustrationAttentionComponent` — import de `@trismegisto/angular/illustration-attention`
|
|
1262
1345
|
|
|
1263
|
-
Ilustração
|
|
1346
|
+
Ilustração decorativa da situação "atenção" (algo pede cuidado antes de seguir). O SVG já vem com `aria-hidden`; a mensagem fica com o texto em volta (normalmente o `hm-state-screen`).
|
|
1264
1347
|
|
|
1265
1348
|
_Sem inputs/outputs._
|
|
1266
1349
|
|
|
@@ -1268,7 +1351,7 @@ _Sem inputs/outputs._
|
|
|
1268
1351
|
|
|
1269
1352
|
`IllustrationErrorComponent` — import de `@trismegisto/angular/illustration-error`
|
|
1270
1353
|
|
|
1271
|
-
Ilustração
|
|
1354
|
+
Ilustração decorativa da situação "erro" (a ação não pôde ser concluída). O SVG já vem com `aria-hidden`; a mensagem fica com o texto em volta (normalmente o `hm-state-screen`).
|
|
1272
1355
|
|
|
1273
1356
|
_Sem inputs/outputs._
|
|
1274
1357
|
|
|
@@ -1276,7 +1359,7 @@ _Sem inputs/outputs._
|
|
|
1276
1359
|
|
|
1277
1360
|
`IllustrationJourneyEndComponent` — import de `@trismegisto/angular/illustration-journey-end`
|
|
1278
1361
|
|
|
1279
|
-
Ilustração
|
|
1362
|
+
Ilustração decorativa da situação "fim de jornada" (não há mais nada a fazer por aqui). O SVG já vem com `aria-hidden`; a mensagem fica com o texto em volta (normalmente o `hm-state-screen`).
|
|
1280
1363
|
|
|
1281
1364
|
_Sem inputs/outputs._
|
|
1282
1365
|
|
|
@@ -1284,7 +1367,7 @@ _Sem inputs/outputs._
|
|
|
1284
1367
|
|
|
1285
1368
|
`IllustrationLockedComponent` — import de `@trismegisto/angular/illustration-locked`
|
|
1286
1369
|
|
|
1287
|
-
Ilustração
|
|
1370
|
+
Ilustração decorativa da situação "bloqueado" (o recurso está trancado). O SVG já vem com `aria-hidden`; a mensagem fica com o texto em volta (normalmente o `hm-state-screen`).
|
|
1288
1371
|
|
|
1289
1372
|
_Sem inputs/outputs._
|
|
1290
1373
|
|
|
@@ -1292,7 +1375,7 @@ _Sem inputs/outputs._
|
|
|
1292
1375
|
|
|
1293
1376
|
`IllustrationNoPermissionComponent` — import de `@trismegisto/angular/illustration-no-permission`
|
|
1294
1377
|
|
|
1295
|
-
Ilustração
|
|
1378
|
+
Ilustração decorativa da situação "sem permissão" (a conta não tem acesso a esta área). O SVG já vem com `aria-hidden`; a mensagem fica com o texto em volta (normalmente o `hm-state-screen`).
|
|
1296
1379
|
|
|
1297
1380
|
_Sem inputs/outputs._
|
|
1298
1381
|
|
|
@@ -1300,7 +1383,7 @@ _Sem inputs/outputs._
|
|
|
1300
1383
|
|
|
1301
1384
|
`IllustrationNoResultsComponent` — import de `@trismegisto/angular/illustration-no-results`
|
|
1302
1385
|
|
|
1303
|
-
Ilustração
|
|
1386
|
+
Ilustração decorativa da situação "sem resultados" (a busca ou o filtro não encontrou nada). O SVG já vem com `aria-hidden`; a mensagem fica com o texto em volta (normalmente o `hm-state-screen`).
|
|
1304
1387
|
|
|
1305
1388
|
_Sem inputs/outputs._
|
|
1306
1389
|
|
|
@@ -1308,7 +1391,7 @@ _Sem inputs/outputs._
|
|
|
1308
1391
|
|
|
1309
1392
|
`IllustrationNotFoundComponent` — import de `@trismegisto/angular/illustration-not-found`
|
|
1310
1393
|
|
|
1311
|
-
Ilustração
|
|
1394
|
+
Ilustração decorativa da situação "não encontrado" (o endereço não leva a lugar nenhum). O SVG já vem com `aria-hidden`; a mensagem fica com o texto em volta (normalmente o `hm-state-screen`).
|
|
1312
1395
|
|
|
1313
1396
|
_Sem inputs/outputs._
|
|
1314
1397
|
|
|
@@ -1316,7 +1399,7 @@ _Sem inputs/outputs._
|
|
|
1316
1399
|
|
|
1317
1400
|
`IllustrationSessionExpiredComponent` — import de `@trismegisto/angular/illustration-session-expired`
|
|
1318
1401
|
|
|
1319
|
-
Ilustração
|
|
1402
|
+
Ilustração decorativa da situação "sessão expirada" (é preciso entrar de novo). O SVG já vem com `aria-hidden`; a mensagem fica com o texto em volta (normalmente o `hm-state-screen`).
|
|
1320
1403
|
|
|
1321
1404
|
_Sem inputs/outputs._
|
|
1322
1405
|
|
|
@@ -1324,7 +1407,7 @@ _Sem inputs/outputs._
|
|
|
1324
1407
|
|
|
1325
1408
|
`IllustrationSuccessComponent` — import de `@trismegisto/angular/illustration-success`
|
|
1326
1409
|
|
|
1327
|
-
Ilustração
|
|
1410
|
+
Ilustração decorativa da situação "sucesso" (a ação terminou bem). O SVG já vem com `aria-hidden`; a mensagem fica com o texto em volta (normalmente o `hm-state-screen`).
|
|
1328
1411
|
|
|
1329
1412
|
_Sem inputs/outputs._
|
|
1330
1413
|
|
|
@@ -1332,10 +1415,52 @@ _Sem inputs/outputs._
|
|
|
1332
1415
|
|
|
1333
1416
|
`IllustrationUnlockedComponent` — import de `@trismegisto/angular/illustration-unlocked`
|
|
1334
1417
|
|
|
1335
|
-
Ilustração
|
|
1418
|
+
Ilustração decorativa da situação "desbloqueado" (o acesso foi liberado). O SVG já vem com `aria-hidden`; a mensagem fica com o texto em volta (normalmente o `hm-state-screen`).
|
|
1336
1419
|
|
|
1337
1420
|
_Sem inputs/outputs._
|
|
1338
1421
|
|
|
1422
|
+
## `hm-image-crop`
|
|
1423
|
+
|
|
1424
|
+
`ImageCropComponent` — import de `@trismegisto/angular/image-crop` (também na raiz)
|
|
1425
|
+
|
|
1426
|
+
Recorte de imagem: mostra a imagem inteira com uma área de recorte móvel e redimensionável por cima, com proporção fixa opcional, recorte redondo, zoom da vista e giro em quartos de volta, e gera a imagem recortada (`exportImage()`) como `Blob` PNG/JPEG/WebP.
|
|
1427
|
+
|
|
1428
|
+
Slots: `[hmImageCropEmpty]`
|
|
1429
|
+
|
|
1430
|
+
Métodos públicos: `exportImage(options: ImageCropExportOptions = {}): Promise<ImageCropResult>`, `reset(): void`, `rotateBy(quarterTurns: number): void`, `focusRegion(): void`
|
|
1431
|
+
|
|
1432
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1433
|
+
|---|---|---|---|---|
|
|
1434
|
+
| `src` | input | `ImageCropSource` | `null` | Imagem a recortar; `null`/vazio limpa (estado vazio). |
|
|
1435
|
+
| `label` | input (obrigatório) | `string` | | Nome acessível do componente e da área de recorte ("Foto de perfil"). |
|
|
1436
|
+
| `alt` | input | `string` | `''` | Descrição da imagem; vazio → `alt=""` (o `label` já dá o contexto). |
|
|
1437
|
+
| `ratio` | input | `number \| null` | `null` | Largura ÷ altura fixa (`16 / 9`); `null` = livre. |
|
|
1438
|
+
| `shape` | input | `ImageCropShape` | `'rect'` | `round` mostra a máscara elíptica (sem `ratio`, vira círculo). |
|
|
1439
|
+
| `minWidth` | input | `number` | `0` | Mínimos da área, em pixels da imagem. |
|
|
1440
|
+
| `minHeight` | input | `number` | `0` | |
|
|
1441
|
+
| `accept` | input | `readonly ImageCropType[]` | `IMAGE_CROP_TYPES` | Formatos de entrada aceitos (reconhecidos pelos bytes). |
|
|
1442
|
+
| `maxSize` | input | `number` | `0` | Bytes máximos da entrada; 0 = sem limite. |
|
|
1443
|
+
| `maxPixels` | input | `number` | `50_000_000` | Largura × altura máxima da imagem decodificada. |
|
|
1444
|
+
| `credentials` | input | `'omit' \| 'same-origin' \| 'include'` | `'same-origin'` | Cookies ao baixar `src` por endereço. |
|
|
1445
|
+
| `maxZoom` | input | `number` | `4` | Zoom máximo da vista (mínimo efetivo 1). |
|
|
1446
|
+
| `controls` | input | `boolean` | `true` | Barra de ajustes (zoom, girar, restaurar). |
|
|
1447
|
+
| `fields` | input | `boolean` | `true` | Campos numéricos X, Y, largura e altura — a alternativa sem arrasto para redimensionar (WCAG 2.5.7). |
|
|
1448
|
+
| `guides` | input | `boolean` | `true` | Linhas dos terços durante o arrasto. |
|
|
1449
|
+
| `exportType` | input | `ImageCropOutputType` | `'image/png'` | |
|
|
1450
|
+
| `exportQuality` | input | `number` | `0.9` | 0–1, para JPEG/WebP. |
|
|
1451
|
+
| `exportMaxWidth` | input | `number` | `0` | Largura/altura máxima da saída (reduz mantendo a proporção); 0 = sem limite. |
|
|
1452
|
+
| `exportMaxHeight` | input | `number` | `0` | |
|
|
1453
|
+
| `exportFill` | input | `string` | `'#ffffff'` | Cor que substitui a transparência no JPEG (e o fundo fora da elipse no JPEG redondo). |
|
|
1454
|
+
| `exportMask` | input | `boolean` | `true` | Com a forma `round`: fora da elipse fica transparente (PNG/WebP) ou `exportFill` (JPEG). |
|
|
1455
|
+
| `liveExport` | input | `boolean` | `false` | Gera a imagem ao fim de cada ajuste e emite `exported`. |
|
|
1456
|
+
| `disabled` | input | `boolean` | `false` | |
|
|
1457
|
+
| `region` | model | `ImageCropRegion \| null` | `null` | Área atual em pixels inteiros da imagem orientada e girada; `null` sem imagem. |
|
|
1458
|
+
| `zoom` | model | `number` | `1` | Fator da vista, 1…`maxZoom`. |
|
|
1459
|
+
| `rotation` | model | `ImageCropRotation` | `0` | Giro horário em quartos de volta. |
|
|
1460
|
+
| `loaded` | output | `ImageCropInfo` | | Imagem decodificada e área inicial definida. |
|
|
1461
|
+
| `failed` | output | `ImageCropError` | | Falha ao carregar (só da carga mais recente). |
|
|
1462
|
+
| `exported` | output | `ImageCropResult` | | Com `liveExport`: resultado da última geração automática. |
|
|
1463
|
+
|
|
1339
1464
|
## `hm-input`
|
|
1340
1465
|
|
|
1341
1466
|
`InputComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/input` (também na raiz)
|
|
@@ -1351,7 +1476,7 @@ Slots: `[hmPrefix]`, `[hmSuffix]`
|
|
|
1351
1476
|
| `type` | input | `InputType` | `'text'` | |
|
|
1352
1477
|
| `placeholder` | input | `string` | `''` | |
|
|
1353
1478
|
| `icon` | input | `string` | `''` | Ícone decorativo no fim do campo. |
|
|
1354
|
-
| `labelHidden` | input | `boolean` | `false` |
|
|
1479
|
+
| `labelHidden` | input | `boolean` | `false` | Rótulo só para tecnologia assistiva (fica visualmente oculto, mas segue como nome acessível). |
|
|
1355
1480
|
| `hint` | input | `string` | `''` | Texto de apoio embaixo do campo (formato esperado, efeito automático...). |
|
|
1356
1481
|
| `prefix` | input | `string` | `''` | Texto antes do valor ("R$"). Anunciado como descrição do campo. |
|
|
1357
1482
|
| `suffix` | input | `string` | `''` | Texto depois do valor ("kg"). Anunciado como descrição do campo. |
|
|
@@ -1365,10 +1490,10 @@ Slots: `[hmPrefix]`, `[hmSuffix]`
|
|
|
1365
1490
|
| `maxLength` | input | `number \| null, unknown` | `null` | Limite de caracteres, com contador visível. Ignorado com `mask`. |
|
|
1366
1491
|
| `autocomplete` | input | `string` | `''` | |
|
|
1367
1492
|
| `inputMode` | input | `InputMode \| ''` | `''` | Sobrescreve o `inputmode` derivado do tipo/máscara. |
|
|
1368
|
-
| `disabled` | input (herdado) | `boolean` | `false` |
|
|
1369
|
-
| `required` | input (herdado) | `boolean` | `false` |
|
|
1370
|
-
| `error` | input (herdado) | `string` | `''` | Erro definido
|
|
1371
|
-
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro
|
|
1493
|
+
| `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
|
|
1494
|
+
| `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
|
|
1495
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
|
|
1496
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
|
|
1372
1497
|
|
|
1373
1498
|
## `hm-item-group`
|
|
1374
1499
|
|
|
@@ -1457,14 +1582,14 @@ Métodos públicos: `cardTemplate(): TemplateRef<KanbanCardContext<T>> \| null`,
|
|
|
1457
1582
|
|
|
1458
1583
|
`LegendComponent` — import de `@trismegisto/angular/legend` (também na raiz)
|
|
1459
1584
|
|
|
1460
|
-
Legenda
|
|
1585
|
+
Legenda: o que cada cor quer dizer, em texto. Lista nomeada; o marcador é só decoração (o rótulo carrega o significado — WCAG 1.4.1).
|
|
1461
1586
|
|
|
1462
1587
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1463
1588
|
|---|---|---|---|---|
|
|
1464
1589
|
| `items` | input | `readonly LegendItem[]` | `[]` | |
|
|
1465
|
-
| `orientation` | input | `LegendOrientation` | `'vertical'` |
|
|
1466
|
-
| `marker` | input | `LegendMarker` | `'dot'` |
|
|
1467
|
-
| `label` | input | `string` | `''` | Nome
|
|
1590
|
+
| `orientation` | input | `LegendOrientation` | `'vertical'` | |
|
|
1591
|
+
| `marker` | input | `LegendMarker` | `'dot'` | |
|
|
1592
|
+
| `label` | input | `string` | `''` | Nome da lista para leitor de tela; vazio usa o texto do catálogo ("Legenda"). |
|
|
1468
1593
|
|
|
1469
1594
|
## `hm-loading-square`
|
|
1470
1595
|
|
|
@@ -1478,24 +1603,25 @@ _Sem inputs/outputs._
|
|
|
1478
1603
|
|
|
1479
1604
|
`MenuButtonComponent` — import de `@trismegisto/angular/menu-button` (também na raiz)
|
|
1480
1605
|
|
|
1481
|
-
Botão
|
|
1606
|
+
Botão que abre um `hm-menu` preso a ele (APG *Menu Button*): `aria-haspopup="menu"` e `aria-expanded` no gatilho, foco no primeiro item ao abrir (`↓`/`↑` no gatilho abrem no primeiro ou no último) e, ao fechar por qualquer caminho, foco de volta no gatilho.
|
|
1482
1607
|
|
|
1483
1608
|
Slots: `(padrão)`
|
|
1484
1609
|
|
|
1485
1610
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1486
1611
|
|---|---|---|---|---|
|
|
1487
|
-
| `label` | input (obrigatório) | `string` | | Nome acessível do
|
|
1488
|
-
| `icon` | input | `string` | `''` |
|
|
1612
|
+
| `label` | input (obrigatório) | `string` | | Nome acessível do botão e do menu. |
|
|
1613
|
+
| `icon` | input | `string` | `''` | Ícone antes do conteúdo (vazio = sem ícone). O app registra o ícone que passar aqui. |
|
|
1489
1614
|
| `items` | input (obrigatório) | `readonly MenuItem[]` | | |
|
|
1490
|
-
| `showArrow` | input | `boolean` | `true` |
|
|
1491
|
-
| `align` | input | `PopoverAlign` | `'start'` |
|
|
1492
|
-
| `side` | input | `PopoverSide` | `'bottom'` |
|
|
1615
|
+
| `showArrow` | input | `boolean` | `true` | Seta para baixo depois do conteúdo. |
|
|
1616
|
+
| `align` | input | `PopoverAlign` | `'start'` | Encosto do menu no eixo cruzado (troca sozinho se não couber). |
|
|
1617
|
+
| `side` | input | `PopoverSide` | `'bottom'` | Lado preferido do menu (vira para o oposto se não couber). |
|
|
1493
1618
|
| `size` | input | `MenuButtonSize` | `'medium'` | |
|
|
1494
1619
|
| `shape` | input | `'default' \| 'circle'` | `'default'` | |
|
|
1495
|
-
| `layer` | input | `'default' \| 'above-invoker'` | `'default'` |
|
|
1496
|
-
| `closeOnCheck` | input | `boolean` | `false` |
|
|
1620
|
+
| `layer` | input | `'default' \| 'above-invoker'` | `'default'` | Ver `hm-menu`: `above-invoker` quando o botão está dentro de um overlay. |
|
|
1621
|
+
| `closeOnCheck` | input | `boolean` | `false` | Ver `hm-menu`: fecha ao marcar um item `checkbox`/`radio`. |
|
|
1622
|
+
| `disabled` | input | `boolean` | `false` | Desabilita o botão (o menu não abre). |
|
|
1497
1623
|
| `chosen` | output | `string` | | |
|
|
1498
|
-
| `checkedChange` | output | `MenuItemChange` | |
|
|
1624
|
+
| `checkedChange` | output | `MenuItemChange` | | |
|
|
1499
1625
|
|
|
1500
1626
|
## `[hmContextMenu]`
|
|
1501
1627
|
|
|
@@ -1519,21 +1645,21 @@ Métodos públicos: `openAt(x: number, y: number): boolean`, `close(): void`
|
|
|
1519
1645
|
|
|
1520
1646
|
`MenuComponent` — import de `@trismegisto/angular/menu` (também na raiz)
|
|
1521
1647
|
|
|
1522
|
-
|
|
1648
|
+
Menu de ações ancorado: lista de `MenuItem` (ações, submenus, itens `checkbox`/`radio`) que abre num retângulo (um gatilho — o cartão encosta num lado, com vão e bico) ou num ponto (o cursor — nasce ali, sem bico). Quem abre controla `anchor`: `null` fecha, e o menu só PEDE para fechar por `closed`.
|
|
1523
1649
|
|
|
1524
1650
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1525
1651
|
|---|---|---|---|---|
|
|
1526
|
-
| `anchor` | input (obrigatório) | `PopoverAnchor \| null` | |
|
|
1652
|
+
| `anchor` | input (obrigatório) | `PopoverAnchor \| null` | | Onde abrir, em coordenadas da viewport; `null` = fechado. |
|
|
1527
1653
|
| `items` | input (obrigatório) | `readonly MenuItem[]` | | |
|
|
1528
|
-
| `label` | input (obrigatório) | `string` | |
|
|
1529
|
-
| `layer` | input | `'default' \| 'above-invoker'` | `'default'` | `above-invoker
|
|
1530
|
-
| `closeOnCheck` | input | `boolean` | `false` | Fecha
|
|
1531
|
-
| `initialFocus` | input | `'first' \| 'last'` | `'first'` |
|
|
1532
|
-
| `chosen` | output | `string` | |
|
|
1533
|
-
| `closed` | output | `void` | |
|
|
1534
|
-
| `checkedChange` | output | `MenuItemChange` | | Um item `checkbox`/`radio`
|
|
1535
|
-
| `navigate` | output | `'previous' \| 'next'` | |
|
|
1536
|
-
| `pointerOutside` | output | `MouseEvent` | | Ponteiro
|
|
1654
|
+
| `label` | input (obrigatório) | `string` | | Rótulo acessível do menu (vai para a região e para o `role="menu"`). |
|
|
1655
|
+
| `layer` | input | `'default' \| 'above-invoker'` | `'default'` | `above-invoker` quando quem abre já está num overlay (modal, gaveta): sobe fundo e cartão de camada. |
|
|
1656
|
+
| `closeOnCheck` | input | `boolean` | `false` | Fecha ao marcar um item `checkbox`/`radio` (padrão: continua aberto para marcar outros). |
|
|
1657
|
+
| `initialFocus` | input | `'first' \| 'last'` | `'first'` | Item que recebe o foco ao abrir. |
|
|
1658
|
+
| `chosen` | output | `string` | | Id da ação escolhida (o menu pede para fechar em seguida, por `closed`). |
|
|
1659
|
+
| `closed` | output | `void` | | Pedido de fechamento: Esc, Tab, escolha, clique fora. Quem abre zera `anchor`. |
|
|
1660
|
+
| `checkedChange` | output | `MenuItemChange` | | Um item `checkbox`/`radio` mudou de estado. |
|
|
1661
|
+
| `navigate` | output | `'previous' \| 'next'` | | `←`/`→` sem uso dentro do menu: para quem coloca vários menus lado a lado (`hm-menubar`). |
|
|
1662
|
+
| `pointerOutside` | output | `MouseEvent` | | Ponteiro sobre o fundo (`pointermove` e, antes de `closed`, o `click`). |
|
|
1537
1663
|
|
|
1538
1664
|
## `hm-menubar`
|
|
1539
1665
|
|
|
@@ -1612,47 +1738,47 @@ Slots: `(padrão)`, `[hmMessageActions]`
|
|
|
1612
1738
|
|
|
1613
1739
|
`ModalComponent` — import de `@trismegisto/angular/modal` (também na raiz)
|
|
1614
1740
|
|
|
1615
|
-
|
|
1741
|
+
Janela de diálogo modal. Aberta, deixa a página de trás inerte (sem foco nem rolagem) e prende o `Tab` dentro dela.
|
|
1616
1742
|
|
|
1617
1743
|
Slots: `(padrão)`, `[footer]`
|
|
1618
1744
|
|
|
1619
1745
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1620
1746
|
|---|---|---|---|---|
|
|
1621
|
-
| `open` | model (obrigatório) | `boolean` | |
|
|
1622
|
-
| `heading` | input (obrigatório) | `string` | | Título
|
|
1623
|
-
| `size` | input | `ModalSize` | `'medium'` | Largura: `small
|
|
1624
|
-
| `closeLabel` | input | `string` | `''` | Vazio
|
|
1625
|
-
| `closable` | input | `boolean` | `true` |
|
|
1626
|
-
| `beforeClose` | input | `(() => boolean \| Promise<boolean>) \| null` | `null` | Guarda
|
|
1627
|
-
| `closed` | output | `void` | |
|
|
1747
|
+
| `open` | model (obrigatório) | `boolean` | | Aberto ou fechado, em mão dupla (`[(open)]`). O próprio componente grava `false` quando a pessoa sai pelo X ou pelo `Esc`. |
|
|
1748
|
+
| `heading` | input (obrigatório) | `string` | | Título exibido no cabeçalho; é também o nome do diálogo para leitores de tela. |
|
|
1749
|
+
| `size` | input | `ModalSize` | `'medium'` | Largura da janela: `small`, `medium` (padrão), `large`, `xlarge` ou `full` — este ocupa a tela inteira, sem cantos arredondados, respeitando as áreas seguras d… |
|
|
1750
|
+
| `closeLabel` | input | `string` | `''` | Nome acessível do X. Vazio usa `modal.close` do catálogo, no idioma ativo. |
|
|
1751
|
+
| `closable` | input | `boolean` | `true` | `false` tira o X e ignora o `Esc`: o diálogo só sai pelas ações do rodapé. |
|
|
1752
|
+
| `beforeClose` | input | `(() => boolean \| Promise<boolean>) \| null` | `null` | Guarda chamada quando a pessoa tenta sair pelo X ou pelo `Esc` (ex.: confirmar descarte de alterações). Devolver `false`, ou uma Promise que resolve em `false`… |
|
|
1753
|
+
| `closed` | output | `void` | | Emitido depois que a pessoa fechou pelo X ou pelo `Esc` (já com `open` em `false`). |
|
|
1628
1754
|
|
|
1629
1755
|
## `hm-animated-number`
|
|
1630
1756
|
|
|
1631
1757
|
`AnimatedNumberComponent` — import de `@trismegisto/angular/motion` (também na raiz)
|
|
1632
1758
|
|
|
1633
|
-
|
|
1759
|
+
Exibe um valor numérico animando de `from` até `value`; a animação começa quando o elemento aparece na tela (indicadores de painel, métricas de destaque).
|
|
1634
1760
|
|
|
1635
1761
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1636
1762
|
|---|---|---|---|---|
|
|
1637
|
-
| `value` | input (obrigatório) | `number` | |
|
|
1638
|
-
| `format` | input | `Intl.NumberFormatOptions` | `{}` |
|
|
1639
|
-
| `duration` | input | `number` | `1000` | Duração da contagem em
|
|
1763
|
+
| `value` | input (obrigatório) | `number` | | |
|
|
1764
|
+
| `format` | input | `Intl.NumberFormatOptions` | `{}` | |
|
|
1765
|
+
| `duration` | input | `number` | `1000` | Duração da contagem em ms. |
|
|
1640
1766
|
| `from` | input | `number` | `0` | De onde a primeira contagem parte. |
|
|
1641
1767
|
|
|
1642
1768
|
## `[hmFlip]`
|
|
1643
1769
|
|
|
1644
1770
|
`FlipDirective` — import de `@trismegisto/angular/motion` (também na raiz)
|
|
1645
1771
|
|
|
1646
|
-
Rearranjo animado (técnica FLIP):
|
|
1772
|
+
Rearranjo animado (técnica FLIP): quando a ordem dos itens muda, cada item anima o deslocamento até o lugar novo, sem pulo.
|
|
1647
1773
|
|
|
1648
1774
|
Métodos públicos: `capture(): void`
|
|
1649
1775
|
|
|
1650
1776
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1651
1777
|
|---|---|---|---|---|
|
|
1652
|
-
| `hmFlip` | input | `unknown` | `undefined` |
|
|
1653
|
-
| `hmFlipItems` | input | `string` | `''` | Seletor
|
|
1654
|
-
| `hmFlipDuration` | input | `number \| null` | `null` | Duração em ms
|
|
1655
|
-
| `hmFlipEasing` | input | `string` | `''` | Curva CSS
|
|
1778
|
+
| `hmFlip` | input | `unknown` | `undefined` | Disparo: qualquer valor, trocado a cada reordenação. |
|
|
1779
|
+
| `hmFlipItems` | input | `string` | `''` | Seletor dos itens dentro do elemento. Vazio = filhos diretos. |
|
|
1780
|
+
| `hmFlipDuration` | input | `number \| null` | `null` | Duração em ms. `null` lê `--hm-duration-standard`. |
|
|
1781
|
+
| `hmFlipEasing` | input | `string` | `''` | Curva CSS. Vazio lê `--hm-ease-standard`. |
|
|
1656
1782
|
|
|
1657
1783
|
## `[hmReveal]`
|
|
1658
1784
|
|
|
@@ -1719,61 +1845,46 @@ Métodos públicos: `toggle(key: string): void`, `hoverTrigger(key: string, even
|
|
|
1719
1845
|
| `openDelay` | input | `number` | `NAVIGATION_MENU_OPEN_DELAY` | Espera (ms) com o mouse sobre um botão antes de abrir o painel. |
|
|
1720
1846
|
| `closeDelay` | input | `number` | `HOVER_CLOSE_DELAY` | Espera (ms) depois de o mouse sair da navegação antes de fechar o painel aberto pelo mouse. |
|
|
1721
1847
|
|
|
1722
|
-
## `hm-opening-scene`
|
|
1723
|
-
|
|
1724
|
-
`OpeningSceneComponent` — import de `@trismegisto/angular/opening-scene` (também na raiz)
|
|
1725
|
-
|
|
1726
|
-
Cena de transição entre o login e a área privada: a câmera se aproxima do logotipo do app (projetado como conteúdo: `<hm-opening-scene><img src="logo.svg" alt="" /></hm-opening-scene>`), para diante dele por um instante e o entrega no lugar exato que o logo do cartão de login ocupa. A lib não traz marca própria (marca é do app): sem conteúdo projetado, a cena é só a cortina.
|
|
1727
|
-
|
|
1728
|
-
Slots: `(padrão)`
|
|
1729
|
-
|
|
1730
|
-
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1731
|
-
|---|---|---|---|---|
|
|
1732
|
-
| `label` | input | `string` | `''` | Vazio = texto do catálogo no idioma ativo (`HERMES_MESSAGES.openingScene.entering`). |
|
|
1733
|
-
| `skipLabel` | input | `string` | `''` | Vazio = texto do catálogo no idioma ativo (`HERMES_MESSAGES.openingScene.skip`). |
|
|
1734
|
-
| `targetSelector` | input | `string` | `'[data-hermes-opening-target]'` | Seletor CSS do elemento (a marca do cartão de login) onde a cena pousa. |
|
|
1735
|
-
| `completed` | output | `void` | | A cena acabou (ou foi pulada). Quem escuta decide para onde ir. |
|
|
1736
|
-
|
|
1737
1848
|
## `hm-page-header`
|
|
1738
1849
|
|
|
1739
1850
|
`PageHeaderComponent` — import de `@trismegisto/angular/page-header` (também na raiz)
|
|
1740
1851
|
|
|
1741
|
-
|
|
1852
|
+
Topo de uma página: título no nível certo da hierarquia, trilha de navegação, ações da página (`[actions]`), descrição, um resumo vivo ("7 aguardando envio", anunciado a cada mudança) e metadados (`[meta]`). Com `loading`, título e resumo viram silhuetas e a trilha também carrega.
|
|
1742
1853
|
|
|
1743
1854
|
Slots: `[actions]`, `[meta]`
|
|
1744
1855
|
|
|
1745
1856
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1746
1857
|
|---|---|---|---|---|
|
|
1747
|
-
| `heading` | input (obrigatório) | `string` | |
|
|
1748
|
-
| `level` | input | `PageHeaderLevel` | `1` | Nível do título (`<h1>`…`<h6>`).
|
|
1749
|
-
| `headingId` | input | `string` | `''` | `id` do título, para `aria-labelledby`
|
|
1750
|
-
| `description` | input | `string` | `''` |
|
|
1751
|
-
| `summary` | input | `string` | `''` |
|
|
1752
|
-
| `breadcrumb` | input | `readonly BreadcrumbItem[]` | `[]` |
|
|
1753
|
-
| `breadcrumbLabel` | input | `string` | `''` |
|
|
1754
|
-
| `loading` | input | `boolean` | `false` |
|
|
1755
|
-
| `breadcrumbClick` | output | `BreadcrumbItem` | |
|
|
1858
|
+
| `heading` | input (obrigatório) | `string` | | |
|
|
1859
|
+
| `level` | input | `PageHeaderLevel` | `1` | Nível do título na hierarquia da página (`<h1>`…`<h6>`). |
|
|
1860
|
+
| `headingId` | input | `string` | `''` | `id` do título, para `aria-labelledby` de uma região ou formulário da página. |
|
|
1861
|
+
| `description` | input | `string` | `''` | |
|
|
1862
|
+
| `summary` | input | `string` | `''` | Frase curta que muda com os dados ("7 aguardando envio"); anunciada pelo leitor de tela. |
|
|
1863
|
+
| `breadcrumb` | input | `readonly BreadcrumbItem[]` | `[]` | |
|
|
1864
|
+
| `breadcrumbLabel` | input | `string` | `''` | |
|
|
1865
|
+
| `loading` | input | `boolean` | `false` | |
|
|
1866
|
+
| `breadcrumbClick` | output | `BreadcrumbItem` | | |
|
|
1756
1867
|
|
|
1757
1868
|
## `hm-paginator`
|
|
1758
1869
|
|
|
1759
1870
|
`PaginatorComponent` — import de `@trismegisto/angular/paginator` (também na raiz)
|
|
1760
1871
|
|
|
1761
|
-
|
|
1872
|
+
Controles de paginação. Não guarda página nem fatia lista: cada ação emite o estado novo em `stateChanged` e o componente mostra o `state` que o pai devolver.
|
|
1762
1873
|
|
|
1763
1874
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1764
1875
|
|---|---|---|---|---|
|
|
1765
|
-
| `state` | input | `PaginationState` | `
|
|
1766
|
-
| `totalItems` | input | `number \| null` | `null` | Total de registros
|
|
1876
|
+
| `state` | input | `PaginationState` | `{ page: 1, size: 10 }` | |
|
|
1877
|
+
| `totalItems` | input | `number \| null` | `null` | Total de registros; `null` quando não se sabe (cursor). |
|
|
1767
1878
|
| `variant` | input | `PaginatorVariant` | `'full'` | |
|
|
1768
|
-
| `label` | input | `string` | `''` | Nome do `nav`. Vazio
|
|
1769
|
-
| `showPage` | input | `boolean` | `true` | Na `simple`, mostra a posição ("Página 2 de 5"
|
|
1770
|
-
| `hasNext` | input | `boolean \| undefined` | `undefined` |
|
|
1771
|
-
| `hasPrevious` | input | `boolean \| undefined` | `undefined` |
|
|
1772
|
-
| `sizes` | input | `readonly number[]` | `
|
|
1773
|
-
| `maxNumbers` | input | `number` | `7` |
|
|
1879
|
+
| `label` | input | `string` | `''` | Nome do `nav`. Vazio = catálogo. Dois paginadores na mesma tela precisam de nomes distintos. |
|
|
1880
|
+
| `showPage` | input | `boolean` | `true` | Na variante `simple`, mostra a posição ("Página 2 de 5"). |
|
|
1881
|
+
| `hasNext` | input | `boolean \| undefined` | `undefined` | Só na `simple`: força a habilitação da próxima (cursor). `undefined` = calcula pelo total. |
|
|
1882
|
+
| `hasPrevious` | input | `boolean \| undefined` | `undefined` | |
|
|
1883
|
+
| `sizes` | input | `readonly number[]` | `[10, 25, 50, 100]` | |
|
|
1884
|
+
| `maxNumbers` | input | `number` | `7` | |
|
|
1774
1885
|
| `stateChanged` | output | `PaginationState` | | |
|
|
1775
|
-
| `nextPage` | output | `void` | |
|
|
1776
|
-
| `previousPage` | output | `void` | |
|
|
1886
|
+
| `nextPage` | output | `void` | | |
|
|
1887
|
+
| `previousPage` | output | `void` | | |
|
|
1777
1888
|
|
|
1778
1889
|
## `| hmDate` (pipe)
|
|
1779
1890
|
|
|
@@ -1879,21 +1990,21 @@ Métodos públicos: `currentErrors(): Readonly<Record<string, string>>`
|
|
|
1879
1990
|
|
|
1880
1991
|
`RadioComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/radio` (também na raiz)
|
|
1881
1992
|
|
|
1882
|
-
|
|
1993
|
+
Escolha única entre poucas opções visíveis, com rádios nativos: Tab entra no grupo, as setas trocam a escolha e pulam as desabilitadas. Valor `string` (o `value` da opção marcada).
|
|
1883
1994
|
|
|
1884
1995
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1885
1996
|
|---|---|---|---|---|
|
|
1886
1997
|
| `value` | model | `string` | `''` | |
|
|
1887
1998
|
| `label` | input (obrigatório) | `string` | | |
|
|
1888
1999
|
| `options` | input (obrigatório) | `readonly RadioOption[]` | | |
|
|
1889
|
-
| `appearance` | input | `RadioAppearance \| undefined` | `undefined` |
|
|
1890
|
-
| `layout` | input | `RadioLayout \| undefined` | `undefined` |
|
|
1891
|
-
| `hint` | input | `string` | `''` |
|
|
2000
|
+
| `appearance` | input | `RadioAppearance \| undefined` | `undefined` | |
|
|
2001
|
+
| `layout` | input | `RadioLayout \| undefined` | `undefined` | |
|
|
2002
|
+
| `hint` | input | `string` | `''` | |
|
|
1892
2003
|
| `help` | input | `string` | `''` | Depreciado desde 0.2.0 — use `hint`. |
|
|
1893
|
-
| `disabled` | input (herdado) | `boolean` | `false` |
|
|
1894
|
-
| `required` | input (herdado) | `boolean` | `false` |
|
|
1895
|
-
| `error` | input (herdado) | `string` | `''` | Erro definido
|
|
1896
|
-
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro
|
|
2004
|
+
| `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
|
|
2005
|
+
| `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
|
|
2006
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
|
|
2007
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
|
|
1897
2008
|
|
|
1898
2009
|
## `hm-reorder-list`
|
|
1899
2010
|
|
|
@@ -1911,16 +2022,50 @@ Lista reordenável (`hm-reorder-list`) por arrasto **e** por teclado. A interaç
|
|
|
1911
2022
|
| `removable` | input | `boolean` | `false` | Mostra em cada linha o botão que remove o item da lista. |
|
|
1912
2023
|
| `moved` | output | `ReorderListMove` | | Movimento confirmado: item, posição de origem e de destino (índices a partir de 0). |
|
|
1913
2024
|
| `removed` | output | `ReorderListRemoval` | | Item removido pelo ✕ (a lista nova já foi publicada em `items`/formulário). |
|
|
1914
|
-
| `disabled` | input (herdado) | `boolean` | `false` |
|
|
1915
|
-
| `required` | input (herdado) | `boolean` | `false` |
|
|
1916
|
-
| `error` | input (herdado) | `string` | `''` | Erro definido
|
|
1917
|
-
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro
|
|
2025
|
+
| `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
|
|
2026
|
+
| `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
|
|
2027
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
|
|
2028
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
|
|
2029
|
+
|
|
2030
|
+
## `hm-rich-text`
|
|
2031
|
+
|
|
2032
|
+
`RichTextComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/rich-text` (também na raiz)
|
|
2033
|
+
|
|
2034
|
+
Campo de texto com formatação cujo valor é **HTML canônico e sanitizado** (`<p>`, `<h2>`, listas, citação, código, `strong`/`em`/`u`/`s`/`code`/`a`). Funciona com Reactive Forms, `[(ngModel)]` ou `[(value)]`; o documento vazio vale `''` (então `Validators.required` funciona sem adaptação) e `RichTextValidators.maxLength(n)` conta os caracteres de texto.
|
|
2035
|
+
|
|
2036
|
+
Métodos públicos: `focus(): void`, `apply(tool: RichTextFormatTool): void`, `undo(): void`, `redo(): void`
|
|
2037
|
+
|
|
2038
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2039
|
+
|---|---|---|---|---|
|
|
2040
|
+
| `value` | model | `string` | `''` | HTML canônico. Two-way (`[(value)]`). |
|
|
2041
|
+
| `label` | input (obrigatório) | `string` | | Rótulo do campo (nome acessível da área de edição). |
|
|
2042
|
+
| `labelHidden` | input | `boolean` | `false` | Rótulo só para tecnologia assistiva (fica visualmente oculto, mas segue como nome acessível). |
|
|
2043
|
+
| `hint` | input | `string` | `''` | |
|
|
2044
|
+
| `placeholder` | input | `string` | `''` | Texto exibido com o documento vazio. |
|
|
2045
|
+
| `readonly` | input | `boolean` | `false` | Somente leitura: mostra o conteúdo (links navegam), permite selecionar e copiar, sem barra. |
|
|
2046
|
+
| `loading` | input | `boolean` | `false` | |
|
|
2047
|
+
| `tools` | input | `readonly RichTextTool[]` | `RICH_TEXT_DEFAULT_TOOLS` | Ferramentas da barra, na ordem (`'\|'` separa grupos). Também define o esquema aceito. |
|
|
2048
|
+
| `headingLevels` | input | `readonly RichTextHeadingLevel[]` | `[2, 3]` | Níveis de título oferecidos e aceitos. |
|
|
2049
|
+
| `hideToolbar` | input | `boolean` | `false` | Oculta a barra; os atalhos continuam valendo. |
|
|
2050
|
+
| `rows` | input | `number` | `5` | Altura mínima, em linhas de texto. |
|
|
2051
|
+
| `maxRows` | input | `number \| null` | `null` | Teto de altura em linhas (rola por dentro acima disso); `null` = sem teto. |
|
|
2052
|
+
| `maxLength` | input | `number \| null` | `null` | Limite flexível de caracteres de texto (não bloqueia a digitação). Liga o contador. |
|
|
2053
|
+
| `showCounter` | input | `boolean` | `false` | Mostra o contador mesmo sem `maxLength`. |
|
|
2054
|
+
| `pasteMode` | input | `RichTextPasteMode` | `'formatted'` | `'plain'` cola sempre como texto puro. |
|
|
2055
|
+
| `linkProtocols` | input | `readonly string[]` | `RICH_TEXT_DEFAULT_PROTOCOLS` | Protocolos aceitos em links (sem `:`). |
|
|
2056
|
+
| `allowRelativeLinks` | input | `boolean` | `false` | Aceita `href` relativo (`/caminho`, `#ancora`, `?q=`). |
|
|
2057
|
+
| `spellcheck` | input | `boolean` | `true` | |
|
|
2058
|
+
| `focusChange` | output | `boolean` | | Foco entrou (`true`) ou saiu (`false`) do componente (área, barra e popover de link contam). |
|
|
2059
|
+
| `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
|
|
2060
|
+
| `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
|
|
2061
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
|
|
2062
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
|
|
1918
2063
|
|
|
1919
2064
|
## `hm-search-field`
|
|
1920
2065
|
|
|
1921
2066
|
`SearchFieldComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/search-field` (também na raiz)
|
|
1922
2067
|
|
|
1923
|
-
Campo de busca: rótulo, lupa
|
|
2068
|
+
Campo de busca: `<input type="search">` com rótulo real, lupa decorativa e botão de limpar. Não filtra nada — publica o termo (`search`) e quem usa decide o que fazer com ele.
|
|
1924
2069
|
|
|
1925
2070
|
Métodos públicos: `focus(): void`, `clear(): void`
|
|
1926
2071
|
|
|
@@ -1928,19 +2073,19 @@ Métodos públicos: `focus(): void`, `clear(): void`
|
|
|
1928
2073
|
|---|---|---|---|---|
|
|
1929
2074
|
| `value` | model | `string` | `''` | |
|
|
1930
2075
|
| `label` | input (obrigatório) | `string` | | |
|
|
1931
|
-
| `labelHidden` | input | `boolean` | `false` |
|
|
2076
|
+
| `labelHidden` | input | `boolean` | `false` | Rótulo só para tecnologia assistiva (fica visualmente oculto, mas segue como nome acessível). |
|
|
1932
2077
|
| `placeholder` | input | `string` | `''` | |
|
|
1933
|
-
| `hint` | input | `string` | `''` |
|
|
2078
|
+
| `hint` | input | `string` | `''` | |
|
|
1934
2079
|
| `size` | input | `SearchFieldSize` | `'medium'` | |
|
|
1935
|
-
| `debounce` | input | `number` | `0` | Espera (ms)
|
|
1936
|
-
| `landmark` | input | `boolean` | `true` | `role="search"`
|
|
1937
|
-
| `loading` | input | `boolean` | `false` |
|
|
1938
|
-
| `search` | output | `string` | | Termo publicado (
|
|
1939
|
-
| `cleared` | output | `void` | | O termo foi limpo (botão ou `
|
|
1940
|
-
| `disabled` | input (herdado) | `boolean` | `false` |
|
|
1941
|
-
| `required` | input (herdado) | `boolean` | `false` |
|
|
1942
|
-
| `error` | input (herdado) | `string` | `''` | Erro definido
|
|
1943
|
-
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro
|
|
2080
|
+
| `debounce` | input | `number` | `0` | Espera (ms) depois da última tecla antes de publicar `search`; 0 = na hora. |
|
|
2081
|
+
| `landmark` | input | `boolean` | `true` | Marca o bloco como região de busca (`role="search"`). |
|
|
2082
|
+
| `loading` | input | `boolean` | `false` | |
|
|
2083
|
+
| `search` | output | `string` | | Termo publicado (por tecla, depois da espera, no Enter ou ao limpar). |
|
|
2084
|
+
| `cleared` | output | `void` | | O termo foi limpo (botão, Esc ou `clear()`). |
|
|
2085
|
+
| `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
|
|
2086
|
+
| `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
|
|
2087
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
|
|
2088
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
|
|
1944
2089
|
|
|
1945
2090
|
## `hm-segmented-control`
|
|
1946
2091
|
|
|
@@ -1955,10 +2100,10 @@ Escolha exclusiva entre poucas opções curtas (2 a 5), todas visíveis de uma v
|
|
|
1955
2100
|
| `label` | input (obrigatório) | `string` | | Nome do grupo para leitor de tela (não aparece: o rótulo visível mora na linha em volta). |
|
|
1956
2101
|
| `size` | input | `SegmentedControlSize` | `'medium'` | |
|
|
1957
2102
|
| `emphasis` | input | `SegmentedControlEmphasis` | `'subtle'` | |
|
|
1958
|
-
| `disabled` | input (herdado) | `boolean` | `false` |
|
|
1959
|
-
| `required` | input (herdado) | `boolean` | `false` |
|
|
1960
|
-
| `error` | input (herdado) | `string` | `''` | Erro definido
|
|
1961
|
-
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro
|
|
2103
|
+
| `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
|
|
2104
|
+
| `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
|
|
2105
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
|
|
2106
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
|
|
1962
2107
|
|
|
1963
2108
|
## `hm-select`
|
|
1964
2109
|
|
|
@@ -1972,12 +2117,12 @@ Slots: `(padrão)`
|
|
|
1972
2117
|
|---|---|---|---|---|
|
|
1973
2118
|
| `value` | model | `T` | `undefined as unknown as T` | Genérico: `T` default `string \| null` porque um select sem seleção (placeholder "Selecione...") é um estado comum. Tipado como `T` para quem recebe o `valueCha… |
|
|
1974
2119
|
| `label` | input (obrigatório) | `string` | | |
|
|
1975
|
-
| `labelHidden` | input | `boolean` | `false` |
|
|
2120
|
+
| `labelHidden` | input | `boolean` | `false` | Rótulo só para tecnologia assistiva (fica visualmente oculto, mas segue como nome acessível). |
|
|
1976
2121
|
| `hint` | input | `string` | `''` | Texto de apoio embaixo do campo. |
|
|
1977
|
-
| `disabled` | input (herdado) | `boolean` | `false` |
|
|
1978
|
-
| `required` | input (herdado) | `boolean` | `false` |
|
|
1979
|
-
| `error` | input (herdado) | `string` | `''` | Erro definido
|
|
1980
|
-
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro
|
|
2122
|
+
| `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
|
|
2123
|
+
| `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
|
|
2124
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
|
|
2125
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
|
|
1981
2126
|
|
|
1982
2127
|
## `hm-session-recovery`
|
|
1983
2128
|
|
|
@@ -2051,15 +2196,15 @@ Métodos públicos: `focusFirstInvalid(): void`
|
|
|
2051
2196
|
|
|
2052
2197
|
`ShortcutListComponent` — import de `@trismegisto/angular/shortcut-list` (também na raiz)
|
|
2053
2198
|
|
|
2054
|
-
Painel
|
|
2199
|
+
Painel com os atalhos de teclado do app, agrupados: os registrados no `HermesShortcutService` (que entram e saem conforme as telas abrem e fecham) e os declarados em `items`. Cada tecla é um `<kbd>` — o mesmo desenho do `.hm-kbd` do core —, com o nome por extenso para leitor de tela quando o rótulo é só um símbolo (⌘, ⇧, ←).
|
|
2055
2200
|
|
|
2056
2201
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2057
2202
|
|---|---|---|---|---|
|
|
2058
|
-
| `items` | input | `readonly HermesShortcutItem[]` | `[]` | Atalhos
|
|
2059
|
-
| `registered` | input | `boolean` | `true` | Inclui os atalhos registrados no
|
|
2060
|
-
| `searchable` | input | `boolean` | `false` |
|
|
2061
|
-
| `characterKeysToggle` | input | `boolean` | `false` | Mostra o interruptor dos atalhos de tecla única
|
|
2062
|
-
| `headingLevel` | input | `number` | `3` | Nível
|
|
2203
|
+
| `items` | input | `readonly HermesShortcutItem[]` | `[]` | Atalhos que só aparecem no painel (tratados pelo próprio componente, por exemplo). |
|
|
2204
|
+
| `registered` | input | `boolean` | `true` | Inclui os atalhos registrados no serviço. |
|
|
2205
|
+
| `searchable` | input | `boolean` | `false` | |
|
|
2206
|
+
| `characterKeysToggle` | input | `boolean` | `false` | Mostra o interruptor dos atalhos de tecla única. |
|
|
2207
|
+
| `headingLevel` | input | `number` | `3` | Nível dos títulos de grupo (`aria-level`). |
|
|
2063
2208
|
|
|
2064
2209
|
## `[hmShortcut]`
|
|
2065
2210
|
|
|
@@ -2081,7 +2226,7 @@ Liga um atalho de teclado a um elemento **enquanto ele existe**: registra no `He
|
|
|
2081
2226
|
|
|
2082
2227
|
`SidebarGroupComponent` — import de `@trismegisto/angular/sidebar` (também na raiz)
|
|
2083
2228
|
|
|
2084
|
-
Grupo expansível
|
|
2229
|
+
Grupo expansível da navegação lateral (padrão APG *Disclosure*). No primeiro nível nasce aberto; dentro de outro grupo, fechado. A escolha vale para a sessão e é por `id` — dois grupos com o mesmo `id` dividem a preferência, então use ids únicos.
|
|
2085
2230
|
|
|
2086
2231
|
Slots: `(padrão)`
|
|
2087
2232
|
|
|
@@ -2089,62 +2234,62 @@ Métodos públicos: `expand(): void`, `markActive(source: object, active: boolea
|
|
|
2089
2234
|
|
|
2090
2235
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2091
2236
|
|---|---|---|---|---|
|
|
2092
|
-
| `id` | input (obrigatório) | `string` | |
|
|
2237
|
+
| `id` | input (obrigatório) | `string` | | Chave da preferência de aberto/fechado (e alvo de "expandir/recolher tudo"). |
|
|
2093
2238
|
| `label` | input (obrigatório) | `string` | | |
|
|
2094
|
-
| `icon` | input (obrigatório) | `string` | |
|
|
2239
|
+
| `icon` | input (obrigatório) | `string` | | Nome de ícone do catálogo; quem usa registra. |
|
|
2095
2240
|
|
|
2096
2241
|
## `hm-sidebar-link`
|
|
2097
2242
|
|
|
2098
2243
|
`SidebarLinkComponent` — import de `@trismegisto/angular/sidebar` (também na raiz)
|
|
2099
2244
|
|
|
2100
|
-
Item de navegação:
|
|
2245
|
+
Item de rota da navegação lateral: um `<a routerLink>` de verdade (Ctrl/clique do meio abrem em outra aba). A atividade usa as opções padrão do `RouterLinkActive` — a rota-pai continua ativa nas filhas — e é repassada ao grupo mais próximo.
|
|
2101
2246
|
|
|
2102
2247
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2103
2248
|
|---|---|---|---|---|
|
|
2104
2249
|
| `route` | input (obrigatório) | `string \| readonly unknown[]` | | |
|
|
2105
|
-
| `label` | input (obrigatório) | `string` | |
|
|
2106
|
-
| `icon` | input (obrigatório) | `string` | |
|
|
2250
|
+
| `label` | input (obrigatório) | `string` | | |
|
|
2251
|
+
| `icon` | input (obrigatório) | `string` | | Nome de ícone do catálogo; quem usa registra. |
|
|
2107
2252
|
|
|
2108
2253
|
## `hm-sidebar-node`
|
|
2109
2254
|
|
|
2110
2255
|
`SidebarNodeComponent` — import de `@trismegisto/angular/sidebar` (também na raiz)
|
|
2111
2256
|
|
|
2112
|
-
Desenha
|
|
2257
|
+
Desenha uma árvore de `SidebarNode` com `hm-sidebar-group`/`hm-sidebar-link`. `depth` é quantos níveis ainda podem virar grupo: `0` desenha só links (lista de módulos), `Infinity` aninha até as folhas.
|
|
2113
2258
|
|
|
2114
2259
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2115
2260
|
|---|---|---|---|---|
|
|
2116
2261
|
| `node` | input (obrigatório) | `SidebarNode` | | |
|
|
2117
|
-
| `depth` | input | `number` | `1` |
|
|
2262
|
+
| `depth` | input | `number` | `1` | |
|
|
2118
2263
|
|
|
2119
2264
|
## `hm-sidebar`
|
|
2120
2265
|
|
|
2121
2266
|
`SidebarComponent` — import de `@trismegisto/angular/sidebar` (também na raiz)
|
|
2122
2267
|
|
|
2123
|
-
|
|
2268
|
+
Coluna de navegação do shell. O conteúdo projetado (links, grupos, `hm-sidebar-node` ou qualquer outra coisa) rola dentro de `#hm-sidebar-content`. Com `heading`, a coluna mostra um nível de módulo com título e, se houver `backLabel`, o botão de voltar (`back`).
|
|
2124
2269
|
|
|
2125
2270
|
Slots: `(padrão)`
|
|
2126
2271
|
|
|
2127
2272
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2128
2273
|
|---|---|---|---|---|
|
|
2129
|
-
| `label` | input (obrigatório) | `string` | | Nome
|
|
2130
|
-
| `heading` | input | `string` | `''` |
|
|
2274
|
+
| `label` | input (obrigatório) | `string` | | Nome do landmark `<nav>`. |
|
|
2275
|
+
| `heading` | input | `string` | `''` | Título do nível atual; vazio = nível raiz, sem topo. |
|
|
2131
2276
|
| `headingIcon` | input | `string` | `'grid'` | |
|
|
2132
|
-
| `backLabel` | input | `string` | `''` |
|
|
2133
|
-
| `direction` | input | `'forward' \| 'back'` | `'forward'` |
|
|
2134
|
-
| `collapsible` | input | `boolean` | `true` |
|
|
2277
|
+
| `backLabel` | input | `string` | `''` | Texto do botão de voltar (só aparece com `heading`); vazio = sem botão. |
|
|
2278
|
+
| `direction` | input | `'forward' \| 'back'` | `'forward'` | De que lado o nível novo entra: `forward` vem do fim, `back` do início. |
|
|
2279
|
+
| `collapsible` | input | `boolean` | `true` | Rodapé com o menu de modos e as ações de expandir/recolher tudo. |
|
|
2135
2280
|
| `back` | output | `void` | | |
|
|
2136
2281
|
|
|
2137
2282
|
## `hm-skeleton`
|
|
2138
2283
|
|
|
2139
2284
|
`SkeletonComponent` — import de `@trismegisto/angular/skeleton` (também na raiz)
|
|
2140
2285
|
|
|
2141
|
-
|
|
2286
|
+
Silhueta de carregamento no lugar do conteúdo que ainda não chegou.
|
|
2142
2287
|
|
|
2143
2288
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2144
2289
|
|---|---|---|---|---|
|
|
2145
2290
|
| `shape` | input | `SkeletonShape` | `'text'` | |
|
|
2146
|
-
| `count` | input | `number` | `3` | Quantas linhas,
|
|
2147
|
-
| `label` | input (obrigatório) | `string` | |
|
|
2291
|
+
| `count` | input | `number` | `3` | Quantas linhas, faixas ou cartões (mínimo 1). |
|
|
2292
|
+
| `label` | input (obrigatório) | `string` | | Nome do que está carregando, para o leitor de tela. |
|
|
2148
2293
|
|
|
2149
2294
|
## `hm-slider`
|
|
2150
2295
|
|
|
@@ -2171,10 +2316,10 @@ Controle deslizante — valor único ou intervalo (dois polegares), com o padrã
|
|
|
2171
2316
|
| `size` | input | `SliderSize` | `'medium'` | |
|
|
2172
2317
|
| `format` | input | `Intl.NumberFormatOptions \| null` | `null` | Opções do `Intl.NumberFormat` para o valor exibido e anunciado. |
|
|
2173
2318
|
| `valueText` | input | `((value: number, thumb: SliderThumb \| null) => string) \| null` | `null` | Texto exibido/anunciado de um valor (tem precedência sobre `format`). |
|
|
2174
|
-
| `disabled` | input (herdado) | `boolean` | `false` |
|
|
2175
|
-
| `required` | input (herdado) | `boolean` | `false` |
|
|
2176
|
-
| `error` | input (herdado) | `string` | `''` | Erro definido
|
|
2177
|
-
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro
|
|
2319
|
+
| `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
|
|
2320
|
+
| `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
|
|
2321
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
|
|
2322
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
|
|
2178
2323
|
|
|
2179
2324
|
## `hm-spinner`
|
|
2180
2325
|
|
|
@@ -2232,46 +2377,46 @@ Métodos públicos: `restoreDefault(): void`
|
|
|
2232
2377
|
|
|
2233
2378
|
`StatCardComponent` — import de `@trismegisto/angular/stat-card` (também na raiz)
|
|
2234
2379
|
|
|
2235
|
-
|
|
2380
|
+
Indicador de um número só (`hm-stat-card`), desenhado sobre um `hm-card`: rótulo com ícone num disco, o valor em destaque e, se quiser, uma frase de contexto, o detalhamento e a variação.
|
|
2236
2381
|
|
|
2237
2382
|
Slots: `[trailing]`, `[footer]`
|
|
2238
2383
|
|
|
2239
2384
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2240
2385
|
|---|---|---|---|---|
|
|
2241
|
-
| `icon` | input | `string` | `''` | Ícone do
|
|
2242
|
-
| `label` | input (obrigatório) | `string` | |
|
|
2243
|
-
| `value` | input (obrigatório) | `
|
|
2244
|
-
| `intent` | input | `IconStatus` | `'neutral'` |
|
|
2245
|
-
| `fill` | input | `boolean` | `true` |
|
|
2246
|
-
| `description` | input | `string` | `''` | Frase curta, sempre visível, sob o valor
|
|
2247
|
-
| `details` | input | `readonly StatCardDetail[]` | `[]` | Fragmentos do detalhamento,
|
|
2248
|
-
| `trend` | input | `StatCardTrend \| null` | `null` | Variação
|
|
2249
|
-
| `hint` | input | `string` | `''` | Explicação
|
|
2386
|
+
| `icon` | input | `string` | `''` | Ícone do catálogo num disco ao lado do rótulo; vazio = sem disco. |
|
|
2387
|
+
| `label` | input (obrigatório) | `string` | | Nome do indicador. |
|
|
2388
|
+
| `value` | input (obrigatório) | `string \| number` | | O número (ou texto) em destaque, impresso sem formatação. |
|
|
2389
|
+
| `intent` | input | `IconStatus` | `'neutral'` | Tom do disco e do valor. |
|
|
2390
|
+
| `fill` | input | `boolean` | `true` | Repassado ao `fill` do `hm-card`. |
|
|
2391
|
+
| `description` | input | `string` | `''` | Frase curta, sempre visível, sob o valor. |
|
|
2392
|
+
| `details` | input | `readonly StatCardDetail[]` | `[]` | Fragmentos do detalhamento, em linha. |
|
|
2393
|
+
| `trend` | input | `StatCardTrend \| null` | `null` | Variação com seta; `null` = nenhuma. |
|
|
2394
|
+
| `hint` | input | `string` | `''` | Explicação aberta sob demanda num `hm-toggletip`. |
|
|
2250
2395
|
| `size` | input | `StatCardSize` | `'medium'` | |
|
|
2251
|
-
| `selectable` | input | `boolean` | `false` |
|
|
2252
|
-
| `selected` | input | `boolean` | `false` |
|
|
2253
|
-
| `selectedChange` | output | `boolean` | |
|
|
2254
|
-
| `loading` | input | `boolean` | `false` | O dado ainda não chegou
|
|
2396
|
+
| `selectable` | input | `boolean` | `false` | Faz do cartão um botão de alternância. |
|
|
2397
|
+
| `selected` | input | `boolean` | `false` | Ligado; só conta com `selectable`. |
|
|
2398
|
+
| `selectedChange` | output | `boolean` | | Pede a troca de estado com o valor desejado (`!selected`). |
|
|
2399
|
+
| `loading` | input | `boolean` | `false` | O dado ainda não chegou. |
|
|
2255
2400
|
|
|
2256
2401
|
## `hm-stat-group`
|
|
2257
2402
|
|
|
2258
2403
|
`StatGroupComponent` — import de `@trismegisto/angular/stat-group` (também na raiz)
|
|
2259
2404
|
|
|
2260
|
-
|
|
2405
|
+
Resumo de uma categoria (`hm-stat-group`): um `hm-card` com título que vira região nomeada, as métricas dela numa lista de descrição (`<dl>`) e, se pedido, uma ação "ver mais" no rodapé.
|
|
2261
2406
|
|
|
2262
2407
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2263
2408
|
|---|---|---|---|---|
|
|
2264
|
-
| `heading` | input (obrigatório) | `string` | | Categoria
|
|
2265
|
-
| `icon` | input | `string` | `''` | Ícone ao lado do título.
|
|
2409
|
+
| `heading` | input (obrigatório) | `string` | | Categoria das métricas: título do card e nome da região. |
|
|
2410
|
+
| `icon` | input | `string` | `''` | Ícone decorativo ao lado do título. |
|
|
2266
2411
|
| `metrics` | input (obrigatório) | `readonly StatGroupMetric[]` | | |
|
|
2267
|
-
| `intent` | input | `IconStatus` | `'neutral'` |
|
|
2268
|
-
| `hint` | input | `string` | `''` | Explicação
|
|
2269
|
-
| `moreLabel` | input | `string` | `''` | Texto da ação
|
|
2270
|
-
| `moreLink` | input | `string` | `''` | Destino da ação
|
|
2271
|
-
| `moreAction` | input | `boolean` | `false` |
|
|
2272
|
-
| `fill` | input | `boolean` | `true` |
|
|
2273
|
-
| `loading` | input | `boolean` | `false` |
|
|
2274
|
-
| `more` | output | `void` | | A
|
|
2412
|
+
| `intent` | input | `IconStatus` | `'neutral'` | Tom dos valores que não trazem o próprio. |
|
|
2413
|
+
| `hint` | input | `string` | `''` | Explicação das métricas, no canto do cabeçalho. |
|
|
2414
|
+
| `moreLabel` | input | `string` | `''` | Texto da ação; vazio usa `statCard.more`. |
|
|
2415
|
+
| `moreLink` | input | `string` | `''` | Destino da ação; com ele a ação é um link. |
|
|
2416
|
+
| `moreAction` | input | `boolean` | `false` | Mostra a ação mesmo sem texto nem destino. |
|
|
2417
|
+
| `fill` | input | `boolean` | `true` | Repassado ao `fill` do `hm-card`. |
|
|
2418
|
+
| `loading` | input | `boolean` | `false` | |
|
|
2419
|
+
| `more` | output | `void` | | A ação "ver mais" foi acionada (botão ou link). |
|
|
2275
2420
|
|
|
2276
2421
|
## `hm-state-page`
|
|
2277
2422
|
|
|
@@ -2294,44 +2439,44 @@ Slots: `(padrão)`
|
|
|
2294
2439
|
|
|
2295
2440
|
`StateScreenComponent` — import de `@trismegisto/angular/state-screen` (também na raiz)
|
|
2296
2441
|
|
|
2297
|
-
Tela
|
|
2442
|
+
Tela de situação — lista vazia, erro, acesso negado, fim de fluxo — com título, explicação, ilustração e uma ação para seguir em frente.
|
|
2298
2443
|
|
|
2299
2444
|
Slots: `[illustration]`, `(padrão)`
|
|
2300
2445
|
|
|
2301
2446
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2302
2447
|
|---|---|---|---|---|
|
|
2303
2448
|
| `heading` | input (obrigatório) | `string` | | |
|
|
2304
|
-
| `description` | input | `string` | `''` |
|
|
2449
|
+
| `description` | input | `string` | `''` | Explicação curta embaixo do título. Vazia não desenha. |
|
|
2305
2450
|
| `situation` | input | `StateScreenSituation` | `'empty'` | |
|
|
2306
|
-
| `action` | input | `string` | `''` | Rótulo
|
|
2451
|
+
| `action` | input | `string` | `''` | Rótulo do botão principal. Vazio = sem botão. |
|
|
2307
2452
|
| `actionIcon` | input | `string` | `'arrow-left'` | |
|
|
2308
|
-
| `actionTriggered` | output | `void` | |
|
|
2453
|
+
| `actionTriggered` | output | `void` | | |
|
|
2309
2454
|
|
|
2310
2455
|
## `hm-step`
|
|
2311
2456
|
|
|
2312
2457
|
`StepComponent` — import de `@trismegisto/angular/stepper` (também na raiz)
|
|
2313
2458
|
|
|
2314
|
-
Uma etapa de `hm-stepper
|
|
2459
|
+
Uma etapa de `hm-stepper` (ou de `hm-wizard`). Só a etapa aberta desenha o painel; as outras ficam sem nada no DOM, mas o conteúdo projetado continua vivo — um formulário preenchido numa etapa está lá do mesmo jeito quando a pessoa volta a ela.
|
|
2315
2460
|
|
|
2316
2461
|
Slots: `(padrão)`
|
|
2317
2462
|
|
|
2318
2463
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2319
2464
|
|---|---|---|---|---|
|
|
2320
|
-
| `label` | input | `string` | `''` |
|
|
2321
|
-
| `description` | input | `string` | `''` | Texto curto sob o
|
|
2322
|
-
| `optional` | input | `boolean` | `false` |
|
|
2323
|
-
| `disabled` | input | `boolean` | `false` |
|
|
2324
|
-
| `error` | input | `boolean` | `false` | Força a
|
|
2325
|
-
| `completed` | input | `boolean \| null` | `null` |
|
|
2326
|
-
| `stepControl` | input | `AbstractControl \| null` | `null` |
|
|
2327
|
-
| `canAdvance` | input | `HermesStepGuard \| null` | `null` |
|
|
2328
|
-
| `summary` | input | `HermesStepSummary \| null` | `null` | O que
|
|
2465
|
+
| `label` | input | `string` | `''` | Nome da etapa no indicador e título do painel. |
|
|
2466
|
+
| `description` | input | `string` | `''` | Texto curto sob o nome, no indicador. |
|
|
2467
|
+
| `optional` | input | `boolean` | `false` | Não segura o avanço no modo linear, nem impede o fluxo de ficar completo. |
|
|
2468
|
+
| `disabled` | input | `boolean` | `false` | Nunca alcançável; Avançar e Voltar passam por cima dela. |
|
|
2469
|
+
| `error` | input | `boolean` | `false` | Força a situação de erro (soma-se ao erro de validação). |
|
|
2470
|
+
| `completed` | input | `boolean \| null` | `null` | `true`/`false` forçam concluída/pendente; `null` deixa o stepper decidir pelo que a pessoa fez. |
|
|
2471
|
+
| `stepControl` | input | `AbstractControl \| null` | `null` | Controle validado ao sair adiante da etapa (é tocado para mostrar os erros). |
|
|
2472
|
+
| `canAdvance` | input | `HermesStepGuard \| null` | `null` | Guarda extra, chamada depois do controle passar. |
|
|
2473
|
+
| `summary` | input | `HermesStepSummary \| null` | `null` | O que esta etapa mostra na página de revisão do `hm-wizard`. |
|
|
2329
2474
|
|
|
2330
2475
|
## `hm-stepper`
|
|
2331
2476
|
|
|
2332
2477
|
`StepperComponent` — import de `@trismegisto/angular/stepper` (também na raiz)
|
|
2333
2478
|
|
|
2334
|
-
|
|
2479
|
+
Fluxo em etapas: o indicador (lista ordenada dentro de um `nav`) e o painel da etapa aberta.
|
|
2335
2480
|
|
|
2336
2481
|
Slots: `(padrão)`
|
|
2337
2482
|
|
|
@@ -2339,60 +2484,60 @@ Métodos públicos: `isActive(step: object): boolean`, `next(): Promise<boolean>
|
|
|
2339
2484
|
|
|
2340
2485
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2341
2486
|
|---|---|---|---|---|
|
|
2342
|
-
| `selectedIndex` | model | `number` | `0` |
|
|
2343
|
-
| `linear` | input | `boolean` | `false` |
|
|
2344
|
-
| `orientation` | input | `StepperOrientation` | `'horizontal'` |
|
|
2345
|
-
| `readOnly` | input | `boolean` | `false` |
|
|
2346
|
-
| `label` | input | `string` | `''` | Nome
|
|
2347
|
-
| `level` | input | `number` | `3` |
|
|
2348
|
-
| `hideHeading` | input | `boolean` | `false` | Título do painel só para leitor de tela (quando
|
|
2349
|
-
| `steps` | input | `readonly StepComponent[] \| null` | `null` | Etapas
|
|
2487
|
+
| `selectedIndex` | model | `number` | `0` | Índice (0-based) da etapa aberta. Two-way. |
|
|
2488
|
+
| `linear` | input | `boolean` | `false` | Avançar valida a etapa aberta e o indicador não salta adiante sem concluir as anteriores. |
|
|
2489
|
+
| `orientation` | input | `StepperOrientation` | `'horizontal'` | |
|
|
2490
|
+
| `readOnly` | input | `boolean` | `false` | Indicador só informativo: nenhuma etapa é clicável. |
|
|
2491
|
+
| `label` | input | `string` | `''` | Nome do `nav`. Vazio = catálogo. |
|
|
2492
|
+
| `level` | input | `number` | `3` | `aria-level` do título de cada painel. |
|
|
2493
|
+
| `hideHeading` | input | `boolean` | `false` | Título do painel só para leitor de tela (quando a tela já tem um título visível). |
|
|
2494
|
+
| `steps` | input | `readonly StepComponent[] \| null` | `null` | Etapas explícitas no lugar das filhas. Para quem re-projeta `hm-step` (o `hm-wizard`): conteúdo re-projetado não aparece na consulta de conteúdo deste componen… |
|
|
2350
2495
|
|
|
2351
2496
|
## `hm-switch`
|
|
2352
2497
|
|
|
2353
2498
|
`SwitchComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/switch` (também na raiz)
|
|
2354
2499
|
|
|
2355
|
-
Interruptor
|
|
2500
|
+
Interruptor de efeito imediato (ligar/desligar uma preferência). É um checkbox nativo com `role="switch"`: Espaço alterna e o leitor anuncia "ligado/desligado". Para escolha que só vale ao enviar um formulário, prefira `hm-checkbox`.
|
|
2356
2501
|
|
|
2357
2502
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2358
2503
|
|---|---|---|---|---|
|
|
2359
2504
|
| `value` | model | `boolean` | `false` | |
|
|
2360
2505
|
| `label` | input (obrigatório) | `string` | | |
|
|
2361
|
-
| `hint` | input | `string` | `''` | Texto
|
|
2506
|
+
| `hint` | input | `string` | `''` | Texto de apoio embaixo do rótulo. |
|
|
2362
2507
|
| `help` | input | `string` | `''` | Depreciado desde 0.2.0 — use `hint`. |
|
|
2363
|
-
| `labelPosition` | input | `SwitchLabelPosition` | `'after'` |
|
|
2364
|
-
| `loading` | input | `boolean` | `false` | Silhueta
|
|
2365
|
-
| `disabled` | input (herdado) | `boolean` | `false` |
|
|
2366
|
-
| `required` | input (herdado) | `boolean` | `false` |
|
|
2367
|
-
| `error` | input (herdado) | `string` | `''` | Erro definido
|
|
2368
|
-
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro
|
|
2508
|
+
| `labelPosition` | input | `SwitchLabelPosition` | `'after'` | Lado do rótulo. A ordem de leitura e de foco não muda. |
|
|
2509
|
+
| `loading` | input | `boolean` | `false` | Silhueta no lugar do controle enquanto o valor real não chega. |
|
|
2510
|
+
| `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
|
|
2511
|
+
| `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
|
|
2512
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
|
|
2513
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
|
|
2369
2514
|
|
|
2370
2515
|
## `hm-tab-bar`
|
|
2371
2516
|
|
|
2372
2517
|
`TabBarComponent` — import de `@trismegisto/angular/tab-bar` (também na raiz)
|
|
2373
2518
|
|
|
2374
|
-
|
|
2519
|
+
Fileira de abas "de navegador" (páginas abertas), **controlada**: desenha `tabs`/`active` e só emite intenções — ativar, fechar, reordenar, nova aba, menu de contexto, aba recebida de outra fileira. Quem consome (um `TabBarStore`, o `hm-workspace`) aplica a mudança.
|
|
2375
2520
|
|
|
2376
2521
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2377
2522
|
|---|---|---|---|---|
|
|
2378
2523
|
| `tabs` | input (obrigatório) | `readonly TabItem[]` | | |
|
|
2379
|
-
| `active` | input (obrigatório) | `string` | |
|
|
2380
|
-
| `label` | input | `string` | `''` |
|
|
2381
|
-
| `allowNewTab` | input | `boolean` | `true` | Mostra o
|
|
2382
|
-
| `contentId` | input | `string` | `''` | Id do elemento que
|
|
2383
|
-
| `tabGroup` | input | `unknown` | `null` | Grupo de
|
|
2524
|
+
| `active` | input (obrigatório) | `string` | | Id da aba em cena. |
|
|
2525
|
+
| `label` | input | `string` | `''` | Nome da fileira (vazio = texto padrão do catálogo). |
|
|
2526
|
+
| `allowNewTab` | input | `boolean` | `true` | Mostra o botão "+" de nova aba. |
|
|
2527
|
+
| `contentId` | input | `string` | `''` | Id do elemento que mostra o conteúdo da aba ativa (`aria-controls`); vazio = sem o atributo. |
|
|
2528
|
+
| `tabGroup` | input | `unknown` | `null` | Grupo de fileiras que trocam abas por arrasto (comparado por identidade); `null` = só reordena. |
|
|
2384
2529
|
| `activated` | output | `string` | | |
|
|
2385
2530
|
| `closed` | output | `string` | | |
|
|
2386
|
-
| `reordered` | output | `{ id: string; index: number }` | |
|
|
2531
|
+
| `reordered` | output | `{ id: string; index: number }` | | |
|
|
2387
2532
|
| `newTabRequested` | output | `void` | | |
|
|
2388
|
-
| `contextMenuRequested` | output | `{ id: string; anchor: PopoverAnchor }` | |
|
|
2389
|
-
| `tabReceived` | output | `TabReceivedEvent` | |
|
|
2533
|
+
| `contextMenuRequested` | output | `{ id: string; anchor: PopoverAnchor }` | | |
|
|
2534
|
+
| `tabReceived` | output | `TabReceivedEvent` | | |
|
|
2390
2535
|
|
|
2391
2536
|
## `ng-template[hmTabContent]`
|
|
2392
2537
|
|
|
2393
2538
|
`TabContentDirective` — import de `@trismegisto/angular/tabs` (também na raiz)
|
|
2394
2539
|
|
|
2395
|
-
Conteúdo preguiçoso de um `hm-tab`:
|
|
2540
|
+
Conteúdo preguiçoso de um `hm-tab`: `<ng-template hmTabContent>…</ng-template>` (ou `*hmTabContent`) como filho direto da aba. Só é criado na primeira vez que a aba é exibida e, por padrão, fica vivo (escondido) quando a pessoa troca de aba; `destroyOnHide` no `hm-tab` o recria a cada volta.
|
|
2396
2541
|
|
|
2397
2542
|
_Sem inputs/outputs._
|
|
2398
2543
|
|
|
@@ -2400,55 +2545,55 @@ _Sem inputs/outputs._
|
|
|
2400
2545
|
|
|
2401
2546
|
`TabComponent` — import de `@trismegisto/angular/tabs` (também na raiz)
|
|
2402
2547
|
|
|
2403
|
-
|
|
2548
|
+
Uma aba de `hm-tabs`. O botão (ou o link, no modo `nav`) é desenhado pelo grupo, na faixa; aqui fica só o painel, que existe enquanto a aba está em exibição. Com um `hmTabContent` filho direto, o conteúdo nasce na primeira exibição e sobrevive escondido às trocas de aba (salvo com `destroyOnHide`).
|
|
2404
2549
|
|
|
2405
2550
|
Slots: `(padrão)`
|
|
2406
2551
|
|
|
2407
2552
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2408
2553
|
|---|---|---|---|---|
|
|
2409
|
-
| `id` | input | `string` | `''` |
|
|
2410
|
-
| `label` | input | `string` | `''` | Texto
|
|
2554
|
+
| `id` | input | `string` | `''` | Identificador da aba, o valor de `active` no grupo. |
|
|
2555
|
+
| `label` | input | `string` | `''` | Texto da aba na faixa. |
|
|
2411
2556
|
| `disabled` | input | `boolean` | `false` | |
|
|
2412
|
-
| `count` | input | `number \| null` | `null` |
|
|
2413
|
-
| `route` | input | `string \| readonly unknown[] \| null` | `null` |
|
|
2414
|
-
| `exact` | input | `boolean` | `false` |
|
|
2415
|
-
| `destroyOnHide` | input | `boolean` | `false` | Com
|
|
2557
|
+
| `count` | input | `number \| null` | `null` | Número exibido ao lado do rótulo (`0` aparece); `null` = sem contagem. |
|
|
2558
|
+
| `route` | input | `string \| readonly unknown[] \| null` | `null` | Só no modo `nav`: destino do link (como no `routerLink`). |
|
|
2559
|
+
| `exact` | input | `boolean` | `false` | Só no modo `nav`: o link fica atual apenas com a URL idêntica (rotas filhas não contam). |
|
|
2560
|
+
| `destroyOnHide` | input | `boolean` | `false` | Com `hmTabContent`: destrói o conteúdo ao sair da aba (recria ao voltar). |
|
|
2416
2561
|
|
|
2417
2562
|
## `hm-tabs`
|
|
2418
2563
|
|
|
2419
2564
|
`TabsComponent` — import de `@trismegisto/angular/tabs` (também na raiz)
|
|
2420
2565
|
|
|
2421
|
-
|
|
2566
|
+
Abas de conteúdo: alterna seções de uma mesma tela.
|
|
2422
2567
|
|
|
2423
2568
|
Slots: `[actions]`, `(padrão)`
|
|
2424
2569
|
|
|
2425
2570
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2426
2571
|
|---|---|---|---|---|
|
|
2427
|
-
| `label` | input (obrigatório) | `string` | | Nome
|
|
2428
|
-
| `active` | model | `string` | `''` |
|
|
2429
|
-
| `orientation` | input | `HermesTabsOrientation` | `'horizontal'` |
|
|
2430
|
-
| `mode` | input | `HermesTabsMode` | `'tabs'` |
|
|
2431
|
-
| `overflow` | input | `HermesTabsOverflow` | `'menu'` |
|
|
2432
|
-
| `fillHeight` | input | `boolean` | `false` |
|
|
2433
|
-
| `noPanelGap` | input | `boolean` | `false` |
|
|
2572
|
+
| `label` | input (obrigatório) | `string` | | Nome acessível da lista de abas (ou da região de navegação, no modo `nav`). |
|
|
2573
|
+
| `active` | model | `string` | `''` | Id da aba ativa (two-way). |
|
|
2574
|
+
| `orientation` | input | `HermesTabsOrientation` | `'horizontal'` | |
|
|
2575
|
+
| `mode` | input | `HermesTabsMode` | `'tabs'` | |
|
|
2576
|
+
| `overflow` | input | `HermesTabsOverflow` | `'menu'` | Só na horizontal: `menu` leva as abas que não cabem para o "Mais"; `wrap` quebra a fileira. |
|
|
2577
|
+
| `fillHeight` | input | `boolean` | `false` | Ocupa a altura do pai flex; o painel em exibição fica com o restante e rola por dentro. |
|
|
2578
|
+
| `noPanelGap` | input | `boolean` | `false` | Tira o respiro vertical do painel (para conteúdo que já tem o seu). |
|
|
2434
2579
|
|
|
2435
2580
|
## `hm-tag`
|
|
2436
2581
|
|
|
2437
2582
|
`TagComponent` — import de `@trismegisto/angular/tag` (também na raiz)
|
|
2438
2583
|
|
|
2439
|
-
|
|
2584
|
+
Etiqueta curta de categoria ou situação ("Ativa", "Rascunho", "Produção").
|
|
2440
2585
|
|
|
2441
2586
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2442
2587
|
|---|---|---|---|---|
|
|
2443
2588
|
| `name` | input (obrigatório) | `string` | | |
|
|
2444
2589
|
| `color` | input | `TagColor` | `'neutral'` | |
|
|
2445
|
-
| `compact` | input | `boolean` | `false` |
|
|
2590
|
+
| `compact` | input | `boolean` | `false` | Só a cor, sem texto visível (o nome vai para a dica e para o leitor de tela). |
|
|
2446
2591
|
|
|
2447
2592
|
## `[hmTextareaPrefix], [hmTextareaSuffix], [hmTextareaActions], [hmTextareaActionsEnd]`
|
|
2448
2593
|
|
|
2449
2594
|
`TextareaAddonDirective` — import de `@trismegisto/angular/textarea` (também na raiz)
|
|
2450
2595
|
|
|
2451
|
-
Marca um
|
|
2596
|
+
Marca um complemento do `hm-textarea` (prefixo, sufixo ou ação da barra de baixo). É a presença desta diretiva que liga a moldura de complementos: importe-a junto com o `TextareaComponent`.
|
|
2452
2597
|
|
|
2453
2598
|
_Sem inputs/outputs._
|
|
2454
2599
|
|
|
@@ -2456,7 +2601,7 @@ _Sem inputs/outputs._
|
|
|
2456
2601
|
|
|
2457
2602
|
`TextareaComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/textarea` (também na raiz)
|
|
2458
2603
|
|
|
2459
|
-
|
|
2604
|
+
Texto de várias linhas com rótulo, ajuda, contador e erro ligados por `aria-describedby`, na mesma régua do `hm-input`. Funciona com Reactive Forms, `[(ngModel)]` ou `[(value)]` (ver `HermesFormFieldBase`).
|
|
2460
2605
|
|
|
2461
2606
|
Slots: `[hmTextareaPrefix]`, `[hmTextareaSuffix]`, `[hmTextareaActions]`, `[hmTextareaActionsEnd]`
|
|
2462
2607
|
|
|
@@ -2464,21 +2609,21 @@ Slots: `[hmTextareaPrefix]`, `[hmTextareaSuffix]`, `[hmTextareaActions]`, `[hmTe
|
|
|
2464
2609
|
|---|---|---|---|---|
|
|
2465
2610
|
| `value` | model | `string` | `''` | |
|
|
2466
2611
|
| `label` | input (obrigatório) | `string` | | |
|
|
2467
|
-
| `hint` | input | `string` | `''` |
|
|
2612
|
+
| `hint` | input | `string` | `''` | |
|
|
2468
2613
|
| `help` | input | `string` | `''` | Depreciado desde 0.2.0 — use `hint`. |
|
|
2469
2614
|
| `placeholder` | input | `string` | `''` | |
|
|
2470
|
-
| `maxLength` | input | `number \| null` | `null` | Limite
|
|
2471
|
-
| `rows` | input | `number` | `3` |
|
|
2472
|
-
| `autoGrow` | input | `boolean` | `false` |
|
|
2473
|
-
| `labelHidden` | input | `boolean` | `false` |
|
|
2615
|
+
| `maxLength` | input | `number \| null` | `null` | Limite de caracteres, com contador. |
|
|
2616
|
+
| `rows` | input | `number` | `3` | |
|
|
2617
|
+
| `autoGrow` | input | `boolean` | `false` | Altura acompanha o conteúdo. |
|
|
2618
|
+
| `labelHidden` | input | `boolean` | `false` | Rótulo só para tecnologia assistiva (fica visualmente oculto, mas segue como nome acessível). |
|
|
2474
2619
|
| `loading` | input | `boolean` | `false` | |
|
|
2475
|
-
| `maxRows` | input | `number \| null` | `null` |
|
|
2476
|
-
| `submitKey` | input | `TextareaSubmitKey` | `'none'` |
|
|
2477
|
-
| `submitted` | output | `string` | |
|
|
2478
|
-
| `disabled` | input (herdado) | `boolean` | `false` |
|
|
2479
|
-
| `required` | input (herdado) | `boolean` | `false` |
|
|
2480
|
-
| `error` | input (herdado) | `string` | `''` | Erro definido
|
|
2481
|
-
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro
|
|
2620
|
+
| `maxRows` | input | `number \| null` | `null` | Teto do `autoGrow`, em linhas. |
|
|
2621
|
+
| `submitKey` | input | `TextareaSubmitKey` | `'none'` | |
|
|
2622
|
+
| `submitted` | output | `string` | | |
|
|
2623
|
+
| `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
|
|
2624
|
+
| `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
|
|
2625
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
|
|
2626
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
|
|
2482
2627
|
|
|
2483
2628
|
## `hm-theme-builder`
|
|
2484
2629
|
|
|
@@ -2501,14 +2646,14 @@ Métodos públicos: `download(): void`
|
|
|
2501
2646
|
|
|
2502
2647
|
`ThemePickerComponent` — import de `@trismegisto/angular/theme-picker` (também na raiz)
|
|
2503
2648
|
|
|
2504
|
-
|
|
2649
|
+
Escolha de família de cor (e, opcionalmente, de claro/escuro). Não guarda nem aplica nada: mostra o que recebe em `family`/`theme` e avisa a escolha por `familyChosen`/`themeChosen` — quem aplica é o app (em geral `HermesThemeService`).
|
|
2505
2650
|
|
|
2506
2651
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2507
2652
|
|---|---|---|---|---|
|
|
2508
2653
|
| `families` | input (obrigatório) | `readonly HermesFamily[]` | | |
|
|
2509
|
-
| `family` | input (obrigatório) | `string` | |
|
|
2654
|
+
| `family` | input (obrigatório) | `string` | | Id da família escolhida. |
|
|
2510
2655
|
| `theme` | input (obrigatório) | `HermesThemeName` | | |
|
|
2511
|
-
| `showMode` | input | `boolean` | `true` | Mostra o par
|
|
2656
|
+
| `showMode` | input | `boolean` | `true` | Mostra o par Claro/Escuro. |
|
|
2512
2657
|
| `familyChosen` | output | `string` | | |
|
|
2513
2658
|
| `themeChosen` | output | `HermesThemeName` | | |
|
|
2514
2659
|
|
|
@@ -2537,10 +2682,10 @@ Campo de hora. Digita-se a hora com máscara no relógio do idioma — 24 h (`14
|
|
|
2537
2682
|
| `max` | input | `IsoTime \| null` | `null` | Último horário aceito (`HH:mm`). |
|
|
2538
2683
|
| `interval` | input | `number` | `30` | Intervalo, em minutos, entre os horários sugeridos. |
|
|
2539
2684
|
| `hourCycle` | input | `TimeHourCycle \| null` | `null` | Força o relógio de exibição (`h12`/`h23`); `null` segue o idioma. |
|
|
2540
|
-
| `disabled` | input (herdado) | `boolean` | `false` |
|
|
2541
|
-
| `required` | input (herdado) | `boolean` | `false` |
|
|
2542
|
-
| `error` | input (herdado) | `string` | `''` | Erro definido
|
|
2543
|
-
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro
|
|
2685
|
+
| `disabled` | input (herdado) | `boolean` | `false` | Desabilita o campo sem depender de formulário. |
|
|
2686
|
+
| `required` | input (herdado) | `boolean` | `false` | Marca o campo como obrigatório (marca visual e ARIA). Sozinho não gera mensagem de erro. |
|
|
2687
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido pelo app (ex.: resposta do servidor). Vence o erro do controle. |
|
|
2688
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro do controle (`{ required: 'Informe o nome.' }`). |
|
|
2544
2689
|
|
|
2545
2690
|
## `hm-timeline-item`
|
|
2546
2691
|
|
|
@@ -2563,21 +2708,21 @@ Slots: `(padrão)`
|
|
|
2563
2708
|
|
|
2564
2709
|
`TimelineComponent` — import de `@trismegisto/angular/timeline` (também na raiz)
|
|
2565
2710
|
|
|
2566
|
-
Linha do tempo
|
|
2711
|
+
Linha do tempo de um processo que se acompanha: cada `hm-timeline-item` vira um marco com data, título, descrição e conteúdo livre. A situação de cada marco vem do próprio item (`status`) ou é deduzida de `current` (o marco em que o processo está) e `outcome` (correndo, concluído ou falhou).
|
|
2567
2712
|
|
|
2568
2713
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2569
2714
|
|---|---|---|---|---|
|
|
2570
|
-
| `orientation` | input | `TimelineOrientation` | `'vertical'` |
|
|
2571
|
-
| `current` | input | `string` | `''` | `key` do
|
|
2572
|
-
| `outcome` | input | `TimelineOutcome` | `'running'` |
|
|
2573
|
-
| `label` | input | `string` | `''` | Nome da lista
|
|
2574
|
-
| `dateFormat` | input | `Intl.DateTimeFormatOptions` | `TIMELINE_DATE_FORMAT` |
|
|
2715
|
+
| `orientation` | input | `TimelineOrientation` | `'vertical'` | |
|
|
2716
|
+
| `current` | input | `string` | `''` | `key` do marco em que o processo está. |
|
|
2717
|
+
| `outcome` | input | `TimelineOutcome` | `'running'` | `running` (padrão), `completed` (fecha todos) ou `failed` (o atual com erro). |
|
|
2718
|
+
| `label` | input | `string` | `''` | Nome da lista. Vazio = catálogo. |
|
|
2719
|
+
| `dateFormat` | input | `Intl.DateTimeFormatOptions` | `TIMELINE_DATE_FORMAT` | Opções do `Intl.DateTimeFormat`; o idioma é o do catálogo ativo. |
|
|
2575
2720
|
|
|
2576
2721
|
## `hm-toast-stack`
|
|
2577
2722
|
|
|
2578
2723
|
`ToastStackComponent` — import de `@trismegisto/angular/toast` (também na raiz)
|
|
2579
2724
|
|
|
2580
|
-
|
|
2725
|
+
Onde os avisos do `HermesToastService` aparecem: uma coluna fixa no canto de cima, do lado do fim da linha. Monte uma vez, no layout do app (`<router-outlet /><hm-toast-stack />`).
|
|
2581
2726
|
|
|
2582
2727
|
_Sem inputs/outputs._
|
|
2583
2728
|
|
|
@@ -2585,16 +2730,16 @@ _Sem inputs/outputs._
|
|
|
2585
2730
|
|
|
2586
2731
|
`ToastComponent` — import de `@trismegisto/angular/toast` (também na raiz)
|
|
2587
2732
|
|
|
2588
|
-
|
|
2733
|
+
Cartão de aviso flutuante. Normalmente quem o monta é o `hm-toast-stack`, a partir do `HermesToastService`; usado sozinho, quem decide quando tirá-lo da tela é você (`closed`).
|
|
2589
2734
|
|
|
2590
2735
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2591
2736
|
|---|---|---|---|---|
|
|
2592
2737
|
| `variant` | input | `AlertVariant` | `'info'` | |
|
|
2593
|
-
| `title` | input | `string` | `''` | Vazio
|
|
2738
|
+
| `title` | input | `string` | `''` | Título do cartão. Vazio usa o título padrão da variante. |
|
|
2594
2739
|
| `message` | input (obrigatório) | `string` | | |
|
|
2595
|
-
| `duration` | input | `number` | `0` | Milissegundos até
|
|
2596
|
-
| `actionLabel` | input | `string` | `''` |
|
|
2597
|
-
| `action` | output | `void` | |
|
|
2740
|
+
| `duration` | input | `number` | `0` | Milissegundos até fechar sozinho. `0` = só fecha pelo botão. |
|
|
2741
|
+
| `actionLabel` | input | `string` | `''` | Rótulo do botão de ação. Vazio = sem botão. |
|
|
2742
|
+
| `action` | output | `void` | | |
|
|
2598
2743
|
| `closed` | output | `void` | | |
|
|
2599
2744
|
|
|
2600
2745
|
## `hm-toggle-group-item`
|
|
@@ -2639,7 +2784,7 @@ Métodos públicos: `isMultiple(): boolean`, `isPressed(value: string): boolean`
|
|
|
2639
2784
|
|
|
2640
2785
|
`ToggletipComponent` — import de `@trismegisto/angular/toggletip` (também na raiz)
|
|
2641
2786
|
|
|
2642
|
-
|
|
2787
|
+
Toggletip: um ícone que, clicado, mostra uma explicação curta num balão — e o mesmo clique esconde. Diferente da dica de hover (`hmTooltip`), o conteúdo fica até a pessoa fechar e pode ter link.
|
|
2643
2788
|
|
|
2644
2789
|
Slots: `(padrão)`
|
|
2645
2790
|
|
|
@@ -2647,10 +2792,10 @@ Métodos públicos: `close(): void`
|
|
|
2647
2792
|
|
|
2648
2793
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2649
2794
|
|---|---|---|---|---|
|
|
2650
|
-
| `label` | input (obrigatório) | `string` | | Nome acessível do ícone
|
|
2651
|
-
| `text` | input | `string` | `''` | Texto do balão
|
|
2652
|
-
| `side` | input | `ToggletipSide` | `'bottom'` |
|
|
2653
|
-
| `intent` | input | `'default' \| 'danger'` | `'default'` |
|
|
2795
|
+
| `label` | input (obrigatório) | `string` | | Nome acessível do ícone (ex.: "Ajuda sobre o prazo de resposta"). |
|
|
2796
|
+
| `text` | input | `string` | `''` | Texto do balão; o conteúdo projetado vem depois dele. |
|
|
2797
|
+
| `side` | input | `ToggletipSide` | `'bottom'` | Lado preferido; vira para o outro quando não cabe. |
|
|
2798
|
+
| `intent` | input | `'default' \| 'danger'` | `'default'` | |
|
|
2654
2799
|
| `icon` | input | `string` | `'info-circle'` | |
|
|
2655
2800
|
|
|
2656
2801
|
## `hm-toolbar`
|
|
@@ -2687,33 +2832,33 @@ Métodos públicos: `show(): void`, `hide(): void`
|
|
|
2687
2832
|
|
|
2688
2833
|
`TreeComponent` — import de `@trismegisto/angular/tree` (também na raiz)
|
|
2689
2834
|
|
|
2690
|
-
Árvore
|
|
2835
|
+
Árvore (`hm-tree`), lista ARIA `tree` achatada: todos os `treeitem` são irmãos, com nível/posição em atributos.
|
|
2691
2836
|
|
|
2692
2837
|
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2693
2838
|
|---|---|---|---|---|
|
|
2694
2839
|
| `nodes` | input (obrigatório) | `readonly TreeNode[]` | | |
|
|
2695
|
-
| `label` | input (obrigatório) | `string` | | Nome da árvore
|
|
2696
|
-
| `emptyMessage` | input | `string` | |
|
|
2697
|
-
| `selectable` | input | `boolean` | `true` |
|
|
2698
|
-
| `selectionMode` | input | `TreeSelectionMode \| null` | `null` |
|
|
2699
|
-
| `selection` | model | `ReadonlySet<string>` | `new Set
|
|
2700
|
-
| `selected` | input | `ReadonlySet<string>` | `new Set
|
|
2701
|
-
| `expanded` | model | `ReadonlySet<string>` | `new Set
|
|
2702
|
-
| `activeId` | model | `string \| null` | `null` |
|
|
2703
|
-
| `loadChildren` | input | `TreeChildrenLoader \| null` | `null` |
|
|
2704
|
-
| `
|
|
2705
|
-
| `
|
|
2706
|
-
| `
|
|
2707
|
-
| `
|
|
2708
|
-
| `
|
|
2709
|
-
| `
|
|
2710
|
-
| `nodeAction` | output | `TreeNodeActionEvent` | |
|
|
2840
|
+
| `label` | input (obrigatório) | `string` | | Nome acessível da árvore. |
|
|
2841
|
+
| `emptyMessage` | input | `string` | | Texto quando não há nada para mostrar (padrão: `tree.empty`). |
|
|
2842
|
+
| `selectable` | input | `boolean` | `true` | Caixas tri-state; `false` = árvore de navegação. Ignorado quando há `selectionMode`. |
|
|
2843
|
+
| `selectionMode` | input | `TreeSelectionMode \| null` | `null` | |
|
|
2844
|
+
| `selection` | model | `ReadonlySet<string>` | `new Set()` | Seleção por `aria-selected` (`selectionMode` single/multiple). |
|
|
2845
|
+
| `selected` | input | `ReadonlySet<string>` | `new Set()` | Marcação das caixas — só entrada: o app aplica o que `changed` emitir. |
|
|
2846
|
+
| `expanded` | model | `ReadonlySet<string>` | `new Set()` | |
|
|
2847
|
+
| `activeId` | model | `string \| null` | `null` | |
|
|
2848
|
+
| `loadChildren` | input | `TreeChildrenLoader \| null` | `null` | |
|
|
2849
|
+
| `draggable` | input | `boolean` | `false` | |
|
|
2850
|
+
| `canDrop` | input | `TreeCanDrop \| null` | `null` | |
|
|
2851
|
+
| `nodeActions` | input | `TreeNodeActions` | `[]` | |
|
|
2852
|
+
| `changed` | output | `readonly TreeSelectionChange[]` | | |
|
|
2853
|
+
| `activated` | output | `TreeNode` | | |
|
|
2854
|
+
| `moved` | output | `TreeMoveEvent` | | |
|
|
2855
|
+
| `nodeAction` | output | `TreeNodeActionEvent` | | |
|
|
2711
2856
|
|
|
2712
2857
|
## `ng-template[hmTreeNode]`
|
|
2713
2858
|
|
|
2714
2859
|
`TreeNodeTemplateDirective` — import de `@trismegisto/angular/tree` (também na raiz)
|
|
2715
2860
|
|
|
2716
|
-
Conteúdo
|
|
2861
|
+
Conteúdo próprio do nó (no lugar de ícone + rótulo): `<ng-template hmTreeNode let-node let-active="active">`.
|
|
2717
2862
|
|
|
2718
2863
|
_Sem inputs/outputs._
|
|
2719
2864
|
|
|
@@ -2735,7 +2880,6 @@ Métodos públicos: `isActive(step: object): boolean`
|
|
|
2735
2880
|
| `size` | input | `ModalSize` | `'large'` | Largura do modal (só no modo `modal`): `small`, `medium`, `large` (padrão), `xlarge` ou `full` (tela cheia, bom para assistente longo no celular). Repassada ao… |
|
|
2736
2881
|
| `selectedIndex` | model | `number` | `0` | Two-way: índice da etapa aberta. |
|
|
2737
2882
|
| `linear` | input | `boolean` | `true` | Avançar valida a etapa aberta e os rótulos não pulam etapas. Padrão ligado. |
|
|
2738
|
-
| `orientation` | input | `StepperOrientation` | `'horizontal'` | |
|
|
2739
2883
|
| `loading` | input | `boolean` | `false` | Salvando: o Concluir carrega, os demais botões e o X travam. |
|
|
2740
2884
|
| `confirmCancel` | input | `boolean \| Partial<HermesConfirmOptions>` | `false` | Pergunta antes de cancelar. `true` usa os textos do catálogo; um objeto troca os que vierem (`heading`, `message`, `confirmLabel`, `cancelLabel`, `danger`). |
|
|
2741
2885
|
| `level` | input | `number` | `3` | Nível do título de cada etapa (`aria-level`): 3 cabe sob o título do modal (`h2`). |
|