@acropole/skills 0.0.0-stage → 1.1.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 +181 -2
- package/agents/revisor-deploy.md +73 -0
- package/agents/revisor-documentacao.md +78 -0
- package/agents/revisor-orfeu.md +80 -0
- package/agents/revisor-trismegisto.md +81 -0
- package/bin/install.js +252 -0
- package/package.json +15 -4
- package/skills/acropole/SKILL.md +80 -0
- package/skills/acropole/references/arquitetura.md +174 -0
- package/skills/acropole/references/fluxos/app-novo.md +34 -0
- package/skills/acropole/references/fluxos/doctor.md +55 -0
- package/skills/acropole/references/fluxos/endpoint-novo.md +22 -0
- package/skills/acropole/references/fluxos/revisar.md +56 -0
- package/skills/acropole/references/fluxos/tela-nova.md +27 -0
- package/skills/acropole/scripts/doctor.mjs +439 -0
- package/skills/angular/SKILL.md +155 -0
- package/skills/angular/references/armadilhas.md +99 -0
- package/skills/angular/references/dados.md +251 -0
- package/skills/angular/references/estrutura.md +279 -0
- package/skills/angular/references/features.md +219 -0
- package/skills/angular/references/testes-build.md +257 -0
- package/skills/angular/scripts/checar.mjs +182 -0
- package/skills/angular/scripts/nucleo.mjs +227 -0
- package/skills/apollo/SKILL.md +226 -0
- package/skills/apollo/references/armadilhas.md +99 -0
- package/skills/apollo/references/envelope-erros.md +120 -0
- package/skills/apollo/references/estrutura-bootstrap.md +310 -0
- package/skills/apollo/references/schema-resolvers.md +183 -0
- package/skills/apollo/references/subscriptions.md +224 -0
- package/skills/apollo/references/testes-build.md +181 -0
- package/skills/apollo/scripts/checar.mjs +160 -0
- package/skills/apollo/scripts/nucleo.mjs +227 -0
- package/skills/docker/SKILL.md +102 -0
- package/skills/docker/references/modelos.md +251 -0
- package/skills/docker/references/porques.md +286 -0
- package/skills/documentacao/SKILL.md +146 -0
- package/skills/documentacao/references/checklist-coerencia.md +59 -0
- package/skills/documentacao/references/ligar-app-novo.md +107 -0
- package/skills/documentacao/references/modelo-especificacao.md +51 -0
- package/skills/documentacao/references/modelo-readme.md +75 -0
- package/skills/documentacao/scripts/checar.mjs +454 -0
- package/skills/documentacao/scripts/nucleo.mjs +227 -0
- package/skills/express/SKILL.md +156 -0
- package/skills/express/references/dados.md +180 -0
- package/skills/express/references/estrutura.md +157 -0
- package/skills/express/references/middlewares.md +227 -0
- package/skills/express/references/rotas-erros.md +286 -0
- package/skills/express/references/testes-deploy.md +154 -0
- package/skills/express/scripts/checar.mjs +115 -0
- package/skills/express/scripts/nucleo.mjs +227 -0
- package/skills/fastapi/SKILL.md +132 -0
- package/skills/fastapi/references/banco.md +197 -0
- package/skills/fastapi/references/estrutura.md +325 -0
- package/skills/fastapi/references/integracoes.md +145 -0
- package/skills/fastapi/references/rotas-erros.md +140 -0
- package/skills/fastapi/references/testes-deploy.md +190 -0
- package/skills/fastapi/scripts/checar.mjs +108 -0
- package/skills/fastapi/scripts/nucleo.mjs +227 -0
- package/skills/hefesto/SKILL.md +119 -0
- package/skills/hefesto/references/conceitos.md +131 -0
- package/skills/hefesto/references/diagnostico.md +70 -0
- package/skills/hefesto/references/fluxo.md +122 -0
- package/skills/hefesto/references/preparar-app.md +105 -0
- package/skills/orfeu/SKILL.md +162 -0
- package/skills/orfeu/references/angular-api.md +201 -0
- package/skills/orfeu/references/angular-armadilhas.md +116 -0
- package/skills/orfeu/references/angular-recipes.md +474 -0
- package/skills/orfeu/references/angular.md +212 -0
- package/skills/orfeu/references/diferencas.md +56 -0
- package/skills/orfeu/references/node-api.md +354 -0
- package/skills/orfeu/references/node-armadilhas.md +158 -0
- package/skills/orfeu/references/node-recipes.md +541 -0
- package/skills/orfeu/references/node.md +204 -0
- package/skills/orfeu/references/python-api.md +346 -0
- package/skills/orfeu/references/python-recipes.md +479 -0
- package/skills/orfeu/references/python.md +240 -0
- package/skills/orfeu/scripts/checar.mjs +126 -0
- package/skills/orfeu/scripts/nucleo.mjs +227 -0
- package/skills/trismegisto/SKILL.md +194 -0
- package/skills/trismegisto/references/angular-api.md +2788 -0
- package/skills/trismegisto/references/angular-exports.md +4020 -0
- package/skills/trismegisto/references/angular-recipes.md +1883 -0
- package/skills/trismegisto/references/angular-types.md +492 -0
- package/skills/trismegisto/references/angular.md +390 -0
- package/skills/trismegisto/references/catalogo/icones.json +912 -0
- package/skills/trismegisto/references/catalogo/seletores.json +7013 -0
- package/skills/trismegisto/references/catalogo/tokens.json +240 -0
- package/skills/trismegisto/references/spine-api.md +1530 -0
- package/skills/trismegisto/references/spine-recipes.md +581 -0
- package/skills/trismegisto/references/spine.md +343 -0
- package/skills/trismegisto/scripts/checar.mjs +216 -0
- package/skills/trismegisto/scripts/nucleo.mjs +227 -0
|
@@ -0,0 +1,2788 @@
|
|
|
1
|
+
# Catálogo de API — @trismegisto/angular
|
|
2
|
+
|
|
3
|
+
> **Gerado** a partir do código-fonte da versão 1.0.0, a cada `npm run sync` do @acropole/skills.
|
|
4
|
+
> Gerado do código-fonte do `@trismegisto/angular` 1.0.0. Confira a versão instalada no `package.json` do pacote em `node_modules`.
|
|
5
|
+
|
|
6
|
+
Legenda: `input` = `[prop]`; `model` = two-way `[(prop)]`; `output` = `(evento)`.
|
|
7
|
+
Slots são os seletores de `<ng-content>`: projete com o atributo (ex.: `<div footer>`).
|
|
8
|
+
**Import** é o ponto de entrada secundário (sempre funciona); "também na raiz" = sai em `@trismegisto/angular`.
|
|
9
|
+
"Templates no conteúdo" = `<ng-template #nome>` que a peça procura dentro dela; "Métodos públicos" = chamáveis por `viewChild(Classe)` ou `#ref`.
|
|
10
|
+
Membros "herdados" vêm da classe base (ex.: `HermesFormFieldBase` dá `disabled`/`required`/`error`/`messages` a todo controle de formulário).
|
|
11
|
+
|
|
12
|
+
## `ng-template[hmAccordionContent]`
|
|
13
|
+
|
|
14
|
+
`AccordionContentDirective` — import de `@trismegisto/angular/accordion` (também na raiz)
|
|
15
|
+
|
|
16
|
+
Conteúdo preguiçoso de um `hm-accordion-panel`: o template só é montado na **primeira vez** que o painel abre, e depois fica montado (o corpo recolhido continua `inert`, como sempre), para não perder estado ao reabrir. Com `destroyOnClose` no painel, o conteúdo é destruído ao fechar e montado de novo ao abrir.
|
|
17
|
+
|
|
18
|
+
_Sem inputs/outputs._
|
|
19
|
+
|
|
20
|
+
## `hm-accordion-panel`
|
|
21
|
+
|
|
22
|
+
`AccordionPanelComponent` — import de `@trismegisto/angular/accordion` (também na raiz)
|
|
23
|
+
|
|
24
|
+
Um bloco do acordeão: cabeçalho clicável, indicador de expansão e o painel que abre.
|
|
25
|
+
|
|
26
|
+
Slots: `[heading]`, `[description]`, `(padrão)`
|
|
27
|
+
|
|
28
|
+
Métodos públicos: `close(): void`
|
|
29
|
+
|
|
30
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
31
|
+
|---|---|---|---|---|
|
|
32
|
+
| `disabled` | input | `boolean` | `false` | |
|
|
33
|
+
| `headingLevel` | input | `number` | `3` | Nível do cabeçalho na página, para o `aria-level` (o `h1` da tela é 1). |
|
|
34
|
+
| `open` | model | `boolean` | `false` | Two-way: o clique no cabeçalho escreve aqui, e quem usa pode abrir de fora. |
|
|
35
|
+
| `destroyOnClose` | input | `boolean` | `false` | Com conteúdo preguiçoso (`hmAccordionContent`), destrói o conteúdo ao fechar em vez de mantê-lo montado. Use quando o conteúdo precisa recomeçar a cada abertur… |
|
|
36
|
+
|
|
37
|
+
## `hm-accordion`
|
|
38
|
+
|
|
39
|
+
`AccordionComponent` — import de `@trismegisto/angular/accordion` (também na raiz)
|
|
40
|
+
|
|
41
|
+
Grupo de blocos que abrem e fecham: reúne os `hm-accordion-panel` numa superfície só, decide quantos podem ficar abertos ao mesmo tempo e liga a navegação por seta entre os cabeçalhos.
|
|
42
|
+
|
|
43
|
+
Slots: `(padrão)`
|
|
44
|
+
|
|
45
|
+
Métodos públicos: `closeOthers(opened: { close(): void }): void`
|
|
46
|
+
|
|
47
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
48
|
+
|---|---|---|---|---|
|
|
49
|
+
| `multi` | input | `boolean` | `false` | Permite mais de um painel aberto. Desligado, abrir um recolhe o que estava aberto. |
|
|
50
|
+
|
|
51
|
+
## `hm-account-avatar`
|
|
52
|
+
|
|
53
|
+
`AccountAvatarComponent` — import de `@trismegisto/angular/account-avatar` (também na raiz)
|
|
54
|
+
|
|
55
|
+
Avatar de conta. A ordem é **foto → iniciais → ícone genérico**: mostra a imagem quando há `imageUrl` (e ela carrega); sem URL ou com a imagem quebrada, as iniciais do `name`; sem nome também, o ícone de pessoa. Cair direto no ícone quando falta a foto jogaria fora o que o nome diz — duas pessoas virariam o mesmo boneco numa lista.
|
|
56
|
+
|
|
57
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
58
|
+
|---|---|---|---|---|
|
|
59
|
+
| `name` | input | `string` | `''` | Nome da conta: origem das iniciais. Vazio (e sem foto) = ícone genérico. |
|
|
60
|
+
| `imageUrl` | input | `string \| null \| undefined` | `null` | Foto da conta; opcional. |
|
|
61
|
+
| `size` | input | `AccountAvatarSize \| null` | `null` | Tamanho na escala do sistema. Sem valor, herda `--hm-avatar-size` (36px por padrão). |
|
|
62
|
+
| `loading` | input | `boolean` | `false` | Dado da conta ainda não chegou: círculo de esqueleto no lugar do retrato. |
|
|
63
|
+
|
|
64
|
+
## `hm-alert-group`
|
|
65
|
+
|
|
66
|
+
`AlertGroupComponent` — import de `@trismegisto/angular/alert` (também na raiz)
|
|
67
|
+
|
|
68
|
+
Paginador de alertas: vários `hm-alert` numa faixa só, um por vez, com "1 de 3" e anterior/próximo. Feito para os alertas de app (`appearance="banner"`) no topo do shell, mas aceita qualquer `hm-alert`.
|
|
69
|
+
|
|
70
|
+
Slots: `hm-alert`
|
|
71
|
+
|
|
72
|
+
Métodos públicos: `isCurrent(alert: object): boolean`
|
|
73
|
+
|
|
74
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
75
|
+
|---|---|---|---|---|
|
|
76
|
+
| `label` | input | `string` | `''` | Nome da faixa para o leitor de tela. Vazio = "N alertas" (`HERMES_MESSAGES.alert.groupLabel`). |
|
|
77
|
+
| `current` | model | `number` | `0` | Posição do alerta visível, 0-based, contando só os abertos. |
|
|
78
|
+
|
|
79
|
+
## `hm-alert`
|
|
80
|
+
|
|
81
|
+
`AlertComponent` — import de `@trismegisto/angular/alert` (também na raiz)
|
|
82
|
+
|
|
83
|
+
Mensagem em destaque, com título, ações e fechamento opcionais.
|
|
84
|
+
|
|
85
|
+
Slots: `(padrão)`, `[actions]`
|
|
86
|
+
|
|
87
|
+
Métodos públicos: `close(): void`
|
|
88
|
+
|
|
89
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
90
|
+
|---|---|---|---|---|
|
|
91
|
+
| `variant` | input | `AlertVariant` | `'info'` | |
|
|
92
|
+
| `appearance` | input | `AlertAppearance` | `'inline'` | `inline` (padrão): caixa no conteúdo. `banner`: faixa de app no topo, largura total, sem cantos. |
|
|
93
|
+
| `heading` | input | `string` | `''` | Primeira linha em negrito (ex.: "Manutenção programada"). Vazio não desenha. |
|
|
94
|
+
| `closable` | input | `boolean` | `false` | |
|
|
95
|
+
| `size` | input | `AlertSize` | `'medium'` | `small`: versão compacta (menos respiro, texto e ícone menores). |
|
|
96
|
+
| `showIcon` | input | `boolean` | `true` | |
|
|
97
|
+
| `link` | input | `string` | `''` | URL de um link de ação à direita da mensagem. Vazio não desenha. |
|
|
98
|
+
| `linkLabel` | input | `string` | `''` | Texto do link. Vazio = `HERMES_MESSAGES.alert.linkLabel` ("Saiba mais"). |
|
|
99
|
+
| `linkTarget` | input | `string` | `''` | `_blank` abre em nova aba (com `rel="noopener noreferrer"` e aviso ao leitor de tela). |
|
|
100
|
+
| `dismissKey` | input | `string` | `''` | Chave para lembrar o fechamento entre visitas (`localStorage`). Vazio (padrão) = fechar vale só para esta visita. Use um id estável e versionado por mensagem (… |
|
|
101
|
+
| `duration` | input | `number` | `0` | Fecha sozinho depois de N ms. `0` (padrão) mantém na tela. Não usar em `error`. |
|
|
102
|
+
| `closed` | output | `void` | | |
|
|
103
|
+
|
|
104
|
+
## `hm-attachment-group`
|
|
105
|
+
|
|
106
|
+
`AttachmentGroupComponent` — import de `@trismegisto/angular/attachment` (também na raiz)
|
|
107
|
+
|
|
108
|
+
Agrupa `hm-attachment` numa lista (`role="list"`, cada anexo vira `listitem`) com um dos três arranjos de `layout`. Os `hm-attachment` vão como filhos DIRETOS (um invólucro no meio quebra a relação lista → item). Quando o app remove um anexo a pedido do "remover" dele, o foco vai para o "remover" do anexo que ocupou o lugar (ou do anterior); sem nenhum, para o próprio grupo.
|
|
109
|
+
|
|
110
|
+
Slots: `(padrão)`
|
|
111
|
+
|
|
112
|
+
Métodos públicos: `removing(element: HTMLElement): void`
|
|
113
|
+
|
|
114
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
115
|
+
|---|---|---|---|---|
|
|
116
|
+
| `label` | input | `string` | `''` | Nome da lista para o leitor de tela ("Anexos da mensagem"). Recomendado com mais de um grupo na tela. |
|
|
117
|
+
| `layout` | input | `AttachmentGroupLayout` | `'list'` | |
|
|
118
|
+
|
|
119
|
+
## `hm-attachment`
|
|
120
|
+
|
|
121
|
+
`AttachmentComponent` — import de `@trismegisto/angular/attachment` (também na raiz)
|
|
122
|
+
|
|
123
|
+
Cartão de um arquivo anexado — numa mensagem, num chamado, num campo de prompt: miniatura (imagem) ou ícone pelo tipo, nome, tamanho, descrição, ações e, durante um envio, a situação com progresso.
|
|
124
|
+
|
|
125
|
+
Slots: `(padrão)`
|
|
126
|
+
|
|
127
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
128
|
+
|---|---|---|---|---|
|
|
129
|
+
| `name` | input (obrigatório) | `string` | | Nome do arquivo, com extensão — é o que identifica o anexo para todo mundo. |
|
|
130
|
+
| `size` | input | `number \| null` | `null` | Tamanho em bytes, formatado no idioma ativo ("2,1 MB"). `null` não mostra tamanho. |
|
|
131
|
+
| `type` | input | `string` | `''` | Tipo MIME (`'application/pdf'`); sem ele, o ícone sai pela extensão do nome. |
|
|
132
|
+
| `description` | input | `string` | `''` | Linha secundária (quem enviou, quando, para quê). |
|
|
133
|
+
| `thumbnail` | input | `string` | `''` | URL da miniatura (imagem). Sem ela, ou se não carregar, aparece o ícone pelo tipo. |
|
|
134
|
+
| `icon` | input | `string` | `''` | Ícone do catálogo no lugar do escolhido pelo tipo. |
|
|
135
|
+
| `href` | input | `string` | `''` | Endereço do arquivo: o nome vira link. |
|
|
136
|
+
| `download` | input | `boolean` | `false` | Com `href`: o link baixa em vez de abrir (atributo `download`, com o nome do arquivo). |
|
|
137
|
+
| `status` | input | `AttachmentStatus` | `'idle'` | |
|
|
138
|
+
| `progress` | input | `number` | `0` | Porcentagem de 0 a 100 durante `uploading`. |
|
|
139
|
+
| `error` | input | `string` | `''` | Motivo da falha (texto pronto), mostrado em `error`. |
|
|
140
|
+
| `removable` | input | `boolean` | `false` | Mostra o botão de remover (emite `removed`; tirar da lista é do app). |
|
|
141
|
+
| `retryable` | input | `boolean` | `false` | Em `error`, mostra o botão de tentar de novo (emite `retried`). |
|
|
142
|
+
| `disabled` | input | `boolean` | `false` | |
|
|
143
|
+
| `removed` | output | `void` | | Pediu para remover o anexo. |
|
|
144
|
+
| `retried` | output | `void` | | Pediu para tentar o envio de novo (só com `retryable`, em `error`). |
|
|
145
|
+
|
|
146
|
+
## `hm-avatar-group`
|
|
147
|
+
|
|
148
|
+
`AvatarGroupComponent` — import de `@trismegisto/angular/avatar-group` (também na raiz)
|
|
149
|
+
|
|
150
|
+
Pilha de avatares sobrepostos (`hm-avatar-group`): quem participa de algo, quando são poucos e o rosto basta para reconhecer. Compõe `hm-account-avatar` (foto ou iniciais).
|
|
151
|
+
|
|
152
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
153
|
+
|---|---|---|---|---|
|
|
154
|
+
| `people` | input (obrigatório) | `readonly AvatarGroupPerson[]` | | |
|
|
155
|
+
| `max` | input | `number` | `3` | Quantos rostos aparecem antes do "+N". 0 = todos. |
|
|
156
|
+
| `size` | input | `AvatarGroupSize` | `'medium'` | |
|
|
157
|
+
| `label` | input | `string` | `''` | Do que essas pessoas fazem parte ("Responsáveis", "Participantes"). Vazio = catálogo ("Pessoas"). |
|
|
158
|
+
|
|
159
|
+
## `hm-badge`
|
|
160
|
+
|
|
161
|
+
`BadgeComponent` — import de `@trismegisto/angular/badge` (também na raiz)
|
|
162
|
+
|
|
163
|
+
Contador que se ancora no canto de outra coisa (um sino, um ícone de módulo) — diz QUANTOS, não O QUÊ. Sem `value` (ou com `dot`) vira um ponto sólido: "tem algo novo" quando o número não importa.
|
|
164
|
+
|
|
165
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
166
|
+
|---|---|---|---|---|
|
|
167
|
+
| `value` | input | `number` | `0` | Zero ou negativo esconde o badge (a menos que `dot`): "0 notificações" é ruído. |
|
|
168
|
+
| `max` | input | | `BADGE_DEFAULT_MAX` | Acima disto o texto vira `{max}+`. |
|
|
169
|
+
| `dot` | input | `boolean` | `false` | Só o ponto, sem número. |
|
|
170
|
+
| `intent` | input | `BadgeIntent` | `'danger'` | |
|
|
171
|
+
| `label` | input | `string` | `''` | O que o leitor de tela anuncia, ex.: "3 notificações não lidas". Vazio: decorativo. |
|
|
172
|
+
|
|
173
|
+
## `hm-breadcrumb`
|
|
174
|
+
|
|
175
|
+
`BreadcrumbComponent` — import de `@trismegisto/angular/breadcrumb` (também na raiz)
|
|
176
|
+
|
|
177
|
+
Trilha "você está aqui": o caminho até a página atual, com volta a qualquer nível num clique. O último item é a página atual — sem link, com `aria-current="page"`.
|
|
178
|
+
|
|
179
|
+
Slots: `[actions]`
|
|
180
|
+
|
|
181
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
182
|
+
|---|---|---|---|---|
|
|
183
|
+
| `items` | input (obrigatório) | `readonly BreadcrumbItem[]` | | |
|
|
184
|
+
| `maxItems` | input | `number` | `4` | Acima disto o meio recolhe. `0` = nunca recolhe. |
|
|
185
|
+
| `itemsBeforeCollapse` | input | `number` | `1` | Quantos níveis ficam visíveis antes do "…". |
|
|
186
|
+
| `itemsAfterCollapse` | input | `number` | `2` | Quantos níveis ficam visíveis depois do "…" (contando a página atual). |
|
|
187
|
+
| `label` | input | `string` | `''` | Nome do `nav`. Vazio = texto do catálogo ("Você está aqui"). |
|
|
188
|
+
| `loading` | input | `boolean` | `false` | Silhueta no lugar da trilha enquanto a rota resolve. |
|
|
189
|
+
| `itemClick` | output | `BreadcrumbItem` | | Clique num degrau com link — além da navegação, para quem precisa reagir (analytics, estado). |
|
|
190
|
+
|
|
191
|
+
## `hm-bubble`
|
|
192
|
+
|
|
193
|
+
`BubbleComponent` — import de `@trismegisto/angular/bubble` (também na raiz)
|
|
194
|
+
|
|
195
|
+
Balão de conteúdo de uma mensagem. Dentro de um `hm-message`, a variante segue o lado da mensagem (`end` → `sent`, `start` → `received`) quando `variant` não é passada.
|
|
196
|
+
|
|
197
|
+
Slots: `(padrão)`
|
|
198
|
+
|
|
199
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
200
|
+
|---|---|---|---|---|
|
|
201
|
+
| `variant` | input | `BubbleVariant \| null` | `null` | Sem valor: segue o `hm-message` em volta (`end` → `sent`); fora de um, `received`. |
|
|
202
|
+
| `reactions` | input | `readonly BubbleReaction[]` | `[]` | |
|
|
203
|
+
| `typing` | input | `boolean` | `false` | Indicador de "digitando" no lugar do conteúdo. |
|
|
204
|
+
| `reactionToggle` | output | `BubbleReaction` | | Clique numa reação (alternância): o app soma ou tira a reação da pessoa. |
|
|
205
|
+
|
|
206
|
+
## `hm-bulk-input`
|
|
207
|
+
|
|
208
|
+
`BulkInputComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/bulk-input` (também na raiz)
|
|
209
|
+
|
|
210
|
+
Entrada em lote: a pessoa cola uma lista (de planilha, chamado, CSV) num textarea e vê, enquanto escreve, quantos itens valem, quantos não valem e quantos vieram repetidos. Os inválidos aparecem listados com o motivo e saem no ×; o valor do campo é só o `string[]` dos válidos.
|
|
211
|
+
|
|
212
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
213
|
+
|---|---|---|---|---|
|
|
214
|
+
| `value` | model | `string[]` | `[]` | Os itens válidos, sem repetição, na ordem em que apareceram. |
|
|
215
|
+
| `label` | input (obrigatório) | `string` | | |
|
|
216
|
+
| `hint` | input | `string` | `''` | Texto de apoio embaixo do campo. |
|
|
217
|
+
| `placeholder` | input | `string` | `''` | |
|
|
218
|
+
| `rows` | input | `number` | `5` | |
|
|
219
|
+
| `labelHidden` | input | `boolean` | `false` | Esconde o rótulo da vista, mantendo-o para o leitor de tela. |
|
|
220
|
+
| `loading` | input | `boolean` | `false` | |
|
|
221
|
+
| `separators` | input | `readonly BulkSeparator[]` | `BULK_DEFAULT_SEPARATORS` | Separadores aceitos. Padrão: quebra de linha, vírgula, ponto e vírgula e tab. |
|
|
222
|
+
| `trim` | input | `boolean` | `true` | Tira espaço das pontas de cada item. |
|
|
223
|
+
| `textCase` | input | `BulkCase` | `'preserve'` | Caixa aplicada a cada item: `preserve`, `lower` ou `upper`. |
|
|
224
|
+
| `ignoreCaseDuplicates` | input | `boolean` | `false` | Repetido sem diferenciar maiúscula de minúscula (fica a 1ª forma escrita). |
|
|
225
|
+
| `validate` | input | `BulkValidator \| null` | `null` | Regex ou função do app; a função pode devolver o motivo em texto (já no idioma do app). |
|
|
226
|
+
| `max` | input | `number \| null` | `null` | Máximo de itens válidos; o excedente vira inválido com o motivo de limite. |
|
|
227
|
+
| `announceDelay` | input | `number` | `800` | Pausa, em ms, antes de anunciar o resumo ao leitor de tela. |
|
|
228
|
+
| `parsed` | output | `BulkParseResult` | | Resultado completo da leitura, a cada mudança do texto. |
|
|
229
|
+
| `disabled` | input (herdado) | `boolean` | `false` | |
|
|
230
|
+
| `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
|
|
231
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
|
|
232
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
|
|
233
|
+
|
|
234
|
+
## `hm-button-group`
|
|
235
|
+
|
|
236
|
+
`ButtonGroupComponent` — import de `@trismegisto/angular/button-group` (também na raiz)
|
|
237
|
+
|
|
238
|
+
Grupo de botões — o `hermes-button-group` do hermes-ui antigo:
|
|
239
|
+
|
|
240
|
+
Slots: `(padrão)`
|
|
241
|
+
|
|
242
|
+
Métodos públicos: `register(button: ButtonComponent): void`, `unregister(button: ButtonComponent): void`
|
|
243
|
+
|
|
244
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
245
|
+
|---|---|---|---|---|
|
|
246
|
+
| `label` | input | `string` | `''` | Nome do grupo para leitor de tela (opcional). |
|
|
247
|
+
| `toggleLabel` | input | `string` | `''` | Vazio = texto do catálogo no idioma ativo (`HERMES_MESSAGES.buttonGroup.more`). |
|
|
248
|
+
| `menuPosition` | input | `DropdownPosition` | `'bottom-right'` | Onde o menu abre (`hermesMenuPosition`). |
|
|
249
|
+
|
|
250
|
+
## `hm-button`
|
|
251
|
+
|
|
252
|
+
`ButtonComponent` — import de `@trismegisto/angular/button` (também na raiz)
|
|
253
|
+
|
|
254
|
+
Slots: `[mark]`, `(padrão)`
|
|
255
|
+
|
|
256
|
+
Métodos públicos: `activateFromMenu(): void`
|
|
257
|
+
|
|
258
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
259
|
+
|---|---|---|---|---|
|
|
260
|
+
| `emphasis` | input | `ButtonEmphasis` | `'high'` | |
|
|
261
|
+
| `intent` | input | `ButtonIntent` | `'primary'` | |
|
|
262
|
+
| `size` | input | `ButtonSize` | `'medium'` | |
|
|
263
|
+
| `type` | input | `'button' \| 'submit'` | `'button'` | `submit` dentro de `<form>`; `button` no resto. Ignorado quando há `link`. |
|
|
264
|
+
| `icon` | input | `string` | `''` | Ícone do hermes-icon antes do rótulo (shape). Decorativo. |
|
|
265
|
+
| `iconDirection` | input | `string` | `''` | hermes-icon direcional (ex.: shape="angle") precisa de `direction` além de `shape`. |
|
|
266
|
+
| `iconEnd` | input | `string` | `''` | |
|
|
267
|
+
| `disabled` | input | `boolean` | `false` | |
|
|
268
|
+
| `loading` | input | `boolean` | `false` | Bloqueia o botão e anuncia a espera por `aria-busy`. Para o ciclo completo de uma ação assíncrona (com spinner e confirmação visual de sucesso/erro), use `load… |
|
|
269
|
+
| `busy` | input | `boolean` | `false` | Depreciado desde 0.2.0 — use `loading` (mesmo nome dos outros componentes). |
|
|
270
|
+
| `loadingState` | input | `HermesLoadingState` | `HermesLoadingState.DEFAULT` | Ciclo completo de uma ação assíncrona: `LOADING` trava a largura atual (evita o botão "pulando" de tamanho) e mostra um spinner; `SUCCESS`/`ERROR` mantêm a lar… |
|
|
271
|
+
| `loadingStateChange` | output | `HermesLoadingState` | | |
|
|
272
|
+
| `block` | input | `boolean` | `false` | Ocupa a largura toda do contêiner. |
|
|
273
|
+
| `link` | input | `string` | `''` | Quando preenchido, a peça vira `<a>` em vez de `<button>` (abre em nova aba, é copiável, entra na lista de links do leitor de tela — o que `<button>` não faz). |
|
|
274
|
+
| `newTab` | input | `boolean` | `false` | |
|
|
275
|
+
| `caret` | input | `boolean` | `false` | Seta de "abre um menu" depois do rótulo — o `dropdown-toggle` antigo (use com `hmDropdownTrigger`). |
|
|
276
|
+
| `inMenu` | input | `boolean` | `false` | Dentro de `hm-button-group`: vai para o menu "…" em vez de ficar na fileira (`hermesInMenu`). |
|
|
277
|
+
| `toggle` | input | `boolean` | `false` | Botão de alternância: cada clique inverte `pressed` e o botão expõe `aria-pressed` (o leitor de tela anuncia "pressionado"/"não pressionado"). Sem `toggle`, `p… |
|
|
278
|
+
| `pressed` | model | `boolean` | `false` | Estado do botão de alternância (só com `toggle`). Two-way: `[(pressed)]`. |
|
|
279
|
+
| `clicked` | output | `void` | | |
|
|
280
|
+
|
|
281
|
+
## `hm-card-container`
|
|
282
|
+
|
|
283
|
+
`CardContainerComponent` — import de `@trismegisto/angular/card-container` (também na raiz)
|
|
284
|
+
|
|
285
|
+
Grade responsiva de cartões (`hm-card` em cada célula): grade navegável, seleção, reordenar por arrasto, mostrar/ocultar e persistência dessas escolhas. `items` é a ordem PADRÃO (filtrar continua sendo do app); a ordem e a visibilidade escolhidas pela pessoa ficam em `[(order)]`/`[(hidden)]` (chaves de `itemKey`).
|
|
286
|
+
|
|
287
|
+
Métodos públicos: `resetLayout(): void`
|
|
288
|
+
|
|
289
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
290
|
+
|---|---|---|---|---|
|
|
291
|
+
| `items` | input | `readonly T[]` | `[]` | Os itens, na ordem PADRÃO (filtrar é do app). A ordem escolhida pela pessoa fica em `order`. |
|
|
292
|
+
| `selection` | input | `CardSelectionMode` | `'none'` | `none` (padrão), `single` ou `multiple`. |
|
|
293
|
+
| `selected` | model | `readonly unknown[]` | `[]` | Chaves selecionadas. Two-way. |
|
|
294
|
+
| `itemKey` | input | `(item: T) => unknown` | `(item: T) => item` | Chave do item (seleção, ordem, visibilidade e `track`). Padrão: o próprio item. |
|
|
295
|
+
| `itemLabel` | input | `((item: T) => string) \| null` | `null` | Nome falado de cada cartão (e o nome na alça e no painel de mostrar/ocultar). Padrão: o texto do cartão. |
|
|
296
|
+
| `itemDisabled` | input | `((item: T) => boolean) \| null` | `null` | Cartão que não pode ser selecionado (continua focável, com `aria-disabled`). |
|
|
297
|
+
| `allowDeselect` | input | `boolean` | `false` | Em `single`, clicar no selecionado tira a seleção. |
|
|
298
|
+
| `label` | input | `string` | `''` | Nome da grade. Vazio = "Cartões" (catálogo). |
|
|
299
|
+
| `minCardWidth` | input | `string` | `''` | Largura mínima de cada cartão (CSS, ex.: `'18rem'`). Vazio = 16rem. |
|
|
300
|
+
| `loading` | input | `boolean` | `false` | Carregando: esqueletos no lugar dos cartões. |
|
|
301
|
+
| `skeletonCount` | input | `number` | `6` | Quantos esqueletos desenhar. |
|
|
302
|
+
| `reorderable` | input | `boolean` | `false` | Mostra o botão "Reordenar cartões" (modo de reordenar por arrasto e teclado). |
|
|
303
|
+
| `hideable` | input | `boolean` | `false` | Mostra o botão "Mostrar ou ocultar cartões" (painel com caixas de marcar e "Restaurar padrão"). |
|
|
304
|
+
| `order` | model | `readonly unknown[]` | `[]` | Ordem escolhida (chaves de `itemKey`). Vazio = a ordem de `items`. Two-way (`orderChange`). |
|
|
305
|
+
| `hidden` | model | `readonly unknown[]` | `[]` | Chaves dos cartões ocultos. Two-way (`hiddenChange`). |
|
|
306
|
+
| `persistKey` | input | `string` | `''` | Guarda ordem e visibilidade com esta chave (vazio = não persiste). |
|
|
307
|
+
| `persistStorage` | input | `CardContainerPersistStorage` | `'local'` | |
|
|
308
|
+
| `visibilityChange` | output | `CardVisibilityChange` | | Um cartão foi mostrado/ocultado pela pessoa (ou reexibido por "Restaurar padrão"). |
|
|
309
|
+
|
|
310
|
+
## `ng-template[hmCardContainerEmpty]`
|
|
311
|
+
|
|
312
|
+
`CardContainerEmptyDirective` — import de `@trismegisto/angular/card-container` (também na raiz)
|
|
313
|
+
|
|
314
|
+
Estado vazio próprio (ilustração, ação): `<ng-template hmCardContainerEmpty>…</ng-template>`.
|
|
315
|
+
|
|
316
|
+
_Sem inputs/outputs._
|
|
317
|
+
|
|
318
|
+
## `ng-template[hmCardContainerItem]`
|
|
319
|
+
|
|
320
|
+
`CardContainerItemDirective` — import de `@trismegisto/angular/card-container` (também na raiz)
|
|
321
|
+
|
|
322
|
+
Conteúdo de cada cartão: `<ng-template hmCardContainerItem let-item>…</ng-template>`.
|
|
323
|
+
|
|
324
|
+
_Sem inputs/outputs._
|
|
325
|
+
|
|
326
|
+
## `hm-card`
|
|
327
|
+
|
|
328
|
+
`CardComponent` — import de `@trismegisto/angular/card` (também na raiz)
|
|
329
|
+
|
|
330
|
+
Contêiner estilizado para agrupar conteúdo relacionado — mídia opcional, cabeçalho opcional (ícone + título + slot `[actions]`), corpo livre (`<ng-content>`) e rodapé opcional (`[footer]`).
|
|
331
|
+
|
|
332
|
+
Slots: `[media]`, `[actions]`, `(padrão)`, `[footer]`
|
|
333
|
+
|
|
334
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
335
|
+
|---|---|---|---|---|
|
|
336
|
+
| `heading` | input | `string` | `''` | |
|
|
337
|
+
| `icon` | input | `string` | `''` | Nome do ícone (@trismegisto/icons), ao lado do título. Decorativo; omitido se `heading` vazio. |
|
|
338
|
+
| `selected` | input | `boolean` | `false` | |
|
|
339
|
+
| `fill` | input | `boolean` | `false` | Card com altura ditada por fora (ex.: `[style.height.px]`, ou um pai `display: grid` com `align-items: stretch`) cujo corpo deve ocupar o espaço restante depoi… |
|
|
340
|
+
| `media` | input | `string` | `''` | URL da imagem de mídia. Vazio = sem imagem (o slot `[media]` continua valendo). |
|
|
341
|
+
| `mediaAlt` | input | `string` | `''` | O que a imagem mostra, para quem não a vê. Obrigatório quando a imagem informa algo. |
|
|
342
|
+
| `mediaDecorative` | input | `boolean` | `false` | A imagem é só ilustração (não acrescenta informação ao texto): sai com `alt=""`. |
|
|
343
|
+
| `mediaPosition` | input | `CardMediaPosition` | `'top'` | `top` (padrão), ou coluna lateral `start`/`end` — vira topo quando o card fica estreito. |
|
|
344
|
+
|
|
345
|
+
## `hm-carousel`
|
|
346
|
+
|
|
347
|
+
`CarouselComponent` — import de `@trismegisto/angular/carousel` (também na raiz)
|
|
348
|
+
|
|
349
|
+
Carrossel de slides com imagem e texto, navegável por botão, marcador, seta do teclado e arrasto. Só apresentação: recebe os slides prontos e não sabe de onde vieram.
|
|
350
|
+
|
|
351
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
352
|
+
|---|---|---|---|---|
|
|
353
|
+
| `label` | input (obrigatório) | `string` | | Nome da região, lido antes do conteúdo por leitor de tela. |
|
|
354
|
+
| `slides` | input (obrigatório) | `readonly CarouselSlide[]` | | |
|
|
355
|
+
| `interval` | input | `number` | `0` | Milissegundos entre trocas automáticas. `0` deixa o avanço só no comando de quem usa. |
|
|
356
|
+
|
|
357
|
+
## `hm-certificate-viewer`
|
|
358
|
+
|
|
359
|
+
`CertificateViewerComponent` — import de `@trismegisto/angular/certificate-viewer` (também na raiz)
|
|
360
|
+
|
|
361
|
+
Visualizador de certificado X.509: o app entrega o certificado **já interpretado** (`CertificateInfo`, de `@trismegisto/primitives`; quem lê o PEM/DER é o servidor ou uma lib como `pkijs`) e o componente só apresenta.
|
|
362
|
+
|
|
363
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
364
|
+
|---|---|---|---|---|
|
|
365
|
+
| `certificate` | input | `CertificateInfo \| null` | `null` | O certificado mostrado quando não há `chain`. |
|
|
366
|
+
| `chain` | input | `readonly CertificateInfo[]` | `[]` | Cadeia do certificado final (`[0]`) até a raiz. Com 2+ itens, aparece a lista navegável. |
|
|
367
|
+
| `selectedIndex` | model | `number` | `0` | Posição (em `chain`) do certificado em exibição. Two-way. |
|
|
368
|
+
| `headingLevel` | input | `CertificateViewerHeadingLevel` | `2` | Nível do título do componente; as seções usam o nível seguinte (até 6). |
|
|
369
|
+
| `heading` | input | `string` | `''` | Título. Padrão: "Certificado: {CN}" do catálogo. |
|
|
370
|
+
| `warningDays` | input | | `CERTIFICATE_WARNING_DAYS` | A partir de quantos dias para o vencimento a situação vira "vence em N dias". |
|
|
371
|
+
| `referenceDate` | input | `CertificateDate \| null` | `null` | Data de referência da situação de validade (padrão: agora). |
|
|
372
|
+
|
|
373
|
+
## `hm-checkbox-group`
|
|
374
|
+
|
|
375
|
+
`CheckboxGroupComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/checkbox-group` (também na raiz)
|
|
376
|
+
|
|
377
|
+
Grupo de caixas de seleção com valor `string[]` (os `value` marcados, na ordem das `options`). Mesmo contrato dos outros controles: Reactive Forms, `[(ngModel)]` ou `[(value)]` (ver `HermesFormFieldBase`).
|
|
378
|
+
|
|
379
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
380
|
+
|---|---|---|---|---|
|
|
381
|
+
| `value` | model | `readonly string[] \| null` | `[]` | Two-way sem formulário: os valores marcados. |
|
|
382
|
+
| `label` | input (obrigatório) | `string` | | Rótulo do grupo (a `<legend>`). |
|
|
383
|
+
| `options` | input (obrigatório) | `readonly CheckboxGroupOption[]` | | |
|
|
384
|
+
| `layout` | input | `CheckboxGroupLayout \| undefined` | `undefined` | Ver `CheckboxGroupLayout`. Sem padrão literal: vazio = `'stacked'`. |
|
|
385
|
+
| `hint` | input | `string` | `''` | Texto de apoio embaixo do grupo. |
|
|
386
|
+
| `disabled` | input (herdado) | `boolean` | `false` | |
|
|
387
|
+
| `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
|
|
388
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
|
|
389
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
|
|
390
|
+
|
|
391
|
+
## `hm-checkbox`
|
|
392
|
+
|
|
393
|
+
`CheckboxComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/checkbox` (também na raiz)
|
|
394
|
+
|
|
395
|
+
Checkbox com rótulo clicável e o visual `.hm-check` (o mesmo do hm-tree e da seleção do data-grid). Mesmo contrato dos outros controles: Reactive Forms, `[(ngModel)]` ou `[(checked)]` (ver `HermesFormFieldBase`).
|
|
396
|
+
|
|
397
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
398
|
+
|---|---|---|---|---|
|
|
399
|
+
| `label` | input (obrigatório) | `string` | | |
|
|
400
|
+
| `labelHidden` | input | `boolean` | `false` | Esconde o rótulo visualmente (continua sendo o nome acessível). |
|
|
401
|
+
| `checked` | model | `boolean` | `false` | Two-way sem formulário. |
|
|
402
|
+
| `indeterminate` | input | `boolean` | `false` | |
|
|
403
|
+
| `disabled` | input (herdado) | `boolean` | `false` | |
|
|
404
|
+
| `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
|
|
405
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
|
|
406
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
|
|
407
|
+
|
|
408
|
+
## `hm-chip-group`
|
|
409
|
+
|
|
410
|
+
`ChipGroupComponent` — import de `@trismegisto/angular/chip` (também na raiz)
|
|
411
|
+
|
|
412
|
+
Grupo de fichas de filtro (`hm-chip-group`): uma fileira de `hm-chip` alternáveis que liga e desliga filtros de uma lista — o padrão de *filter chips* do Material e do Carbon. Cada ficha dentro dele precisa de `value`; o grupo guarda quais estão ligadas em `[(value)]`.
|
|
413
|
+
|
|
414
|
+
Slots: `(padrão)`
|
|
415
|
+
|
|
416
|
+
Métodos públicos: `isSelected(value: string): boolean`, `isDisabled(): boolean`, `toggle(value: string): void`
|
|
417
|
+
|
|
418
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
419
|
+
|---|---|---|---|---|
|
|
420
|
+
| `label` | input | `string` | `''` | Nome do grupo para leitor de tela. Vazio usa `chip.group` do catálogo ("Filtros"). |
|
|
421
|
+
| `multiple` | input | `boolean` | `true` | `false` = escolha única (ligar uma ficha desliga as outras). |
|
|
422
|
+
| `disabled` | input | `boolean` | `false` | Desabilita todas as fichas do grupo. |
|
|
423
|
+
| `value` | model | `readonly string[]` | `[]` | Valores (`value` de cada ficha) ligados agora. Two-way. |
|
|
424
|
+
|
|
425
|
+
## `hm-chip`
|
|
426
|
+
|
|
427
|
+
`ChipComponent` — import de `@trismegisto/angular/chip` (também na raiz)
|
|
428
|
+
|
|
429
|
+
Ficha (pílula) que representa **um item já escolhido** dentro de um conjunto que a pessoa montou: os valores de uma escolha múltipla, os filtros aplicados a uma tabela, as contas de um lote. Comportamento de mercado (MUI Chip, Material input chip): com `removable`, um ✕ desfaz aquela escolha em um gesto.
|
|
430
|
+
|
|
431
|
+
Slots: `(padrão)`
|
|
432
|
+
|
|
433
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
434
|
+
|---|---|---|---|---|
|
|
435
|
+
| `label` | input | `string` | `''` | O que a ficha representa. Vazio usa o conteúdo projetado. |
|
|
436
|
+
| `removable` | input | `boolean` | `false` | Mostra o ✕ que emite `removed`. |
|
|
437
|
+
| `disabled` | input | `boolean` | `false` | Desabilita o ✕ (e o Backspace/Delete); a ficha continua legível. |
|
|
438
|
+
| `icon` | input | `string` | `''` | Ícone opcional antes do rótulo (nome do catálogo de ícones). |
|
|
439
|
+
| `variant` | input | `ChipVariant` | `'outlined'` | |
|
|
440
|
+
| `size` | input | `ChipSize` | `'medium'` | |
|
|
441
|
+
| `removeLabel` | input | `string` | `''` | Nome acessível do ✕ inteiro; vazio usa `chip.remove` do catálogo com o rótulo. |
|
|
442
|
+
| `selectable` | input | `boolean` | `false` | Torna a ficha um botão de alternar (`aria-pressed`). Dentro de `hm-chip-group` já é. |
|
|
443
|
+
| `selected` | model | `boolean` | `false` | Ligada/desligada (two-way). Fora de grupo é a fonte do estado; dentro, espelha o grupo. |
|
|
444
|
+
| `value` | input | `string` | `''` | Identifica a ficha dentro de `hm-chip-group` (é o que entra no `value` do grupo). |
|
|
445
|
+
| `removed` | output | `void` | | O ✕ foi acionado (clique, Enter/Espaço ou Backspace/Delete). Quem escuta remove o item. |
|
|
446
|
+
|
|
447
|
+
## `hm-code-input`
|
|
448
|
+
|
|
449
|
+
`CodeInputComponent` · `ControlValueAccessor` — import de `@trismegisto/angular/code-input` (também na raiz)
|
|
450
|
+
|
|
451
|
+
N caixas de dígito único, com avanço automático ao digitar e retrocesso ao apagar/Backspace numa célula vazia — mesmo comportamento de `mfa.component` (verificação de código), extraído pra cá pra `configure.component` (confirmação do TOTP) usar o mesmo widget em vez de duplicar a lógica. Implementa ControlValueAccessor (usa com [formControl]/formControlName) e também emite `completed` quando toda…
|
|
452
|
+
|
|
453
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
454
|
+
|---|---|---|---|---|
|
|
455
|
+
| `length` | input | `number` | `6` | |
|
|
456
|
+
| `completed` | output | `string` | | |
|
|
457
|
+
|
|
458
|
+
## `hm-combobox-multi`
|
|
459
|
+
|
|
460
|
+
`ComboboxMultiComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/combobox-multi` (também na raiz)
|
|
461
|
+
|
|
462
|
+
Escolha de VÁRIAS opções entre muitas, digitando para filtrar — o `hm-combobox` com seleção múltipla, com três diferenças do single que o padrão de multisseleção da WAI-ARIA exige: (1) a lista NÃO fecha ao escolher — quem marca vários espera continuar; (2) o campo é `readonly` — o escolhido vira ficha removível antes dele, e a busca mora dentro do popover, não no campo (digitar ali disputaria esp…
|
|
463
|
+
|
|
464
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
465
|
+
|---|---|---|---|---|
|
|
466
|
+
| `label` | input (obrigatório) | `string` | | |
|
|
467
|
+
| `options` | input (obrigatório) | `readonly ComboboxOption[]` | | |
|
|
468
|
+
| `selected` | model | `readonly string[]` | `[]` | Valores escolhidos, na ORDEM em que foram escolhidos — as fichas seguem essa ordem, não a da lista. |
|
|
469
|
+
| `extraOptions` | input | `readonly ComboboxOption[]` | `[]` | Rótulos de valores que podem estar escolhidos mas não são mais oferecidos na lista — dão nome à ficha sem aparecer como opção (outro papel, por exemplo); a fic… |
|
|
470
|
+
| `unknownLabel` | input | `string` | `''` | O que a ficha mostra quando o valor não está nem nas opções nem em `extraOptions`. Vazio (o padrão) mostra o próprio valor — serve a um valor já legível, não a… |
|
|
471
|
+
| `placeholder` | input | `string` | `''` | |
|
|
472
|
+
| `hint` | input | `string` | `''` | Texto de apoio embaixo do campo. |
|
|
473
|
+
| `help` | input | `string` | `''` | Depreciado desde 0.2.0 — use `hint`. |
|
|
474
|
+
| `max` | input | `number \| null` | `null` | Teto de escolhas; `null` não limita. Atingido, o resto da lista desabilita. |
|
|
475
|
+
| `visibleChipsLimit` | input | `number \| null` | `1` | Quantas fichas aparecem fechado antes de o resto virar "+N". `null` mostra todas. |
|
|
476
|
+
| `disabled` | input (herdado) | `boolean` | `false` | |
|
|
477
|
+
| `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
|
|
478
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
|
|
479
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
|
|
480
|
+
|
|
481
|
+
## `hm-combobox`
|
|
482
|
+
|
|
483
|
+
`ComboboxComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/combobox` (também na raiz)
|
|
484
|
+
|
|
485
|
+
Escolha de uma opção entre muitas, digitando para filtrar — padrão combobox da WAI-ARIA 1.2. O posicionamento do popover reaproveita `placeDirect`/`placeWithin` e o "move pro `<body>` ao abrir" do `hm-menu` (mesma técnica, escapa de `overflow`/`transform` de qualquer ancestral — inclusive um `hm-modal`/`hm-drawer` por cima), e o erro de validação reaproveita `resolveFieldError`, o mesmo que o `hm…
|
|
486
|
+
|
|
487
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
488
|
+
|---|---|---|---|---|
|
|
489
|
+
| `label` | input (obrigatório) | `string` | | |
|
|
490
|
+
| `options` | input (obrigatório) | `readonly ComboboxOption[]` | | |
|
|
491
|
+
| `value` | model | `string` | `''` | `''` = nenhuma escolha. Two-way sem formulário; com formulário, o controle é a fonte. |
|
|
492
|
+
| `placeholder` | input | `string` | `''` | |
|
|
493
|
+
| `icon` | input | `string` | `''` | |
|
|
494
|
+
| `hint` | input | `string` | `''` | Texto de apoio embaixo do campo. |
|
|
495
|
+
| `help` | input | `string` | `''` | Depreciado desde 0.2.0 — use `hint`. |
|
|
496
|
+
| `size` | input | `ComboboxSize` | `'medium'` | |
|
|
497
|
+
| `labelHidden` | input | `boolean` | `false` | Esconde o rótulo da vista, mantendo-o para o leitor de tela — o nome da coluna de uma tabela. |
|
|
498
|
+
| `clearable` | input | `boolean` | `false` | Botão de limpar quando há escolha — só faz sentido se a escolha for opcional. |
|
|
499
|
+
| `requiredManual` | input | `boolean` | `false` | Depreciado desde 0.2.0 — use `required`. |
|
|
500
|
+
| `loading` | input | `boolean` | `false` | |
|
|
501
|
+
| `allowCustomValue` | input | `boolean` | `false` | Aceita texto livre (padrão `<datalist>`): as opções viram sugestões e o valor pode ser qualquer texto digitado. Padrão `false` — só valores da lista. |
|
|
502
|
+
| `disabled` | input (herdado) | `boolean` | `false` | |
|
|
503
|
+
| `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
|
|
504
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
|
|
505
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
|
|
506
|
+
|
|
507
|
+
## `hm-command-palette`
|
|
508
|
+
|
|
509
|
+
`CommandPaletteComponent` — import de `@trismegisto/angular/command-palette` (também na raiz)
|
|
510
|
+
|
|
511
|
+
Paleta de comandos: um diálogo com busca e a lista de comandos em grupos (`Mod+K` costuma abrir). Só o contêiner genérico — os comandos vêm do app. Comportamento de paleta de mercado (VS Code, cmdk).
|
|
512
|
+
|
|
513
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
514
|
+
|---|---|---|---|---|
|
|
515
|
+
| `open` | model | `boolean` | `false` | Visibilidade. Two-way. |
|
|
516
|
+
| `commands` | input | `readonly HermesCommand[]` | `[]` | |
|
|
517
|
+
| `shortcut` | input | `string \| readonly string[]` | `''` | Atalho que abre/fecha a paleta (ex.: `'Mod+K'`). Vazio = o app abre por `[(open)]`. |
|
|
518
|
+
| `label` | input | `string` | `''` | Nome do diálogo. Vazio = catálogo (`commandPalette.label`). |
|
|
519
|
+
| `placeholder` | input | `string` | `''` | Vazio = catálogo (`commandPalette.placeholder`). |
|
|
520
|
+
| `recentLimit` | input | `number` | `0` | Quantos recentes mostrar no topo (busca vazia). 0 = sem recentes. |
|
|
521
|
+
| `recentIds` | model | `readonly string[]` | `[]` | Ids dos recentes, do mais novo ao mais antigo. Two-way, para o app persistir. |
|
|
522
|
+
| `closeOnRun` | input | `boolean` | `true` | Fecha depois de executar. |
|
|
523
|
+
| `executed` | output | `HermesCommand` | | O comando terminou (depois da Promise, se houver). |
|
|
524
|
+
|
|
525
|
+
## `hm-palette-shell`
|
|
526
|
+
|
|
527
|
+
`PaletteShellComponent` — import de `@trismegisto/angular/command-palette`
|
|
528
|
+
|
|
529
|
+
Contêiner comum da paleta de comandos e da busca global (interno, não exportado): diálogo modal ancorado no alto, com um campo (`role="combobox"`) e a lista (`role="listbox"`) em grupos — padrão WAI-ARIA APG "Combobox" com listbox dentro de diálogo. A opção ativa é indicada por `aria-activedescendant` (o foco fica no campo); setas andam e dão a volta, `PageUp`/`PageDown` pulam, `Enter` escolhe, `…
|
|
530
|
+
|
|
531
|
+
Métodos públicos: `close(): void`
|
|
532
|
+
|
|
533
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
534
|
+
|---|---|---|---|---|
|
|
535
|
+
| `open` | model | `boolean` | `false` | |
|
|
536
|
+
| `query` | model | `string` | `''` | |
|
|
537
|
+
| `groups` | input | `readonly PaletteGroupView[]` | `[]` | |
|
|
538
|
+
| `label` | input | `string` | `''` | |
|
|
539
|
+
| `inputLabel` | input | `string` | `''` | |
|
|
540
|
+
| `placeholder` | input | `string` | `''` | |
|
|
541
|
+
| `hint` | input | `string` | `''` | |
|
|
542
|
+
| `statusKind` | input | `PaletteStatusKind` | `''` | |
|
|
543
|
+
| `statusText` | input | `string` | `''` | |
|
|
544
|
+
| `retryLabel` | input | `string` | `''` | |
|
|
545
|
+
| `announcement` | input | `string` | `''` | Texto da região viva (contagem, executando, falhou). |
|
|
546
|
+
| `extraClass` | input | `string` | `''` | Classe extra no contêiner (a busca global acrescenta a dela). |
|
|
547
|
+
| `activate` | output | `number` | | Índice (na lista achatada) da opção escolhida por Enter ou clique. |
|
|
548
|
+
| `retry` | output | `void` | | |
|
|
549
|
+
| `dismissed` | output | `void` | | Fechou por Esc ou clique fora. |
|
|
550
|
+
|
|
551
|
+
## `hm-copy-button`
|
|
552
|
+
|
|
553
|
+
`CopyButtonComponent` — import de `@trismegisto/angular/copy-button` (também na raiz)
|
|
554
|
+
|
|
555
|
+
Botão que copia `value` para a área de transferência e confirma que copiou. Comportamento no padrão de mercado (MUI/Primer `ClipboardCopyButton`).
|
|
556
|
+
|
|
557
|
+
Métodos públicos: `copy(): Promise<boolean>`
|
|
558
|
+
|
|
559
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
560
|
+
|---|---|---|---|---|
|
|
561
|
+
| `value` | input (obrigatório) | `string` | | Texto que vai para a área de transferência. |
|
|
562
|
+
| `label` | input (obrigatório) | `string` | | Nome da ação ("Copiar token"). Na variante `icon`, é o `aria-label`; na `text`, o texto visível. |
|
|
563
|
+
| `copiedLabel` | input | `string` | `''` | Texto da confirmação. Vazio = catálogo ("Copiado"). |
|
|
564
|
+
| `variant` | input | `CopyButtonVariant` | `'icon'` | |
|
|
565
|
+
| `size` | input | `ButtonSize` | `'medium'` | |
|
|
566
|
+
| `disabled` | input | `boolean` | `false` | |
|
|
567
|
+
| `feedbackDuration` | input | `number` | `2000` | Quanto tempo (ms) o estado "copiado"/"falhou" fica visível antes de voltar ao normal. |
|
|
568
|
+
| `copied` | output | `string` | | Copiou: emite o texto copiado. |
|
|
569
|
+
| `copyFailed` | output | `unknown` | | Nenhuma das duas vias conseguiu copiar: emite o erro original (ou `null`, sem erro lançado). |
|
|
570
|
+
|
|
571
|
+
## `hm-data-grid-action-bar`
|
|
572
|
+
|
|
573
|
+
`DataGridActionBarComponent` — import de `@trismegisto/angular/data-grid` (também na raiz)
|
|
574
|
+
|
|
575
|
+
Barra de ações do grid: busca + o que a tela quiser projetar ao lado (botão "Novo", um filtro próprio do domínio...). `hm-data-grid` já compõe uma por padrão (ver seu input `filterable`) — esta peça existe separada pra quem monta a própria barra (`[filterable]="false"` no grid) e só quer o mesmo visual de busca com ações ao lado, sem reimplementar o campo do zero.
|
|
576
|
+
|
|
577
|
+
Slots: `(padrão)`
|
|
578
|
+
|
|
579
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
580
|
+
|---|---|---|---|---|
|
|
581
|
+
| `search` | model | `string` | `''` | Termo de busca, em two-way — `hm-data-grid` liga isto direto no próprio `searchTerm`. |
|
|
582
|
+
| `placeholder` | input | `string` | `''` | |
|
|
583
|
+
| `label` | input | `string` | `''` | Rótulo acessível do campo; vazio cai no texto padrão (`HERMES_MESSAGES`). |
|
|
584
|
+
|
|
585
|
+
## `ng-template[hmCell]`
|
|
586
|
+
|
|
587
|
+
`DataGridCellDirective` — import de `@trismegisto/angular/data-grid` (também na raiz)
|
|
588
|
+
|
|
589
|
+
Troca o desenho de uma célula por um template projetado, sem trocar o DADO dela: `value()` continua existindo e é ele que a busca/ordenação leem — uma coluna de checkbox com `value: (r) => r.enabled ? 'Yes' : 'No'` continua filtrável por "Yes" e ordenável como qualquer outra.
|
|
590
|
+
|
|
591
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
592
|
+
|---|---|---|---|---|
|
|
593
|
+
| `hmCell` | input (obrigatório) | `string` | | |
|
|
594
|
+
|
|
595
|
+
## `hm-data-grid-column-filter`
|
|
596
|
+
|
|
597
|
+
`DataGridColumnFilterComponent` — import de `@trismegisto/angular/data-grid` (também na raiz)
|
|
598
|
+
|
|
599
|
+
Pop-over de filtro de UMA coluna do `hm-data-grid`: lista de marcar (coluna categórica — `options` não nulo) ou campo de texto livre (senão). Mesma infraestrutura de posicionamento do `hm-menu` (`placeDirect`/`placeWithin`, cartão movido pro `<body>` ao abrir) — não duplicada por acaso, ver o comentário lá: o cartão precisa escapar de `overflow`/contexto de empilhamento do mesmo jeito, e é o mesm…
|
|
600
|
+
|
|
601
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
602
|
+
|---|---|---|---|---|
|
|
603
|
+
| `anchor` | input (obrigatório) | `PopoverAnchor \| null` | | Coordenada da viewport; `null` = fechado. |
|
|
604
|
+
| `label` | input (obrigatório) | `string` | | Nome da coluna, pro rótulo acessível do cartão e do campo. |
|
|
605
|
+
| `options` | input | `readonly GridFilterOption[] \| null` | `null` | Não-nulo: a coluna é categórica, o cartão vira lista de marcar. Nulo: campo de texto livre. |
|
|
606
|
+
| `term` | input | `string` | `''` | |
|
|
607
|
+
| `values` | input | `readonly string[]` | `[]` | |
|
|
608
|
+
| `termChanged` | output | `string` | | |
|
|
609
|
+
| `valuesChanged` | output | `readonly string[]` | | |
|
|
610
|
+
| `cleared` | output | `void` | | |
|
|
611
|
+
| `closed` | output | `void` | | |
|
|
612
|
+
|
|
613
|
+
## `ng-template[hmColumnHeader]`
|
|
614
|
+
|
|
615
|
+
`DataGridHeaderDirective` — import de `@trismegisto/angular/data-grid` (também na raiz)
|
|
616
|
+
|
|
617
|
+
Troca o desenho do TÍTULO de uma coluna (não a célula) por um template projetado — pra um cabeçalho com mais que texto (um ícone de ajuda, um resumo). `<ng-template hmColumnHeader="chave">...</ng-template>` — dentro de `<hm-data-grid>`.
|
|
618
|
+
|
|
619
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
620
|
+
|---|---|---|---|---|
|
|
621
|
+
| `hmColumnHeader` | input (obrigatório) | `string` | | |
|
|
622
|
+
|
|
623
|
+
## `hm-data-grid`
|
|
624
|
+
|
|
625
|
+
`DataGridComponent` — import de `@trismegisto/angular/data-grid` (também na raiz)
|
|
626
|
+
|
|
627
|
+
Grid de listagem: cabeçalho ordenável, redimensionável por arrasto (a ordem das colunas é a que `columns()` define — a tela decide, não quem usa), detalhe de linha expansível, ações por linha, busca + filtro por coluna, paginação (com rodapé embutido, cliente OU servidor — ver `totalItems`) e os estados de carregando/erro/vazio.
|
|
628
|
+
|
|
629
|
+
Slots: `[dataGridActions]`
|
|
630
|
+
|
|
631
|
+
Templates no conteúdo: `<ng-template #detail>`, `<ng-template #detailPane>`, `<ng-template #detailPaneHeader>`, `<ng-template #footerDescription>`
|
|
632
|
+
|
|
633
|
+
Métodos públicos: `exportCsv(options: DataGridExportOptions = {}): string`, `clearPersistedState(): void`
|
|
634
|
+
|
|
635
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
636
|
+
|---|---|---|---|---|
|
|
637
|
+
| `columns` | input (obrigatório) | `readonly GridColumn<T>[]` | | |
|
|
638
|
+
| `rows` | input (obrigatório) | `readonly T[]` | | |
|
|
639
|
+
| `rowId` | input (obrigatório) | `(row: T) => string` | | Chave estável de cada registro, usada no `track` do `@for`. |
|
|
640
|
+
| `caption` | input (obrigatório) | `string` | | Descrição do grid pra leitor de tela — vira o `<caption>`. |
|
|
641
|
+
| `rowActions` | input | `readonly DataGridRowAction<T>[]` | `[]` | |
|
|
642
|
+
| `loading` | input | `boolean` | `false` | |
|
|
643
|
+
| `error` | input | `string` | `''` | |
|
|
644
|
+
| `emptyMessage` | input | `string` | `''` | Vazio quando não há filtro nenhum: cai no texto padrão (`HERMES_MESSAGES`). |
|
|
645
|
+
| `noResultsMessage` | input | `string` | `''` | Vazio quando o FILTRO não achou nada — texto diferente de "não há nada". |
|
|
646
|
+
| `filterable` | input | `boolean` | `true` | A barra de ações (busca + o que a tela projetar) acima do grid. |
|
|
647
|
+
| `paginated` | input | `boolean` | `true` | Corta os registros em páginas por dentro, depois de filtrar. Desligue (`false`) quando `rows()` já vier paginado por quem busca os dados (paginação no servidor… |
|
|
648
|
+
| `pageState` | model | `PaginationState` | `INITIAL_PAGE` | |
|
|
649
|
+
| `pagination` | input | `boolean` | `true` | Mostra o rodapé de paginação, independente de `paginated` — desligue só pra uma lista embutida que nunca pagina (não é o caso comum: mesmo servidor-driven quer… |
|
|
650
|
+
| `totalItems` | input | `number \| null` | `null` | Total de registros pro rodapé, quando `paginated` é `false` (o servidor sabe o total, a grade só vê a página atual em `rows()`). Sem isto nesse modo, o rodapé… |
|
|
651
|
+
| `sort` | model | `readonly GridSort[]` | `[]` | |
|
|
652
|
+
| `selectable` | input | `boolean` | `false` | Atalho de `selectionMode="multiple"` (checkbox por linha + selecionar a página). |
|
|
653
|
+
| `selectionMode` | input | `DataGridSelectionMode` | `'none'` | `'single'` = rádio por linha (uma só); `'multiple'` = checkbox. `'none'` + `selectable` = `'multiple'`. |
|
|
654
|
+
| `selection` | model | `GridSelection` | `EMPTY_SELECTION` | |
|
|
655
|
+
| `rowSelectable` | input | `((row: T) => boolean) \| null` | `null` | Trava por linha: `false` = a linha não pode ser selecionada (controle desativado). `null` = todas. |
|
|
656
|
+
| `rowSelectableReason` | input | `((row: T) => string) \| null` | `null` | Motivo de a linha estar travada (anunciado com o controle e mostrado no `title` da célula). |
|
|
657
|
+
| `rowDetailDisabled` | input | `((row: T) => boolean) \| null` | `null` | Detalhe desta linha desativado: o botão aparece, mas `disabled`. |
|
|
658
|
+
| `rowDetailHidden` | input | `((row: T) => boolean) \| null` | `null` | Detalhe desta linha oculto: sem botão e sem detalhe. Vence `rowDetailDisabled`. |
|
|
659
|
+
| `virtual` | input | `boolean` | `false` | Rolagem virtual: desenha só as linhas visíveis (+ folga). Use com `[paginated]="false"`. |
|
|
660
|
+
| `rowHeight` | input | `number` | `40` | Altura estimada de uma linha (px), usada até a linha ser medida. |
|
|
661
|
+
| `pinnedColumns` | model | `GridPinnedColumns` | `NO_PINNED_COLUMNS` | Fixação escolhida pela pessoa, por chave (`'start'`/`'end'`; `null` desafixa); vazio = o `pinned` das definições. O gerenciador de colunas escreve aqui. |
|
|
662
|
+
| `columnState` | model | `readonly GridColumnState[]` | `[]` | Preferência de LARGURA de coluna, em two-way. Vazio = a própria grade semeia o estado inicial (ver `constructor`) a partir da largura renderizada — arrastar o… |
|
|
663
|
+
| `pageSizes` | input | `readonly number[]` | `[10, 25, 50, 100]` | Opções de itens-por-página do `hm-paginator` embutido — mesmo padrão dele (`[10, 25, 50, 100]`), sobrescrevível por grid (ex.: uma lista curta que nunca precis… |
|
|
664
|
+
| `fillHeight` | input | `boolean` | `false` | |
|
|
665
|
+
| `maxHeight` | input | `string` | `''` | |
|
|
666
|
+
| `bordered` | input | `boolean` | `false` | Divisória visível entre colunas e linhas — desligada por padrão. |
|
|
667
|
+
| `rowState` | input | `(row: T) => DataGridRowState \| null` | `() => null` | |
|
|
668
|
+
| `rowClickable` | input | `boolean` | `false` | |
|
|
669
|
+
| `actionTriggered` | output | `DataGridActionTriggered<T>` | | |
|
|
670
|
+
| `detailToggled` | output | `{ row: T; open: boolean }` | | |
|
|
671
|
+
| `rowClicked` | output | `T` | | |
|
|
672
|
+
| `clearFiltersRequested` | output | `void` | | |
|
|
673
|
+
| `filteredChange` | output | `readonly T[]` | | Os registros que sobraram depois do filtro — pra contagem/exportação fora da grade. |
|
|
674
|
+
| `remoteSearch` | input | `boolean` | `false` | A busca da barra pergunta ao servidor em vez de recortar o que já veio (grid grande demais pro navegador). A grade continua dona do campo (`searchTerm`); escut… |
|
|
675
|
+
| `searchTermChanged` | output | `string` | | |
|
|
676
|
+
| `remoteSort` | input | `boolean` | `false` | Mesmo raciocínio de `remoteSearch`, pra ordenação: o grid ordena `rows` sozinho por padrão (asc/desc/desempate, por tipo de coluna) — desligue quando `rows` já… |
|
|
677
|
+
| `itemsLabel` | input | `string` | `''` | Rodapé: o que vem depois da contagem ("1 - 10 de 42 <itemsLabel>"). Padrão: "itens". |
|
|
678
|
+
| `pageSizeLabel` | input | `string` | `''` | Rodapé: rótulo do seletor de itens por página. Padrão: "por página". |
|
|
679
|
+
| `exportable` | input | `boolean` | `false` | Botão "Exportar" (CSV / Excel) na barra de ações. Por código: `exportCsv()`. |
|
|
680
|
+
| `exportFileName` | input | `string` | `''` | Nome do arquivo exportado (sem extensão). Padrão: o `caption`. |
|
|
681
|
+
| `groupBy` | model | `string \| null` | `null` | Agrupa pela coluna desta chave (`null` = sem grupo). Two-way para um seletor de agrupamento. |
|
|
682
|
+
| `aggregates` | input | `GridAggregates` | `{}` | Agregação por coluna (`{ total: 'sum' }`): rodapé de totais e linha de cada grupo. |
|
|
683
|
+
| `aggregateFormatter` | input | `GridAggregateFormatter \| null` | `null` | Formata o agregado (moeda, unidade); sem ele, número no formato do idioma. |
|
|
684
|
+
| `persistKey` | input | `string` | `''` | Persiste o estado da grade com esta chave (vazio = não persiste). |
|
|
685
|
+
| `persistStorage` | input | `DataGridPersistStorage` | `'local'` | |
|
|
686
|
+
| `advancedFilter` | input | `boolean` | `false` | Filtro composto (botão "Filtro avançado" na barra). |
|
|
687
|
+
| `filterQuery` | model | `GridFilterQuery` | `EMPTY_GRID_QUERY` | |
|
|
688
|
+
| `columnManager` | input | `boolean` | `false` | Gerenciador de colunas (botão na barra; substitui o seletor de colunas do rodapé). |
|
|
689
|
+
| `columnOrder` | model | `readonly string[]` | `[]` | Ordem das colunas escolhida no gerenciador (chaves); vazio = a ordem de `columns()`. |
|
|
690
|
+
| `detailPaneToggled` | output | `{ row: T; open: boolean }` | | Abriu/fechou o detail pane. |
|
|
691
|
+
|
|
692
|
+
## `hm-calendar`
|
|
693
|
+
|
|
694
|
+
`CalendarComponent` — import de `@trismegisto/angular/date-picker` (também na raiz)
|
|
695
|
+
|
|
696
|
+
Calendário do hm-date-picker/hm-date-range-picker (o `hermes-calendar` antigo: dias, meses e anos). Grade de dias no padrão ARIA de date picker: uma `table role="grid"`, um só botão focável por vez (roving tabindex), setas andam dias/semanas, PageUp/PageDown meses (+Shift: anos), Home/End início/fim da semana, Enter/Espaço escolhe.
|
|
697
|
+
|
|
698
|
+
Métodos públicos: `focusNow(): void`, `focusActive(): void`
|
|
699
|
+
|
|
700
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
701
|
+
|---|---|---|---|---|
|
|
702
|
+
| `selected` | input | `IsoDate \| null` | `null` | |
|
|
703
|
+
| `rangeStart` | input | `IsoDate \| null` | `null` | Modo intervalo: as duas pontas e (enquanto escolhe o fim) a prévia sob o ponteiro. |
|
|
704
|
+
| `rangeEnd` | input | `IsoDate \| null` | `null` | |
|
|
705
|
+
| `min` | input | `IsoDate \| null` | `null` | |
|
|
706
|
+
| `max` | input | `IsoDate \| null` | `null` | |
|
|
707
|
+
| `picked` | output | `IsoDate` | | |
|
|
708
|
+
| `cleared` | output | `void` | | |
|
|
709
|
+
|
|
710
|
+
## `hm-date-picker`
|
|
711
|
+
|
|
712
|
+
`DatePickerComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/date-picker` (também na raiz)
|
|
713
|
+
|
|
714
|
+
Campo de data — o `hermes-date-container` + `hermesDate` do hermes-ui antigo, no visual do hm-field. Digita-se `dd/mm/aaaa` (a máscara põe as barras) ou escolhe-se no calendário (botão ao lado; dias, meses e anos; Hoje/Limpar). O VALOR é ISO `AAAA-MM-DD` — o mesmo do `<input type="date">` que ele substitui, então trocar um pelo outro não muda o formulário.
|
|
715
|
+
|
|
716
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
717
|
+
|---|---|---|---|---|
|
|
718
|
+
| `value` | model | `string \| null` | `null` | |
|
|
719
|
+
| `label` | input (obrigatório) | `string` | | |
|
|
720
|
+
| `labelHidden` | input | `boolean` | `false` | |
|
|
721
|
+
| `hint` | input | `string` | `''` | Texto de apoio embaixo do campo (ex.: "Ativação + 1 ano (automático)"). |
|
|
722
|
+
| `placeholder` | input | `string` | `''` | |
|
|
723
|
+
| `min` | input | `IsoDate \| null` | `null` | |
|
|
724
|
+
| `max` | input | `IsoDate \| null` | `null` | |
|
|
725
|
+
| `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` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
|
|
728
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
|
|
729
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
|
|
730
|
+
|
|
731
|
+
## `hm-date-range-picker`
|
|
732
|
+
|
|
733
|
+
`DateRangePickerComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/date-picker` (também na raiz)
|
|
734
|
+
|
|
735
|
+
Intervalo de datas num campo só — o `hermesStartDate`/`hermesEndDate` do hermes-ui antigo. Duas entradas (início – fim) no mesmo quadro e um calendário: o 1º clique marca o início, o 2º o fim (se vier antes do início, os dois trocam), com a faixa destacada sob o ponteiro enquanto se escolhe o fim.
|
|
736
|
+
|
|
737
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
738
|
+
|---|---|---|---|---|
|
|
739
|
+
| `value` | model | `DateRange` | `EMPTY_DATE_RANGE` | |
|
|
740
|
+
| `startControl` | input | `DateControl \| null` | `null` | Depreciado desde 0.2.0 — use `formControlName`/`[(ngModel)]`/`[(value)]` com `DateRange`. |
|
|
741
|
+
| `endControl` | input | `DateControl \| null` | `null` | Depreciado desde 0.2.0 — idem `startControl`. |
|
|
742
|
+
| `start` | model | `string \| null` | `null` | Depreciado desde 0.2.0 — use `[(value)]` com `DateRange`. |
|
|
743
|
+
| `end` | model | `string \| null` | `null` | Depreciado desde 0.2.0 — use `[(value)]` com `DateRange`. |
|
|
744
|
+
| `label` | input (obrigatório) | `string` | | |
|
|
745
|
+
| `labelHidden` | input | `boolean` | `false` | |
|
|
746
|
+
| `hint` | input | `string` | `''` | |
|
|
747
|
+
| `min` | input | `IsoDate \| null` | `null` | |
|
|
748
|
+
| `max` | input | `IsoDate \| null` | `null` | |
|
|
749
|
+
| `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
|
+
| `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` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
|
|
753
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
|
|
754
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
|
|
755
|
+
|
|
756
|
+
## `hm-description-item`
|
|
757
|
+
|
|
758
|
+
`DescriptionItemComponent` — import de `@trismegisto/angular/description-list` (também na raiz)
|
|
759
|
+
|
|
760
|
+
Um par termo/descrição de um `hm-description-list`. Não desenha nada sozinho: o conteúdo vira um template que a lista renderiza dentro de `<div><dt><dd>` — o host deste componente nunca entra no DOM, então o `<dl>` só tem os filhos que a especificação HTML permite (mesmo padrão do `mat-tab`).
|
|
761
|
+
|
|
762
|
+
Slots: `(padrão)`, `hm-description-item`
|
|
763
|
+
|
|
764
|
+
Métodos públicos: `hasValue(): boolean`
|
|
765
|
+
|
|
766
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
767
|
+
|---|---|---|---|---|
|
|
768
|
+
| `term` | input (obrigatório) | `string` | | O termo (`<dt>`): o nome da propriedade. |
|
|
769
|
+
| `value` | model | `string \| number \| null \| undefined` | `undefined` | O valor em texto. `null`, `undefined` e `''` contam como vazio. Two-way com `editable`. |
|
|
770
|
+
| `fullWidth` | input | `boolean` | `false` | Ocupa a linha inteira da grade (texto longo, como uma descrição). |
|
|
771
|
+
| `editable` | input | `boolean` | `false` | O valor pode ser editado no lugar (campo de texto; Enter salva, Esc cancela). |
|
|
772
|
+
| `expanded` | model | `boolean` | `false` | Bloco com filhos aberto. Two-way. Sem filhos, não tem efeito. |
|
|
773
|
+
|
|
774
|
+
## `hm-description-list`
|
|
775
|
+
|
|
776
|
+
`DescriptionListComponent` — import de `@trismegisto/angular/description-list` (também na raiz)
|
|
777
|
+
|
|
778
|
+
Lista de propriedades (ficha de leitura): pares termo/valor em `<dl>/<dt>/<dd>`.
|
|
779
|
+
|
|
780
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
781
|
+
|---|---|---|---|---|
|
|
782
|
+
| `items` | input | `readonly DescriptionListItem[]` | `[]` | Pares por dados. Os `<hm-description-item>` projetados vêm depois deles. |
|
|
783
|
+
| `columns` | input | `number` | `1` | Máximo de colunas da grade (1 = uma coluna, um par embaixo do outro). |
|
|
784
|
+
| `minColumnWidth` | input | `string` | `''` | Largura mínima de cada coluna antes de a grade cair para menos colunas (CSS, ex.: `14rem`). |
|
|
785
|
+
| `labelPosition` | input | `DescriptionListLabelPosition` | `'top'` | Termo acima do valor (`top`) ou ao lado (`start`). |
|
|
786
|
+
| `variant` | input | `DescriptionListVariant` | `'plain'` | |
|
|
787
|
+
| `label` | input | `string` | `''` | Nome acessível da lista (`aria-label`), quando há mais de uma ficha na tela. |
|
|
788
|
+
| `valueChange` | output | `DescriptionListValueChange` | | Edição inline salva num item por dados (`items`). Item por composição usa o próprio `[(value)]`. |
|
|
789
|
+
|
|
790
|
+
## `hm-divider`
|
|
791
|
+
|
|
792
|
+
`DividerComponent` — import de `@trismegisto/angular/divider` (também na raiz)
|
|
793
|
+
|
|
794
|
+
Separador entre blocos de conteúdo.
|
|
795
|
+
|
|
796
|
+
Slots: `(padrão)`
|
|
797
|
+
|
|
798
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
799
|
+
|---|---|---|---|---|
|
|
800
|
+
| `orientation` | input | `DividerOrientation` | `'horizontal'` | |
|
|
801
|
+
| `label` | input | `string` | `''` | Texto no meio do traço ("ou", nome de uma seção). Conteúdo projetado também vale. |
|
|
802
|
+
| `labelAlign` | input | `DividerLabelAlign` | `'center'` | Onde o texto fica ao longo do traço. |
|
|
803
|
+
| `emphasis` | input | `DividerEmphasis` | `'subtle'` | |
|
|
804
|
+
| `thickness` | input | `DividerThickness` | `'hairline'` | |
|
|
805
|
+
| `spacing` | input | `DividerSpacing` | `'none'` | Margem em volta do traço (em cima/embaixo no horizontal, dos lados no vertical). |
|
|
806
|
+
| `decorative` | input | `boolean` | `false` | Só visual: sem `role="separator"`. |
|
|
807
|
+
|
|
808
|
+
## `[hmDraggable]`
|
|
809
|
+
|
|
810
|
+
`DraggableDirective` — import de `@trismegisto/angular/drag-drop` (também na raiz)
|
|
811
|
+
|
|
812
|
+
Item arrastável — por **mouse, toque, caneta e teclado** (o HTML5 DnD nativo não faz toque nem teclado). `[hmDraggable]="dados"` leva os dados até a zona que o receber.
|
|
813
|
+
|
|
814
|
+
Métodos públicos: `data(): unknown`, `type(): string`, `label(): string`, `disabled(): boolean`, `contained(): boolean`, `focusTarget(): HTMLElement`, `previewTemplate(): TemplateRef<HermesDragTemplateContext> \| null`, `setDragging(via: HermesDragVia \| null): void`, `started(via: HermesDragVia): void`, `ended(dropped: boolean): void`, `addHandle(handle: HTMLElement): void`, `removeHandle(handle: HTMLElement): void`, `keyboardActive(): boolean`
|
|
815
|
+
|
|
816
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
817
|
+
|---|---|---|---|---|
|
|
818
|
+
| `hmDraggable` | input | `T` | `undefined as T` | Dados levados até a zona que receber o item. |
|
|
819
|
+
| `hmDragType` | input | `string` | `'default'` | Tipo do item: as zonas filtram por ele (`hmDropZoneAccepts`). |
|
|
820
|
+
| `hmDragLabel` | input | `string` | `''` | Nome do item nos anúncios. Vazio = o texto do próprio item. |
|
|
821
|
+
| `hmDragDisabled` | input | `boolean` | `false` | |
|
|
822
|
+
| `hmDragContained` | input | `boolean` | `false` | Só pode ser solto no próprio `[hmSortable]`/`[hmDropZone]` de origem — nem zonas sem filtro da página nem listas conectadas o recebem. Para listas que só reord… |
|
|
823
|
+
| `hmDragThreshold` | input | `number` | `5` | Pixels que mouse/caneta andam antes de começar a arrastar. |
|
|
824
|
+
| `hmDragTouchDelay` | input | `number \| null` | `null` | Toque longo (ms) exigido no toque. Padrão: 0 com alça, 250 sem alça. |
|
|
825
|
+
| `dragStarted` | output | `HermesDragVia` | | Começou a arrastar (por ponteiro ou teclado). |
|
|
826
|
+
| `dragEnded` | output | `HermesDragEndEvent` | | Terminou: soltou numa zona (`dropped`) ou cancelou. |
|
|
827
|
+
|
|
828
|
+
## `[hmDragHandle]`
|
|
829
|
+
|
|
830
|
+
`DragHandleDirective` — import de `@trismegisto/angular/drag-drop` (também na raiz)
|
|
831
|
+
|
|
832
|
+
Alça de arrasto: com ela, só este elemento pega o `[hmDraggable]` que o contém (por ponteiro e por teclado) — o resto do item fica livre para selecionar texto, clicar e rolar no toque. `touch-action: none`: o arrasto começa no toque, sem toque longo.
|
|
833
|
+
|
|
834
|
+
_Sem inputs/outputs._
|
|
835
|
+
|
|
836
|
+
## `ng-template[hmDragPreview]`
|
|
837
|
+
|
|
838
|
+
`DragPreviewDirective` — import de `@trismegisto/angular/drag-drop` (também na raiz)
|
|
839
|
+
|
|
840
|
+
Template da prévia que segue o ponteiro: `<ng-template hmDragPreview let-data>…</ng-template>` dentro do `[hmDraggable]`. Sem ele, a prévia é um clone do item.
|
|
841
|
+
|
|
842
|
+
_Sem inputs/outputs._
|
|
843
|
+
|
|
844
|
+
## `[hmDropZone]`
|
|
845
|
+
|
|
846
|
+
`DropZoneDirective` — import de `@trismegisto/angular/drag-drop` (também na raiz)
|
|
847
|
+
|
|
848
|
+
Zona de soltura simples: recebe `[hmDraggable]`s e emite `dropped` com os dados (o app decide o que fazer). Para lista que reordena, use `[hmSortable]`.
|
|
849
|
+
|
|
850
|
+
Métodos públicos: `label(): string`, `disabled(): boolean`, `accepts(item: HermesDragItemRef): boolean`, `orientation(): DragListOrientation \| null`, `columns(): number`, `items(): readonly HermesDragItemRef[]`, `placeholderTemplate(): TemplateRef<HermesDragTemplateContext> \| null`, `setState(active: boolean, over: boolean): void`, `pointerOver(item: HermesDragItemRef, point: DragPoint): void`, `drop(item: HermesDragItemRef, index: number, previousIndex: number, via: HermesDragVia): void`
|
|
851
|
+
|
|
852
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
853
|
+
|---|---|---|---|---|
|
|
854
|
+
| `hmDropZone` | input | `string` | `''` | Nome da zona nos anúncios. |
|
|
855
|
+
| `hmDropZoneAccepts` | input | `HermesDropAccepts` | `null` | O que a zona aceita: tipo, tipos ou predicado. `null` (padrão) aceita qualquer item. |
|
|
856
|
+
| `hmDropZoneDisabled` | input | `boolean` | `false` | |
|
|
857
|
+
| `dropped` | output | `HermesDropEvent<T>` | | Um item foi solto aqui. |
|
|
858
|
+
| `entered` | output | `void` | | O item arrastado entrou/saiu da zona. |
|
|
859
|
+
| `exited` | output | `void` | | |
|
|
860
|
+
| `overPoint` | output | `HermesDropOverEvent<T>` | | O ponteiro se moveu sobre a zona com um item que ela aceita: ponto e caixa da zona. |
|
|
861
|
+
|
|
862
|
+
## `ng-template[hmDragPlaceholder]`
|
|
863
|
+
|
|
864
|
+
`DragPlaceholderDirective` — import de `@trismegisto/angular/drag-drop` (também na raiz)
|
|
865
|
+
|
|
866
|
+
Template do placeholder (o lugar onde o item vai cair): `<ng-template hmDragPlaceholder let-data>` dentro do `[hmSortable]`. Sem ele, um retângulo tracejado do tamanho do item.
|
|
867
|
+
|
|
868
|
+
_Sem inputs/outputs._
|
|
869
|
+
|
|
870
|
+
## `[hmSortable]`
|
|
871
|
+
|
|
872
|
+
`SortableDirective` — import de `@trismegisto/angular/drag-drop` (também na raiz)
|
|
873
|
+
|
|
874
|
+
Lista ordenável: os `[hmDraggable]` dentro dela são reordenados por ponteiro ou teclado e, com `hmSortableGroup`, passam para outras listas do mesmo grupo (a base de um kanban).
|
|
875
|
+
|
|
876
|
+
Métodos públicos: `register(item: HermesDragItemRef): void`, `unregister(item: HermesDragItemRef): void`, `label(): string`, `disabled(): boolean`, `accepts(item: HermesDragItemRef): boolean`, `orientation(): DragListOrientation`, `columns(): number`, `items(): readonly HermesDragItemRef[]`, `placeholderTemplate(): TemplateRef<HermesDragTemplateContext> \| null`, `setState(active: boolean, over: boolean): void`, `drop(item: HermesDragItemRef, index: number, previousIndex: number, via: HermesDragVia): void`
|
|
877
|
+
|
|
878
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
879
|
+
|---|---|---|---|---|
|
|
880
|
+
| `hmSortable` | model | `readonly T[]` | `[]` | Os itens, na ordem atual. Two-way: recebe a ordem nova ao soltar. |
|
|
881
|
+
| `hmSortableGroup` | input | `string \| null` | `null` | Listas com o mesmo grupo trocam itens entre si. |
|
|
882
|
+
| `hmSortableOrientation` | input | `DragListOrientation` | `'vertical'` | |
|
|
883
|
+
| `hmSortableColumns` | input | `number \| null` | `null` | Colunas da grade para o teclado; `null` = medidas pela posição dos itens. |
|
|
884
|
+
| `hmSortableLabel` | input | `string` | `''` | Nome da lista nos anúncios. Vazio = `aria-label` ou o padrão do catálogo. |
|
|
885
|
+
| `hmSortableDisabled` | input | `boolean` | `false` | Desligada: não recebe itens (os dela continuam pegáveis, salvo `hmDragDisabled`). |
|
|
886
|
+
| `hmSortableAccepts` | input | `((data: unknown, type: string) => boolean) \| null` | `null` | Aceita também itens de fora do grupo para os quais isto devolver `true`. |
|
|
887
|
+
| `sorted` | output | `HermesSortEvent<T>` | | Um item foi solto nesta lista (vindo dela mesma ou de outra). |
|
|
888
|
+
|
|
889
|
+
## `hm-drawer`
|
|
890
|
+
|
|
891
|
+
`DrawerComponent` — import de `@trismegisto/angular/drawer` (também na raiz)
|
|
892
|
+
|
|
893
|
+
Painel que desliza da borda. Use para conteúdo que se beneficia de mais espaço que um modal (um formulário longo, o detalhe de um registro) sem tirar a pessoa da tela de trás.
|
|
894
|
+
|
|
895
|
+
Slots: `(padrão)`, `[footer]`
|
|
896
|
+
|
|
897
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
898
|
+
|---|---|---|---|---|
|
|
899
|
+
| `open` | model (obrigatório) | `boolean` | | Visibilidade. Two-way: o próprio drawer fecha no Esc e no X. |
|
|
900
|
+
| `heading` | input (obrigatório) | `string` | | Título do painel: também o rótulo acessível do dialog (ou da região, quando `pinned`). |
|
|
901
|
+
| `size` | input | `ModalSize` | `'medium'` | Largura (em `start`/`end`) ou altura máxima (em `bottom`): `small`, `medium` (padrão), `large`, `xlarge` ou `full` (tela cheia — cobre a viewport, com a área s… |
|
|
902
|
+
| `position` | input | `DrawerPosition` | `'end'` | Borda de onde o painel sai. `bottom` = bottom sheet. |
|
|
903
|
+
| `pinned` | input | `boolean` | `false` | Fixa o painel no layout, ao lado do conteúdo, sem véu e sem modal (persistent drawer). |
|
|
904
|
+
| `closeLabel` | input | `string` | `''` | Vazio = texto do catálogo no idioma ativo (`HERMES_MESSAGES.drawer.close`). |
|
|
905
|
+
| `closable` | input | `boolean` | `true` | |
|
|
906
|
+
| `beforeClose` | input | `(() => boolean \| Promise<boolean>) \| null` | `null` | Guarda de fechamento, igual à do `hm-modal`: chamada antes de o X ou o Esc fecharem. Devolvendo `false` (ou uma Promise que resolve `false`), o painel continua… |
|
|
907
|
+
| `closed` | output | `void` | | |
|
|
908
|
+
|
|
909
|
+
## `hm-dropdown`
|
|
910
|
+
|
|
911
|
+
`DropdownComponent` — import de `@trismegisto/angular/dropdown` (também na raiz)
|
|
912
|
+
|
|
913
|
+
Dropdown de conteúdo livre — o `hermes-dropdown` do hermes-ui antigo, com a mesma anatomia:
|
|
914
|
+
|
|
915
|
+
Slots: `(padrão)`
|
|
916
|
+
|
|
917
|
+
Métodos públicos: `setOpen(value: boolean): void`, `toggle(): void`
|
|
918
|
+
|
|
919
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
920
|
+
|---|---|---|---|---|
|
|
921
|
+
| `open` | model | `boolean` | `false` | Two-way (`[(open)]`) — como o `hermesIfOpen` antigo. O `model()` já cria o output `openChange`, emitido a cada mudança interna (não quando o próprio pai escrev… |
|
|
922
|
+
| `closeOnItemClick` | input | `boolean` | `true` | Clicar num `hmDropdownItem` fecha o menu (`hermesDropdownCloseMenuOnItemClick`, padrão true). |
|
|
923
|
+
|
|
924
|
+
## `[hmIfOpen]`
|
|
925
|
+
|
|
926
|
+
`DropdownIfOpenDirective` — import de `@trismegisto/angular/dropdown` (também na raiz)
|
|
927
|
+
|
|
928
|
+
Renderiza o conteúdo só com o dropdown aberto (`*hmIfOpen`, o `*hermesIfOpen` antigo).
|
|
929
|
+
|
|
930
|
+
_Sem inputs/outputs._
|
|
931
|
+
|
|
932
|
+
## `[hmDropdownItem]`
|
|
933
|
+
|
|
934
|
+
`DropdownItemDirective` — import de `@trismegisto/angular/dropdown` (também na raiz)
|
|
935
|
+
|
|
936
|
+
Item focável do menu: setas navegam entre eles; clique fecha (se `closeOnItemClick`).
|
|
937
|
+
|
|
938
|
+
_Sem inputs/outputs._
|
|
939
|
+
|
|
940
|
+
## `hm-dropdown-menu`
|
|
941
|
+
|
|
942
|
+
`DropdownMenuComponent` — import de `@trismegisto/angular/dropdown` (também na raiz)
|
|
943
|
+
|
|
944
|
+
Cartão do menu. Use com `*hmIfOpen` (só existe aberto).
|
|
945
|
+
|
|
946
|
+
Slots: `(padrão)`
|
|
947
|
+
|
|
948
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
949
|
+
|---|---|---|---|---|
|
|
950
|
+
| `position` | input | `DropdownPosition` | `'bottom-left'` | `bottom-left` (padrão) etc. — `hermesPosition` do antigo. |
|
|
951
|
+
| `label` | input | `string` | `''` | Nome do menu para leitor de tela (padrão: o texto do gatilho, via `aria-controls`). |
|
|
952
|
+
|
|
953
|
+
## `[hmDropdownTrigger]`
|
|
954
|
+
|
|
955
|
+
`DropdownTriggerDirective` — import de `@trismegisto/angular/dropdown` (também na raiz)
|
|
956
|
+
|
|
957
|
+
Gatilho do dropdown — qualquer elemento (`<button>`, `<hm-button>`, `<hm-icon-button>`).
|
|
958
|
+
|
|
959
|
+
_Sem inputs/outputs._
|
|
960
|
+
|
|
961
|
+
## `hm-dual-list`
|
|
962
|
+
|
|
963
|
+
`DualListComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/dual-list` (também na raiz)
|
|
964
|
+
|
|
965
|
+
Transferência entre duas listas (`hm-dual-list`): o que está disponível de um lado, o que foi escolhido do outro. Seleção e teclado da listbox com multisseleção da WAI-ARIA APG.
|
|
966
|
+
|
|
967
|
+
Métodos públicos: `moveMarked(from: DualListSide): void`, `moveAll(from: DualListSide): void`
|
|
968
|
+
|
|
969
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
970
|
+
|---|---|---|---|---|
|
|
971
|
+
| `items` | input (obrigatório) | `readonly DualListItem[]` | | Todos os itens possíveis; o lado de cada um sai do `value`. |
|
|
972
|
+
| `value` | model | `readonly string[]` | `[]` | Ids escolhidos. Two-way. |
|
|
973
|
+
| `label` | input (obrigatório) | `string` | | Nome do campo (visível, salvo `labelHidden`). |
|
|
974
|
+
| `labelHidden` | input | `boolean` | `false` | |
|
|
975
|
+
| `hint` | input | `string` | `''` | |
|
|
976
|
+
| `availableLabel` | input | `string` | `''` | Título do lado dos disponíveis. Vazio = catálogo ("Disponíveis"). |
|
|
977
|
+
| `selectedLabel` | input | `string` | `''` | Título do lado dos escolhidos. Vazio = catálogo ("Selecionados"). |
|
|
978
|
+
| `searchable` | input | `boolean` | `true` | Mostra a busca em cada lado. |
|
|
979
|
+
| `size` | input | `DualListSize` | `'medium'` | |
|
|
980
|
+
| `loading` | input | `boolean` | `false` | |
|
|
981
|
+
| `disabled` | input (herdado) | `boolean` | `false` | |
|
|
982
|
+
| `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
|
|
983
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
|
|
984
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
|
|
985
|
+
|
|
986
|
+
## `hm-empty`
|
|
987
|
+
|
|
988
|
+
`EmptyComponent` — import de `@trismegisto/angular/empty` (também na raiz)
|
|
989
|
+
|
|
990
|
+
Estado vazio COMPACTO, para dentro de um cartão, painel, coluna ou tabela: ícone (ou mídia projetada), título curto, uma frase de explicação e as ações que tiram a área do vazio.
|
|
991
|
+
|
|
992
|
+
Slots: `[emptyMedia]`, `[emptyDescription]`, `(padrão)`
|
|
993
|
+
|
|
994
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
995
|
+
|---|---|---|---|---|
|
|
996
|
+
| `heading` | input (obrigatório) | `string` | | Título curto: o que está vazio ("Nenhum arquivo ainda"). |
|
|
997
|
+
| `description` | input | `string` | `''` | Uma frase: por que está vazio ou o que fazer em seguida. |
|
|
998
|
+
| `icon` | input | `string` | `''` | Ícone do catálogo num quadro acima do título. Decorativo. |
|
|
999
|
+
| `appearance` | input | `EmptyAppearance` | `'plain'` | |
|
|
1000
|
+
| `size` | input | `EmptySize` | `'medium'` | |
|
|
1001
|
+
| `headingLevel` | input | `EmptyHeadingLevel` | `0` | |
|
|
1002
|
+
|
|
1003
|
+
## `hm-event-calendar`
|
|
1004
|
+
|
|
1005
|
+
`EventCalendarComponent` — import de `@trismegisto/angular/event-calendar` (também na raiz)
|
|
1006
|
+
|
|
1007
|
+
Agenda de eventos genérica: visões **mês, semana, dia e lista** (`[(view)]`), navegação anterior/hoje/próximo sobre `[(date)]` e `[events]`. Só apresentação — não busca, não guarda e não decide regra de negócio: o app escuta `rangeChange` (intervalo visível, fim exclusivo; emitido também na primeira pintura) para buscar no servidor, e `eventClick`/`dateClick` para abrir detalhe ou criar. O motor…
|
|
1008
|
+
|
|
1009
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1010
|
+
|---|---|---|---|---|
|
|
1011
|
+
| `events` | input | `readonly CalendarEvent[]` | `[]` | |
|
|
1012
|
+
| `view` | model | `EventCalendarView` | `'month'` | Visão. Two-way. |
|
|
1013
|
+
| `date` | model | `IsoDate` | `eventCalendarToday()` | Data de referência (ISO). No mês é também o dia com o foco. Two-way. |
|
|
1014
|
+
| `views` | input | `readonly EventCalendarView[]` | `EVENT_CALENDAR_VIEWS` | Visões oferecidas no seletor (e a ordem). Com uma só, o seletor some. |
|
|
1015
|
+
| `timeZone` | input | `string \| null` | `null` | Fuso IANA de exibição (`'America/Sao_Paulo'`); sem ele, o do navegador. |
|
|
1016
|
+
| `weekStartsOn` | input | `Weekday \| null` | `null` | Primeiro dia da semana (0 = domingo); sem ele, o do idioma. |
|
|
1017
|
+
| `maxEventsPerDay` | input | `number` | `3` | Linhas de evento por dia no mês antes do "+N mais". |
|
|
1018
|
+
| `scrollToHour` | input | `number` | `8` | Hora em que a grade de semana/dia abre rolada. |
|
|
1019
|
+
| `compactBelow` | input | `number` | `600` | Largura (px) do componente abaixo da qual semana vira lista e mês fica compacto. 0 desliga. |
|
|
1020
|
+
| `label` | input | `string` | `''` | Nome da agenda para leitor de tela (padrão: "Agenda" do catálogo). |
|
|
1021
|
+
| `eventClick` | output | `CalendarEvent` | | |
|
|
1022
|
+
| `dateClick` | output | `EventCalendarDateClick` | | |
|
|
1023
|
+
| `rangeChange` | output | `EventCalendarRangeChange` | | |
|
|
1024
|
+
|
|
1025
|
+
## `hm-fab`
|
|
1026
|
+
|
|
1027
|
+
`FabComponent` — import de `@trismegisto/angular/fab` (também na raiz)
|
|
1028
|
+
|
|
1029
|
+
Botão de ação flutuante, com o que faltava para ser componente de biblioteca: - **Rótulo obrigatório.** `extended` mostra o texto ao lado do ícone; sem ele, só o ícone, e o rótulo vira o nome acessível (`aria-label`). - **Posição fixa** (`position`, em propriedades lógicas — RTL espelha), somando a **área segura** do celular (`env(safe-area-inset-*)`). `fixed=false` deixa o botão no fluxo (quem m…
|
|
1030
|
+
|
|
1031
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1032
|
+
|---|---|---|---|---|
|
|
1033
|
+
| `label` | input (obrigatório) | `string` | | Nome do botão: texto visível com `extended`, senão o nome acessível. |
|
|
1034
|
+
| `icon` | input | `string` | `''` | Ícone (quem usa registra). Com `actions` e sem ícone, vale o `plus`. |
|
|
1035
|
+
| `extended` | input | `boolean` | `false` | Pílula com ícone e texto (`true`) ou círculo só com o ícone. |
|
|
1036
|
+
| `position` | input | `FabPosition` | `'bottom-end'` | |
|
|
1037
|
+
| `fixed` | input | `boolean` | `true` | `false` deixa o botão no fluxo do documento (quem monta decide onde). |
|
|
1038
|
+
| `size` | input | `FabSize` | `'medium'` | |
|
|
1039
|
+
| `disabled` | input | `boolean` | `false` | |
|
|
1040
|
+
| `highlight` | input | `boolean` | `false` | Anel parado em volta: há o que fazer com ele nesta tela (não pisca, de propósito). |
|
|
1041
|
+
| `actions` | input | `readonly FabAction[]` | `[]` | Ações do speed dial; vazio, o botão age sozinho (`triggered`). |
|
|
1042
|
+
| `hideOnScroll` | input | `boolean` | `false` | Esconde ao rolar para baixo e volta ao rolar para cima. |
|
|
1043
|
+
| `avoid` | input | `string \| HTMLElement \| null` | `'footer, [role="contentinfo"]'` | Seletor (ou elemento) que o botão não pode cobrir; `''` desliga. |
|
|
1044
|
+
| `expanded` | input | `boolean \| null` | `null` | Sem `actions`: o painel que o botão abre está aberto (`aria-expanded`). |
|
|
1045
|
+
| `controls` | input | `string` | `''` | Sem `actions`: `id` do painel que ele abre (`aria-controls`). |
|
|
1046
|
+
| `triggered` | output | `void` | | Clique no botão sem `actions`. |
|
|
1047
|
+
| `chosen` | output | `string` | | `id` da ação escolhida no speed dial. |
|
|
1048
|
+
|
|
1049
|
+
## `hm-field`
|
|
1050
|
+
|
|
1051
|
+
`FieldComponent` · `ControlValueAccessor` · **Depreciado** · estende `InputComponent` — import de `@trismegisto/angular/field` (também na raiz)
|
|
1052
|
+
|
|
1053
|
+
Depreciado desde 0.2.0 — use `<hm-input>` (mesma API; ligue o formulário com `formControlName`/`[formControl]`, `[(ngModel)]` ou `[(value)]` — o `[control]` saiu). Será removido na 0.3.0.
|
|
1054
|
+
|
|
1055
|
+
Slots: `[hmPrefix]`, `[hmSuffix]`
|
|
1056
|
+
|
|
1057
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1058
|
+
|---|---|---|---|---|
|
|
1059
|
+
| `value` | model (herdado) | `T` | `'' as T` | |
|
|
1060
|
+
| `label` | input (obrigatório) (herdado) | `string` | | |
|
|
1061
|
+
| `type` | input (herdado) | `InputType` | `'text'` | |
|
|
1062
|
+
| `placeholder` | input (herdado) | `string` | `''` | |
|
|
1063
|
+
| `icon` | input (herdado) | `string` | `''` | Ícone decorativo no fim do campo. |
|
|
1064
|
+
| `labelHidden` | input (herdado) | `boolean` | `false` | Esconde o rótulo da vista, mantendo-o para o leitor de tela. |
|
|
1065
|
+
| `hint` | input (herdado) | `string` | `''` | Texto de apoio embaixo do campo (formato esperado, efeito automático...). |
|
|
1066
|
+
| `prefix` | input (herdado) | `string` | `''` | Texto antes do valor ("R$"). Anunciado como descrição do campo. |
|
|
1067
|
+
| `suffix` | input (herdado) | `string` | `''` | Texto depois do valor ("kg"). Anunciado como descrição do campo. |
|
|
1068
|
+
| `prefixIcon` | input (herdado) | `string` | `''` | Ícone decorativo no início do campo. |
|
|
1069
|
+
| `mask` | input (herdado) | `HermesMask \| ''` | `''` | Máscara pronta (`cpf`, `cnpj`, `cep`, `phone`) ou padrão customizado; vazio = sem máscara. |
|
|
1070
|
+
| `maskValue` | input (herdado) | `InputMaskValue` | `'raw'` | |
|
|
1071
|
+
| `min` | input (herdado) | `number \| null, unknown` | `null` | |
|
|
1072
|
+
| `max` | input (herdado) | `number \| null, unknown` | `null` | |
|
|
1073
|
+
| `step` | input (herdado) | `number \| null, unknown` | `null` | |
|
|
1074
|
+
| `stepButtons` | input (herdado) | `boolean` | `true` | Botões −/+ no `type="number"`. |
|
|
1075
|
+
| `maxLength` | input (herdado) | `number \| null, unknown` | `null` | Limite de caracteres, com contador visível. Ignorado com `mask`. |
|
|
1076
|
+
| `autocomplete` | input (herdado) | `string` | `''` | |
|
|
1077
|
+
| `inputMode` | input (herdado) | `InputMode \| ''` | `''` | Sobrescreve o `inputmode` derivado do tipo/máscara. |
|
|
1078
|
+
| `disabled` | input (herdado) | `boolean` | `false` | |
|
|
1079
|
+
| `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
|
|
1080
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
|
|
1081
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
|
|
1082
|
+
|
|
1083
|
+
## `hm-file-upload`
|
|
1084
|
+
|
|
1085
|
+
`FileUploadComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/file-upload` (também na raiz)
|
|
1086
|
+
|
|
1087
|
+
Envio de arquivos: área de soltar + botão "Escolher arquivos", validação antes de entrar na lista e a lista com o estado de cada arquivo.
|
|
1088
|
+
|
|
1089
|
+
Métodos públicos: `addFiles(list: readonly File[]): UploadFile[]`, `update(id: string, patch: UploadFilePatch): void`, `remove(id: string): void`, `retry(id: string): void`
|
|
1090
|
+
|
|
1091
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1092
|
+
|---|---|---|---|---|
|
|
1093
|
+
| `files` | model | `readonly UploadFile[]` | `[]` | A lista de arquivos (valor do campo). `[(files)]` / `(filesChange)`. |
|
|
1094
|
+
| `label` | input (obrigatório) | `string` | | |
|
|
1095
|
+
| `labelHidden` | input | `boolean` | `false` | Esconde o rótulo da vista, mantendo-o para o leitor de tela. |
|
|
1096
|
+
| `hint` | input | `string` | `''` | Texto de apoio embaixo da área. |
|
|
1097
|
+
| `accept` | input | `string` | `''` | Mesmo formato do atributo nativo: `'.pdf,.xlsx,image/*'`. Vazio aceita qualquer tipo. |
|
|
1098
|
+
| `multiple` | input | `boolean` | `false` | Vários arquivos. Sem isto, escolher outro arquivo substitui o atual. |
|
|
1099
|
+
| `maxFiles` | input | `number` | `0` | Máximo de arquivos na lista (com `multiple`). Zero = sem limite. |
|
|
1100
|
+
| `maxSize` | input | `number` | `0` | Tamanho máximo de cada arquivo, em bytes. Zero = sem limite. |
|
|
1101
|
+
| `maxTotalSize` | input | `number` | `0` | Tamanho máximo da soma dos arquivos, em bytes. Zero = sem limite. |
|
|
1102
|
+
| `size` | input | `FileUploadSize` | `'medium'` | Altura da área de soltar. |
|
|
1103
|
+
| `loading` | input | `boolean` | `false` | |
|
|
1104
|
+
| `browseLabel` | input | `string` | `''` | Texto do botão (padrão do catálogo: "Escolher arquivos"/"Escolher arquivo"). |
|
|
1105
|
+
| `uploader` | input | `FileUploader \| null` | `null` | Envio automático (opcional). Ver `FileUploader`. |
|
|
1106
|
+
| `added` | output | `UploadFile[]` | | Arquivos que passaram na validação e entraram na lista. |
|
|
1107
|
+
| `rejected` | output | `FileRejection[]` | | Arquivos recusados, com o motivo (`type`, `size`, `totalSize`, `count`, `duplicate`). |
|
|
1108
|
+
| `removed` | output | `UploadFile` | | Arquivo removido pela pessoa (já fora da lista). |
|
|
1109
|
+
| `retried` | output | `UploadFile` | | Pediu para tentar de novo um envio com erro (sem `uploader`, o app reenvia). |
|
|
1110
|
+
| `disabled` | input (herdado) | `boolean` | `false` | |
|
|
1111
|
+
| `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
|
|
1112
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
|
|
1113
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
|
|
1114
|
+
|
|
1115
|
+
## `hm-filter-bar`
|
|
1116
|
+
|
|
1117
|
+
`FilterBarComponent` — import de `@trismegisto/angular/filter-bar` (também na raiz)
|
|
1118
|
+
|
|
1119
|
+
Faixa de filtros por campos. O app declara os campos e a faixa cuida do resto:
|
|
1120
|
+
|
|
1121
|
+
Métodos públicos: `clearAll(): void`, `reloadSaved(): Promise<void>`
|
|
1122
|
+
|
|
1123
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1124
|
+
|---|---|---|---|---|
|
|
1125
|
+
| `filters` | input (obrigatório) | `readonly FilterBarField[]` | | Campos da faixa, na ordem em que aparecem. |
|
|
1126
|
+
| `value` | model | `FilterBarValue` | `{}` | `{ [key]: valor }` — só os campos ativos. `[(value)]`. |
|
|
1127
|
+
| `label` | input | `string` | `''` | Nome acessível da faixa (padrão do catálogo: "Filtros"). |
|
|
1128
|
+
| `savedFilters` | input | `boolean` | `false` | Mostra o menu "Filtros salvos". Precisa de `storageKey`. |
|
|
1129
|
+
| `storageKey` | input | `string` | `''` | Chave dos filtros salvos desta tela (uma por tabela). |
|
|
1130
|
+
| `storage` | input | `FilterBarStorage \| null` | `null` | Onde guardar os salvos; padrão `localStorage` (`localStorageFilterBarStorage()`). |
|
|
1131
|
+
| `applyDefault` | input | `boolean` | `true` | Ao carregar, aplica o salvo marcado como padrão se a faixa estiver sem filtro. |
|
|
1132
|
+
| `savedChange` | output | `readonly SavedFilter[]` | | A lista de salvos mudou (já persistida). |
|
|
1133
|
+
| `savedApplied` | output | `SavedFilter` | | Um salvo foi aplicado pela pessoa (ou o padrão, ao carregar). |
|
|
1134
|
+
|
|
1135
|
+
## `hm-floating-window`
|
|
1136
|
+
|
|
1137
|
+
`FloatingWindowComponent` — import de `@trismegisto/angular/floating-window` (também na raiz)
|
|
1138
|
+
|
|
1139
|
+
Janela flutuante **não modal**: fica sobre a página sem bloqueá-la — sem véu, sem prender o foco —, arrastável pela barra de título e redimensionável pelas bordas e cantos (Pointer Events: mouse, caneta e toque). Minimizar recolhe à barra de título; maximizar ocupa a tela; os dois voltam com "Restaurar" (ou dois cliques na barra de título). Comportamento de janela de sistema.
|
|
1140
|
+
|
|
1141
|
+
Slots: `[actions]`, `(padrão)`, `[footer]`
|
|
1142
|
+
|
|
1143
|
+
Métodos públicos: `bringToFront(): void`
|
|
1144
|
+
|
|
1145
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1146
|
+
|---|---|---|---|---|
|
|
1147
|
+
| `open` | model | `boolean` | `false` | Visibilidade. Two-way: o X da janela fecha. |
|
|
1148
|
+
| `heading` | input (obrigatório) | `string` | | Título: também o nome acessível da janela. |
|
|
1149
|
+
| `icon` | input | `string` | `''` | Ícone ao lado do título (nome do catálogo; o app registra). |
|
|
1150
|
+
| `width` | input | `number` | `480` | Tamanho inicial (px), quando não há geometria salva. |
|
|
1151
|
+
| `height` | input | `number` | `360` | |
|
|
1152
|
+
| `x` | input | `number \| null` | `null` | Posição inicial (px). `null` = centrada, em cascata com as outras janelas abertas. |
|
|
1153
|
+
| `y` | input | `number \| null` | `null` | |
|
|
1154
|
+
| `minWidth` | input | `number` | `240` | Tamanho mínimo (px). |
|
|
1155
|
+
| `minHeight` | input | `number` | `160` | |
|
|
1156
|
+
| `movable` | input | `boolean` | `true` | Arrastar pela barra de título. |
|
|
1157
|
+
| `resizable` | input | `boolean` | `true` | Redimensionar pelas bordas e cantos. |
|
|
1158
|
+
| `minimizable` | input | `boolean` | `true` | |
|
|
1159
|
+
| `maximizable` | input | `boolean` | `true` | |
|
|
1160
|
+
| `closable` | input | `boolean` | `true` | |
|
|
1161
|
+
| `closeOnEscape` | input | `boolean` | `false` | `Esc` fecha a janela. Padrão: não (janela não modal — `Esc` costuma ser do conteúdo). |
|
|
1162
|
+
| `autoFocus` | input | `boolean` | `true` | Leva o foco para dentro ao abrir. |
|
|
1163
|
+
| `storageKey` | input | `string` | `''` | Chave do `localStorage` para lembrar posição, tamanho e estado. Vazio = não persiste. |
|
|
1164
|
+
| `rect` | model | `FloatingRect \| null` | `null` | Geometria atual (px). Two-way; `null` = posição inicial automática. |
|
|
1165
|
+
| `state` | model | `FloatingWindowState` | `'normal'` | Estado de exibição. Two-way. |
|
|
1166
|
+
| `closed` | output | `void` | | Fechou pelo X (ou `Esc`, com `closeOnEscape`). |
|
|
1167
|
+
|
|
1168
|
+
## `hm-form-required-hint`
|
|
1169
|
+
|
|
1170
|
+
`FormRequiredHintComponent` — import de `@trismegisto/angular/form-required-hint` (também na raiz)
|
|
1171
|
+
|
|
1172
|
+
Legenda de obrigatório do formulário ("Campos marcados com “obrigatório” são de preenchimento obrigatório."). Coloque no começo do formulário, antes do primeiro campo, para quem lê saber o que a marca significa antes de encontrá-la.
|
|
1173
|
+
|
|
1174
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1175
|
+
|---|---|---|---|---|
|
|
1176
|
+
| `mark` | input | `string` | `''` | Marca citada na frase. Vazio = `HERMES_MESSAGES.field.required`. |
|
|
1177
|
+
| `text` | input | `string` | `''` | Frase inteira. Vazio = `HERMES_MESSAGES.form.requiredHint`. Aceita `{mark}`. |
|
|
1178
|
+
|
|
1179
|
+
## `hm-geometric-texture`
|
|
1180
|
+
|
|
1181
|
+
`GeometricTextureComponent` — import de `@trismegisto/angular/geometric-texture` (também na raiz)
|
|
1182
|
+
|
|
1183
|
+
Malha geométrica de fundo para telas grandes e vazias (hoje, o login). O desenho fica em `geometry.ts`, então trocar a arte é trocar aquele arquivo e nada aqui.
|
|
1184
|
+
|
|
1185
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1186
|
+
|---|---|---|---|---|
|
|
1187
|
+
| `columns` | input | `number` | `6` | Tamanho da grade. O SVG cobre o contêiner com `slice`, então isto é densidade — quantos ladrilhos cabem na tela —, e não largura em pixels. |
|
|
1188
|
+
| `rows` | input | `number` | `5` | |
|
|
1189
|
+
|
|
1190
|
+
## `hm-global-search`
|
|
1191
|
+
|
|
1192
|
+
`GlobalSearchComponent` — import de `@trismegisto/angular/global-search` (também na raiz)
|
|
1193
|
+
|
|
1194
|
+
Busca global: o mesmo contêiner da `hm-command-palette` (diálogo ancorado no alto, campo + lista em grupos), alimentado por uma consulta assíncrona do app com resultados de várias fontes. Quem consulta e para onde ir é do app.
|
|
1195
|
+
|
|
1196
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1197
|
+
|---|---|---|---|---|
|
|
1198
|
+
| `open` | model | `boolean` | `false` | Visibilidade. Two-way. |
|
|
1199
|
+
| `search` | input | `HermesSearchFn \| null` | `null` | A consulta. Sem ela, a busca não consulta nada. |
|
|
1200
|
+
| `debounce` | input | `number` | `250` | Espera de digitação (ms) antes de consultar. |
|
|
1201
|
+
| `minLength` | input | `number` | `1` | Mínimo de caracteres para consultar. |
|
|
1202
|
+
| `shortcut` | input | `string \| readonly string[]` | `''` | Atalho que abre/fecha (ex.: `'Mod+Shift+F'`). Vazio = o app abre por `[(open)]`. |
|
|
1203
|
+
| `label` | input | `string` | `''` | Nome do diálogo. Vazio = catálogo (`globalSearch.label`). |
|
|
1204
|
+
| `placeholder` | input | `string` | `''` | Vazio = catálogo (`globalSearch.placeholder`). |
|
|
1205
|
+
| `selected` | output | `HermesSearchSelection` | | Escolheu um resultado (a busca fecha). |
|
|
1206
|
+
|
|
1207
|
+
## `hm-header`
|
|
1208
|
+
|
|
1209
|
+
`HeaderComponent` — import de `@trismegisto/angular/header` (também na raiz)
|
|
1210
|
+
|
|
1211
|
+
Faixa fixa no topo do shell. A marca entra por `<ng-content>`, os atalhos de módulo pelo slot `[shortcuts]` e as ações pelo slot `[actions]` — o componente não sabe o que nenhum deles faz.
|
|
1212
|
+
|
|
1213
|
+
Slots: `(padrão)`, `[shortcuts], [atalhos]`, `[actions], [acoes]`
|
|
1214
|
+
|
|
1215
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1216
|
+
|---|---|---|---|---|
|
|
1217
|
+
| `searchRequested` | output | `void` | | Pedido de abrir a busca do sistema (clique no campo ou `Ctrl K`). |
|
|
1218
|
+
| `searchPlaceholder` | input | | `this.text.search` | |
|
|
1219
|
+
| `searchLabel` | input | | `this.text.searchLabel` | Nome acessível do campo — não há <label> visível. |
|
|
1220
|
+
|
|
1221
|
+
## `hm-icon-button`
|
|
1222
|
+
|
|
1223
|
+
`IconButtonComponent` — import de `@trismegisto/angular/icon-button` (também na raiz)
|
|
1224
|
+
|
|
1225
|
+
Botão cuja única marca visível é o ícone. Aqui `label` é obrigatório porque, sem texto na tela, ele é o nome acessível (aria-label).
|
|
1226
|
+
|
|
1227
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1228
|
+
|---|---|---|---|---|
|
|
1229
|
+
| `label` | input (obrigatório) | `string` | | |
|
|
1230
|
+
| `icon` | input (obrigatório) | `string` | | |
|
|
1231
|
+
| `solid` | input | `boolean` | `false` | Variante preenchida do ícone (ex.: favorito marcado) — repassada ao `hm-icon`. |
|
|
1232
|
+
| `iconDirection` | input | `string` | `''` | Direção de ícones direcionais (ex.: shape="angle"/"angle-double") — o glifo não tem variante por nome, só por direção (o mesmo `angle`, girado). |
|
|
1233
|
+
| `emphasis` | input | `IconButtonEmphasis` | `'outlined'` | |
|
|
1234
|
+
| `intent` | input | `ButtonIntent` | `'primary'` | |
|
|
1235
|
+
| `size` | input | `ButtonSize` | `'medium'` | |
|
|
1236
|
+
| `disabled` | input | `boolean` | `false` | |
|
|
1237
|
+
| `toggle` | input | `boolean` | `false` | Botão de alternância: o clique inverte `pressed` e o botão ganha `aria-pressed`. |
|
|
1238
|
+
| `pressed` | model | `boolean` | `false` | Estado do botão de alternância (só com `toggle`). Two-way: `[(pressed)]`. |
|
|
1239
|
+
| `clicked` | output | `void` | | |
|
|
1240
|
+
|
|
1241
|
+
## `hm-icon`
|
|
1242
|
+
|
|
1243
|
+
`IconComponent` — import de `@trismegisto/angular/icon` (também na raiz)
|
|
1244
|
+
|
|
1245
|
+
Ícone SVG inline (dados de @trismegisto/icons, `currentColor`). Nome desconhecido cai num ícone genérico em vez de quebrar. O HTML é gerado só a partir dos dados estáticos da lib.
|
|
1246
|
+
|
|
1247
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1248
|
+
|---|---|---|---|---|
|
|
1249
|
+
| `shape` | input (obrigatório) | `string` | | |
|
|
1250
|
+
| `direction` | input | `IconDirection \| '' \| (string & {})` | `''` | 'left' \| 'right' \| 'up' \| 'down'. Gira o desenho, que aponta para cima. |
|
|
1251
|
+
| `size` | input | `IconSize \| null` | `null` | |
|
|
1252
|
+
| `solid` | input | `boolean` | `false` | |
|
|
1253
|
+
| `badge` | input | `IconBadge \| null` | `null` | |
|
|
1254
|
+
| `status` | input | `IconStatus \| null` | `null` | |
|
|
1255
|
+
| `flip` | input | `IconFlip \| null` | `null` | |
|
|
1256
|
+
| `inverse` | input | `boolean` | `false` | |
|
|
1257
|
+
| `label` | input | `string` | `''` | Nome acessível. Vazio = decorativo. |
|
|
1258
|
+
|
|
1259
|
+
## `hm-illustration-attention`
|
|
1260
|
+
|
|
1261
|
+
`IllustrationAttentionComponent` — import de `@trismegisto/angular/illustration-attention`
|
|
1262
|
+
|
|
1263
|
+
Ilustração de atenção (algo pede cuidado antes de seguir), sem texto e sem ação: só o desenho. Quem diz o que aconteceu é o `hm-state-screen` em volta. Adesivo: traço e branco fixos, a cor segue família e estado (ver `_illustration-palette.scss`).
|
|
1264
|
+
|
|
1265
|
+
_Sem inputs/outputs._
|
|
1266
|
+
|
|
1267
|
+
## `hm-illustration-error`
|
|
1268
|
+
|
|
1269
|
+
`IllustrationErrorComponent` — import de `@trismegisto/angular/illustration-error`
|
|
1270
|
+
|
|
1271
|
+
Ilustração de erro (algo deu errado), sem texto e sem ação: só o desenho. Quem diz o que aconteceu é o `hm-state-screen` em volta. Adesivo: traço e branco fixos, a cor segue família e estado (ver `_illustration-palette.scss`).
|
|
1272
|
+
|
|
1273
|
+
_Sem inputs/outputs._
|
|
1274
|
+
|
|
1275
|
+
## `hm-illustration-journey-end`
|
|
1276
|
+
|
|
1277
|
+
`IllustrationJourneyEndComponent` — import de `@trismegisto/angular/illustration-journey-end`
|
|
1278
|
+
|
|
1279
|
+
Ilustração de fim de jornada (tarefa concluída / sessão finalizada), sem texto e sem ação: só o desenho. Quem diz o que aconteceu é o `hm-state-screen` em volta. Adesivo: traço e branco fixos, a cor segue família e estado (ver `_illustration-palette.scss`).
|
|
1280
|
+
|
|
1281
|
+
_Sem inputs/outputs._
|
|
1282
|
+
|
|
1283
|
+
## `hm-illustration-locked`
|
|
1284
|
+
|
|
1285
|
+
`IllustrationLockedComponent` — import de `@trismegisto/angular/illustration-locked`
|
|
1286
|
+
|
|
1287
|
+
Ilustração de bloqueado (recurso travado), sem texto e sem ação: só o desenho. Quem diz o que aconteceu é o `hm-state-screen` em volta. Adesivo: traço e branco fixos, a cor segue família e estado (ver `_illustration-palette.scss`).
|
|
1288
|
+
|
|
1289
|
+
_Sem inputs/outputs._
|
|
1290
|
+
|
|
1291
|
+
## `hm-illustration-no-permission`
|
|
1292
|
+
|
|
1293
|
+
`IllustrationNoPermissionComponent` — import de `@trismegisto/angular/illustration-no-permission`
|
|
1294
|
+
|
|
1295
|
+
Ilustração de sem permissão, sem texto e sem ação: só o desenho. Quem diz o que aconteceu é o `hm-state-screen` em volta. Adesivo: traço e branco fixos, a cor segue família e estado (ver `_illustration-palette.scss`).
|
|
1296
|
+
|
|
1297
|
+
_Sem inputs/outputs._
|
|
1298
|
+
|
|
1299
|
+
## `hm-illustration-no-results`
|
|
1300
|
+
|
|
1301
|
+
`IllustrationNoResultsComponent` — import de `@trismegisto/angular/illustration-no-results`
|
|
1302
|
+
|
|
1303
|
+
Ilustração de sem resultado (busca/lista vazia), sem texto e sem ação: só o desenho. Quem diz o que aconteceu é o `hm-state-screen` em volta. Adesivo: traço e branco fixos, a cor segue família e estado (ver `_illustration-palette.scss`).
|
|
1304
|
+
|
|
1305
|
+
_Sem inputs/outputs._
|
|
1306
|
+
|
|
1307
|
+
## `hm-illustration-not-found`
|
|
1308
|
+
|
|
1309
|
+
`IllustrationNotFoundComponent` — import de `@trismegisto/angular/illustration-not-found`
|
|
1310
|
+
|
|
1311
|
+
Ilustração de "página não encontrada", sem texto e sem ação: só o desenho. Quem diz o que aconteceu é o `hm-state-screen` em volta. Adesivo: traço e branco fixos, a cor segue família e estado (ver `_illustration-palette.scss`).
|
|
1312
|
+
|
|
1313
|
+
_Sem inputs/outputs._
|
|
1314
|
+
|
|
1315
|
+
## `hm-illustration-session-expired`
|
|
1316
|
+
|
|
1317
|
+
`IllustrationSessionExpiredComponent` — import de `@trismegisto/angular/illustration-session-expired`
|
|
1318
|
+
|
|
1319
|
+
Ilustração de sessão expirada, sem texto e sem ação: só o desenho. Quem diz o que aconteceu é o `hm-state-screen` em volta. Adesivo: traço e branco fixos, a cor segue família e estado (ver `_illustration-palette.scss`).
|
|
1320
|
+
|
|
1321
|
+
_Sem inputs/outputs._
|
|
1322
|
+
|
|
1323
|
+
## `hm-illustration-success`
|
|
1324
|
+
|
|
1325
|
+
`IllustrationSuccessComponent` — import de `@trismegisto/angular/illustration-success`
|
|
1326
|
+
|
|
1327
|
+
Ilustração de sucesso, sem texto e sem ação: só o desenho. Quem diz o que aconteceu é o `hm-state-screen` em volta. Adesivo: traço e branco fixos, a cor segue família e estado (ver `_illustration-palette.scss`).
|
|
1328
|
+
|
|
1329
|
+
_Sem inputs/outputs._
|
|
1330
|
+
|
|
1331
|
+
## `hm-illustration-unlocked`
|
|
1332
|
+
|
|
1333
|
+
`IllustrationUnlockedComponent` — import de `@trismegisto/angular/illustration-unlocked`
|
|
1334
|
+
|
|
1335
|
+
Ilustração de desbloqueado (acesso liberado), sem texto e sem ação: só o desenho. Quem diz o que aconteceu é o `hm-state-screen` em volta. Adesivo: traço e branco fixos, a cor segue família e estado (ver `_illustration-palette.scss`).
|
|
1336
|
+
|
|
1337
|
+
_Sem inputs/outputs._
|
|
1338
|
+
|
|
1339
|
+
## `hm-input`
|
|
1340
|
+
|
|
1341
|
+
`InputComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/input` (também na raiz)
|
|
1342
|
+
|
|
1343
|
+
Campo de texto com rótulo, ícone, texto de apoio e mensagem de erro já ligados por `aria-describedby`/`aria-invalid`. Nome do design anterior; substitui o `hm-field` da 0.1.x.
|
|
1344
|
+
|
|
1345
|
+
Slots: `[hmPrefix]`, `[hmSuffix]`
|
|
1346
|
+
|
|
1347
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1348
|
+
|---|---|---|---|---|
|
|
1349
|
+
| `value` | model | `T` | `'' as T` | |
|
|
1350
|
+
| `label` | input (obrigatório) | `string` | | |
|
|
1351
|
+
| `type` | input | `InputType` | `'text'` | |
|
|
1352
|
+
| `placeholder` | input | `string` | `''` | |
|
|
1353
|
+
| `icon` | input | `string` | `''` | Ícone decorativo no fim do campo. |
|
|
1354
|
+
| `labelHidden` | input | `boolean` | `false` | Esconde o rótulo da vista, mantendo-o para o leitor de tela. |
|
|
1355
|
+
| `hint` | input | `string` | `''` | Texto de apoio embaixo do campo (formato esperado, efeito automático...). |
|
|
1356
|
+
| `prefix` | input | `string` | `''` | Texto antes do valor ("R$"). Anunciado como descrição do campo. |
|
|
1357
|
+
| `suffix` | input | `string` | `''` | Texto depois do valor ("kg"). Anunciado como descrição do campo. |
|
|
1358
|
+
| `prefixIcon` | input | `string` | `''` | Ícone decorativo no início do campo. |
|
|
1359
|
+
| `mask` | input | `HermesMask \| ''` | `''` | Máscara pronta (`cpf`, `cnpj`, `cep`, `phone`) ou padrão customizado; vazio = sem máscara. |
|
|
1360
|
+
| `maskValue` | input | `InputMaskValue` | `'raw'` | |
|
|
1361
|
+
| `min` | input | `number \| null, unknown` | `null` | |
|
|
1362
|
+
| `max` | input | `number \| null, unknown` | `null` | |
|
|
1363
|
+
| `step` | input | `number \| null, unknown` | `null` | |
|
|
1364
|
+
| `stepButtons` | input | `boolean` | `true` | Botões −/+ no `type="number"`. |
|
|
1365
|
+
| `maxLength` | input | `number \| null, unknown` | `null` | Limite de caracteres, com contador visível. Ignorado com `mask`. |
|
|
1366
|
+
| `autocomplete` | input | `string` | `''` | |
|
|
1367
|
+
| `inputMode` | input | `InputMode \| ''` | `''` | Sobrescreve o `inputmode` derivado do tipo/máscara. |
|
|
1368
|
+
| `disabled` | input (herdado) | `boolean` | `false` | |
|
|
1369
|
+
| `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
|
|
1370
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
|
|
1371
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
|
|
1372
|
+
|
|
1373
|
+
## `hm-item-group`
|
|
1374
|
+
|
|
1375
|
+
`ItemGroupComponent` — import de `@trismegisto/angular/item` (também na raiz)
|
|
1376
|
+
|
|
1377
|
+
Lista de `hm-item`: o grupo é `role="list"` e cada item dentro dele vira `role="listitem"` sozinho — o leitor de tela anuncia "lista, 4 itens" e deixa pular a lista inteira.
|
|
1378
|
+
|
|
1379
|
+
Slots: `(padrão)`
|
|
1380
|
+
|
|
1381
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1382
|
+
|---|---|---|---|---|
|
|
1383
|
+
| `label` | input | `string` | `''` | Nome da lista para leitor de tela (`aria-label`). Vazio: sem nome — o título visível em volta basta. |
|
|
1384
|
+
| `divided` | input | `boolean` | `false` | Linha divisória entre os itens (e sem espaço entre eles). |
|
|
1385
|
+
|
|
1386
|
+
## `hm-item`
|
|
1387
|
+
|
|
1388
|
+
`ItemComponent` — import de `@trismegisto/angular/item` (também na raiz)
|
|
1389
|
+
|
|
1390
|
+
Linha genérica de lista: mídia (ícone ou imagem/avatar) à esquerda, título e descrição no meio, ações à direita — e, se precisar, um cabeçalho e um rodapé que ocupam a largura toda.
|
|
1391
|
+
|
|
1392
|
+
Slots: `[itemHeader]`, `[itemActions]`, `[itemFooter]`, `[itemMedia]`, `[itemTitle]`, `(padrão)`
|
|
1393
|
+
|
|
1394
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1395
|
+
|---|---|---|---|---|
|
|
1396
|
+
| `heading` | input | `string` | `''` | Título da linha. Para título com marcação (negrito parcial, etiqueta), use o slot `[itemTitle]`. |
|
|
1397
|
+
| `description` | input | `string` | `''` | Linha de apoio embaixo do título (cortada com reticências depois de duas linhas). |
|
|
1398
|
+
| `icon` | input | `string` | `''` | Ícone do catálogo num quadro à esquerda. Decorativo. Para avatar/imagem, use o slot `[itemMedia]`. |
|
|
1399
|
+
| `appearance` | input | `ItemAppearance` | `'plain'` | |
|
|
1400
|
+
| `size` | input | `ItemSize` | `'medium'` | |
|
|
1401
|
+
| `link` | input | `string` | `''` | Quando preenchido, a linha vira um link (`<a href>`). |
|
|
1402
|
+
| `newTab` | input | `boolean` | `false` | |
|
|
1403
|
+
| `clickable` | input | `boolean` | `false` | A linha vira um `<button>` que emite `clicked` (ignorado com `link`). |
|
|
1404
|
+
| `disabled` | input | `boolean` | `false` | Desabilita a linha clicável (`clickable`). Link não tem estado desabilitado. |
|
|
1405
|
+
| `clicked` | output | `void` | | Clique na linha (com `clickable` ou `link`). Não dispara pelos controles de `[itemActions]`. |
|
|
1406
|
+
|
|
1407
|
+
## `hm-kanban-column`
|
|
1408
|
+
|
|
1409
|
+
`KanbanColumnComponent` — import de `@trismegisto/angular/kanban` (também na raiz)
|
|
1410
|
+
|
|
1411
|
+
Uma coluna do `hm-kanban` — subpeça: o quadro cria uma por item de `columns`; não use solta.
|
|
1412
|
+
|
|
1413
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1414
|
+
|---|---|---|---|---|
|
|
1415
|
+
| `column` | input (obrigatório) | `KanbanColumn<T>` | | A coluna (`{ id, title, items, limit? }`). |
|
|
1416
|
+
|
|
1417
|
+
## `ng-template[hmKanbanCard]`
|
|
1418
|
+
|
|
1419
|
+
`KanbanCardDirective` — import de `@trismegisto/angular/kanban` (também na raiz)
|
|
1420
|
+
|
|
1421
|
+
Template do cartão: `<ng-template hmKanbanCard let-item let-column="column" let-index="index">` dentro do `hm-kanban`. O quadro desenha a moldura do cartão (borda, foco, arrasto); o template desenha só o conteúdo. Botões dentro do cartão continuam clicáveis (pressionar neles não arrasta).
|
|
1422
|
+
|
|
1423
|
+
_Sem inputs/outputs._
|
|
1424
|
+
|
|
1425
|
+
## `ng-template[hmKanbanColumnActions]`
|
|
1426
|
+
|
|
1427
|
+
`KanbanColumnActionsDirective` — import de `@trismegisto/angular/kanban` (também na raiz)
|
|
1428
|
+
|
|
1429
|
+
Ações no cabeçalho de cada coluna (`<ng-template hmKanbanColumnActions let-column>`): o lugar para o app projetar "adicionar cartão", menu da coluna etc. Os formulários são do app.
|
|
1430
|
+
|
|
1431
|
+
_Sem inputs/outputs._
|
|
1432
|
+
|
|
1433
|
+
## `hm-kanban`
|
|
1434
|
+
|
|
1435
|
+
`KanbanComponent` — import de `@trismegisto/angular/kanban` (também na raiz)
|
|
1436
|
+
|
|
1437
|
+
Quadro kanban genérico: colunas com cartões que se movem entre colunas e se reordenam por **ponteiro, toque e teclado** — tudo sobre o serviço de arrastar e soltar do Hermes (`[hmSortable]`/`[hmDraggable]`), sem reimplementar gesto nem teclado.
|
|
1438
|
+
|
|
1439
|
+
Slots: `[hmKanbanToolbar]`, `(padrão)`
|
|
1440
|
+
|
|
1441
|
+
Métodos públicos: `cardTemplate(): TemplateRef<KanbanCardContext<T>> \| null`, `actionsTemplate(): TemplateRef<KanbanColumnContext<T>> \| null`, `isCollapsed(id: string): boolean`, `toggleCollapsed(id: string): void`, `key(item: T): unknown`, `labelOf(item: T): string`, `allows(data: unknown, type: string, to: string): boolean`, `handleSorted(to: string, event: HermesSortEvent<T>): void`
|
|
1442
|
+
|
|
1443
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1444
|
+
|---|---|---|---|---|
|
|
1445
|
+
| `columns` | model | `readonly KanbanColumn<T>[]` | `[]` | As colunas, com os cartões. Two-way: recebe o quadro novo a cada movimento. |
|
|
1446
|
+
| `collapsed` | model | `readonly string[]` | `[]` | Ids das colunas recolhidas. Two-way. |
|
|
1447
|
+
| `canMove` | input | `KanbanCanMove<T> \| null` | `null` | Regra de negócio para mudar de coluna; `null` = tudo liberado. |
|
|
1448
|
+
| `itemKey` | input | `(item: T) => unknown` | `(item: T) => item` | Identidade do cartão (o `track` do `@for`). Padrão: o próprio objeto. |
|
|
1449
|
+
| `itemLabel` | input | `((item: T) => string) \| null` | `null` | Nome falado do cartão nos anúncios. Padrão: o texto do cartão. |
|
|
1450
|
+
| `label` | input | `string` | `''` | Nome do quadro para leitor de tela. Vazio = "Quadro kanban" (catálogo). |
|
|
1451
|
+
| `collapsible` | input | `boolean` | `true` | Mostra o botão de recolher nas colunas. |
|
|
1452
|
+
| `headingLevel` | input | `number` | `3` | Nível do título de cada coluna (`aria-level`). |
|
|
1453
|
+
| `disabled` | input | `boolean` | `false` | Somente leitura: nada se arrasta. |
|
|
1454
|
+
| `moved` | output | `KanbanMoveEvent<T>` | | Um cartão mudou de lugar (já aplicado em `columns`). |
|
|
1455
|
+
|
|
1456
|
+
## `hm-legend`
|
|
1457
|
+
|
|
1458
|
+
`LegendComponent` — import de `@trismegisto/angular/legend` (também na raiz)
|
|
1459
|
+
|
|
1460
|
+
Legenda de cores/status: explica, uma vez só, o que cada cor da tela significa. Serve também de legenda de série para gráficos (`color` por item, `marker="line"`).
|
|
1461
|
+
|
|
1462
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1463
|
+
|---|---|---|---|---|
|
|
1464
|
+
| `items` | input | `readonly LegendItem[]` | `[]` | |
|
|
1465
|
+
| `orientation` | input | `LegendOrientation` | `'vertical'` | `vertical` (padrão) empilha os itens; `horizontal` os põe em linha, quebrando se faltar espaço. |
|
|
1466
|
+
| `marker` | input | `LegendMarker` | `'dot'` | Forma do marcador: `dot` (status), `square` (área/barra) ou `line` (série de linha). |
|
|
1467
|
+
| `label` | input | `string` | `''` | Nome acessível da lista. Vazio cai no "Legenda" do catálogo. |
|
|
1468
|
+
|
|
1469
|
+
## `hm-loading-square`
|
|
1470
|
+
|
|
1471
|
+
`LoadingSquareComponent` — import de `@trismegisto/angular/loading-square` (também na raiz)
|
|
1472
|
+
|
|
1473
|
+
Spinner de carregamento; segue a cor de ação do tema (`--hm-action`). Estilo em @trismegisto/core.
|
|
1474
|
+
|
|
1475
|
+
_Sem inputs/outputs._
|
|
1476
|
+
|
|
1477
|
+
## `hm-menu-button`
|
|
1478
|
+
|
|
1479
|
+
`MenuButtonComponent` — import de `@trismegisto/angular/menu-button` (também na raiz)
|
|
1480
|
+
|
|
1481
|
+
Botão de ícone que abre um `hm-menu` logo abaixo dele: o ícone + seta dos dropdowns de cabeçalho (configurações, ajuda, documentos). Só compõe os dois — não decide os itens nem o que a escolha significa.
|
|
1482
|
+
|
|
1483
|
+
Slots: `(padrão)`
|
|
1484
|
+
|
|
1485
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1486
|
+
|---|---|---|---|---|
|
|
1487
|
+
| `label` | input (obrigatório) | `string` | | Nome acessível do gatilho; o menu reusa o mesmo. |
|
|
1488
|
+
| `icon` | input | `string` | `''` | |
|
|
1489
|
+
| `items` | input (obrigatório) | `readonly MenuItem[]` | | |
|
|
1490
|
+
| `showArrow` | input | `boolean` | `true` | A seta de "abre um menu"; some no ícone que já diz isso. |
|
|
1491
|
+
| `align` | input | `PopoverAlign` | `'start'` | `end` é para o gatilho encostado na borda direita da tela: o menu cresce para a esquerda. |
|
|
1492
|
+
| `side` | input | `PopoverSide` | `'bottom'` | |
|
|
1493
|
+
| `size` | input | `MenuButtonSize` | `'medium'` | |
|
|
1494
|
+
| `shape` | input | `'default' \| 'circle'` | `'default'` | |
|
|
1495
|
+
| `layer` | input | `'default' \| 'above-invoker'` | `'default'` | |
|
|
1496
|
+
| `closeOnCheck` | input | `boolean` | `false` | Itens checkbox/rádio: fecha o menu ao marcar (padrão: continua aberto, como no `hm-menu`). |
|
|
1497
|
+
| `chosen` | output | `string` | | |
|
|
1498
|
+
| `checkedChange` | output | `MenuItemChange` | | Um item checkbox/rádio mudou; aplique em `items` com `applyMenuItemChange`. |
|
|
1499
|
+
|
|
1500
|
+
## `[hmContextMenu]`
|
|
1501
|
+
|
|
1502
|
+
`ContextMenuDirective` — import de `@trismegisto/angular/menu` (também na raiz)
|
|
1503
|
+
|
|
1504
|
+
Menu de contexto num elemento qualquer: `<div [hmContextMenu]="items" (chosen)="run($event)">`.
|
|
1505
|
+
|
|
1506
|
+
Métodos públicos: `openAt(x: number, y: number): boolean`, `close(): void`
|
|
1507
|
+
|
|
1508
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1509
|
+
|---|---|---|---|---|
|
|
1510
|
+
| `hmContextMenu` | input (obrigatório) | `readonly MenuItem[]` | | |
|
|
1511
|
+
| `hmContextMenuLabel` | input | `string` | `''` | Nome do menu para leitor de tela; vazio = texto padrão do catálogo (`menu.contextLabel`). |
|
|
1512
|
+
| `hmContextMenuDisabled` | input | `boolean` | `false` | Desliga o menu próprio (o nativo do navegador volta). |
|
|
1513
|
+
| `hmContextMenuLayer` | input | `'default' \| 'above-invoker'` | `'default'` | Ver `hm-menu`: `above-invoker` quando o host está dentro de um overlay (ex.: modal). |
|
|
1514
|
+
| `hmContextMenuCloseOnCheck` | input | `boolean` | `false` | Ver `hm-menu`: fecha ao marcar um item `checkbox`/`radio` (padrão: continua aberto). |
|
|
1515
|
+
| `chosen` | output | `string` | | Id do item escolhido. |
|
|
1516
|
+
| `checkedChange` | output | `MenuItemChange` | | Um item `checkbox`/`radio` foi marcado/desmarcado (ver `hm-menu`). |
|
|
1517
|
+
|
|
1518
|
+
## `hm-menu`
|
|
1519
|
+
|
|
1520
|
+
`MenuComponent` — import de `@trismegisto/angular/menu` (também na raiz)
|
|
1521
|
+
|
|
1522
|
+
Pop-over e menu de contexto na mesma peça: abre numa coordenada da viewport, navega por seta e devolve o id da ação escolhida. Apontando um **retângulo** (o botão que o abriu) ele é o pop-over, com vão e bico; apontando um **ponto** (o cursor do botão direito) nasce no cursor, sem vão e sem bico.
|
|
1523
|
+
|
|
1524
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1525
|
+
|---|---|---|---|---|
|
|
1526
|
+
| `anchor` | input (obrigatório) | `PopoverAnchor \| null` | | Coordenada da viewport; `null` = fechado. |
|
|
1527
|
+
| `items` | input (obrigatório) | `readonly MenuItem[]` | | |
|
|
1528
|
+
| `label` | input (obrigatório) | `string` | | Nome do menu para leitor de tela. |
|
|
1529
|
+
| `layer` | input | `'default' \| 'above-invoker'` | `'default'` | `above-invoker`: quando o menu abre de dentro de um overlay (ex.: modal) e precisa ficar por cima dele. |
|
|
1530
|
+
| `closeOnCheck` | input | `boolean` | `false` | Fecha o menu ao marcar um item `checkbox`/`radio` (padrão: continua aberto). |
|
|
1531
|
+
| `initialFocus` | input | `'first' \| 'last'` | `'first'` | Onde o foco entra ao abrir: no primeiro item (padrão) ou no último (↑ num gatilho de barra de menus). |
|
|
1532
|
+
| `chosen` | output | `string` | | |
|
|
1533
|
+
| `closed` | output | `void` | | |
|
|
1534
|
+
| `checkedChange` | output | `MenuItemChange` | | Um item `checkbox`/`radio` foi marcado/desmarcado. |
|
|
1535
|
+
| `navigate` | output | `'previous' \| 'next'` | | ←/→ num item sem submenu, no nível de cima (ou → dentro de um submenu): pedido para ir ao menu vizinho. Só quem compõe o menu numa barra (`hm-menubar`) usa; so… |
|
|
1536
|
+
| `pointerOutside` | output | `MouseEvent` | | Ponteiro no fundo transparente (fora do cartão): `pointermove` e `click`, com as coordenadas. Gancho para peças compostas (a barra de menus troca de menu ao pa… |
|
|
1537
|
+
|
|
1538
|
+
## `hm-menubar`
|
|
1539
|
+
|
|
1540
|
+
`MenubarComponent` — import de `@trismegisto/angular/menubar` (também na raiz)
|
|
1541
|
+
|
|
1542
|
+
Barra de menus no estilo dos aplicativos de desktop ("Arquivo · Editar · Exibir"): uma fileira de títulos, cada um abrindo um `hm-menu` logo abaixo, com os mesmos itens (`MenuItem`) — ações, submenus, `checkbox` e `radio`.
|
|
1543
|
+
|
|
1544
|
+
Métodos públicos: `open(index: number, focus: 'first' \| 'last' = 'first'): void`, `close(returnFocus = true): void`
|
|
1545
|
+
|
|
1546
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1547
|
+
|---|---|---|---|---|
|
|
1548
|
+
| `menus` | input (obrigatório) | `readonly MenubarMenu[]` | | Os menus da barra, na ordem. |
|
|
1549
|
+
| `label` | input (obrigatório) | `string` | | Nome da barra para leitor de tela (ex.: "Editor de texto"). |
|
|
1550
|
+
| `closeOnCheck` | input | `boolean` | `false` | Fecha o menu ao marcar um item `checkbox`/`radio` (padrão: continua aberto, como no `hm-menu`). |
|
|
1551
|
+
| `chosen` | output | `string` | | Id do item escolhido (de qualquer menu): mantenha os ids únicos na barra inteira. |
|
|
1552
|
+
| `checkedChange` | output | `MenuItemChange` | | Um item `checkbox`/`radio` de algum menu foi marcado/desmarcado. |
|
|
1553
|
+
|
|
1554
|
+
## `hm-message-divider`
|
|
1555
|
+
|
|
1556
|
+
`MessageDividerComponent` — import de `@trismegisto/angular/message-divider` (também na raiz)
|
|
1557
|
+
|
|
1558
|
+
Divisor de conversa: uma linha no fluxo das mensagens que não é mensagem de ninguém — quebra de data, começo de uma conversa nova, um evento do sistema.
|
|
1559
|
+
|
|
1560
|
+
Slots: `(padrão)`
|
|
1561
|
+
|
|
1562
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1563
|
+
|---|---|---|---|---|
|
|
1564
|
+
| `label` | input | `string` | `''` | Texto do divisor. Conteúdo projetado também vale (um `<time>`, um link). |
|
|
1565
|
+
| `icon` | input | `string` | `''` | Ícone antes do texto (decorativo; o app registra). |
|
|
1566
|
+
| `variant` | input | `MessageDividerVariant` | `'separator'` | |
|
|
1567
|
+
|
|
1568
|
+
## `hm-message-scroller`
|
|
1569
|
+
|
|
1570
|
+
`MessageScrollerComponent` — import de `@trismegisto/angular/message-scroller` (também na raiz)
|
|
1571
|
+
|
|
1572
|
+
Contêiner de uma conversa: rola, acompanha o fim quando chegam mensagens e carrega histórico pelo topo sem tirar a pessoa do lugar.
|
|
1573
|
+
|
|
1574
|
+
Slots: `(padrão)`
|
|
1575
|
+
|
|
1576
|
+
Métodos públicos: `scrollToEnd(behavior: ScrollBehavior = 'auto'): void`, `announce(message: string): void`
|
|
1577
|
+
|
|
1578
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1579
|
+
|---|---|---|---|---|
|
|
1580
|
+
| `label` | input | `string` | `''` | Nome da região da conversa ("Conversa com Ana"). Padrão: `conversation.label` do catálogo. |
|
|
1581
|
+
| `hasMoreHistory` | input | `boolean` | `false` | Há mensagens anteriores a buscar: mostra o botão no topo e liga o pedido ao rolar até lá. |
|
|
1582
|
+
| `loadingHistory` | input | `boolean` | `false` | O histórico pedido está a caminho: indicador no topo e nenhum pedido novo. |
|
|
1583
|
+
| `autoLoadHistory` | input | `boolean` | `true` | Chegar ao topo rolando já pede histórico (além do botão). |
|
|
1584
|
+
| `live` | input | `MessageScrollerLive` | `'polite'` | Anúncio de mensagem nova pelo componente (`polite`) ou nenhum (`off`). |
|
|
1585
|
+
| `itemSelector` | input | `string` | `'hm-message'` | Seletor CSS do que conta como mensagem (contagem, anúncio, âncora de leitura). |
|
|
1586
|
+
| `threshold` | input | `number` | `32` | Folga, em px, para considerar a rolagem no fim/no topo. |
|
|
1587
|
+
| `loadHistory` | output | `void` | | Pedido de mensagens anteriores (botão do topo ou rolagem até o topo). |
|
|
1588
|
+
| `atEndChange` | output | `boolean` | | A rolagem chegou ao fim (`true`) ou saiu dele (`false`) — útil para marcar como lidas. |
|
|
1589
|
+
|
|
1590
|
+
## `hm-message`
|
|
1591
|
+
|
|
1592
|
+
`MessageComponent` — import de `@trismegisto/angular/message` (também na raiz)
|
|
1593
|
+
|
|
1594
|
+
Bloco de uma mensagem numa conversa: avatar, cabeçalho (autor e horário), o conteúdo projetado (normalmente um ou mais `hm-bubble`) e um rodapé com o estado de envio e ações.
|
|
1595
|
+
|
|
1596
|
+
Slots: `(padrão)`, `[hmMessageActions]`
|
|
1597
|
+
|
|
1598
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1599
|
+
|---|---|---|---|---|
|
|
1600
|
+
| `author` | input | `string` | `''` | Nome de quem escreveu: cabeçalho, iniciais do avatar e nome acessível do bloco. |
|
|
1601
|
+
| `avatarUrl` | input | `string \| null \| undefined` | `null` | Foto do autor (opcional; sem ela, as iniciais de `author`). |
|
|
1602
|
+
| `time` | input | `Date \| number \| string \| null \| undefined` | `null` | Horário da mensagem — o que `new Date()` aceita. Inválido ou vazio: sem horário. |
|
|
1603
|
+
| `timeFormat` | input | `Intl.DateTimeFormatOptions` | `{ hour: '2-digit', minute: '2-digit' }` | Como formatar `time` (`Intl.DateTimeFormat`, no idioma ativo da lib). Padrão: hora e minuto. |
|
|
1604
|
+
| `align` | input | `MessageAlign` | `'start'` | |
|
|
1605
|
+
| `grouped` | input | `boolean` | `false` | Continuação da mensagem anterior do mesmo autor: sem avatar e com o cabeçalho só para o leitor de tela. |
|
|
1606
|
+
| `showAvatar` | input | `boolean` | `true` | Mostra a coluna do avatar. Comum desligar nas mensagens `end` (quem lê sabe que foi ela). |
|
|
1607
|
+
| `status` | input | `MessageStatus \| null` | `null` | Estado de envio no rodapé; `null` = nenhum. |
|
|
1608
|
+
| `announce` | input | `boolean` | `true` | Entra no anúncio (e na contagem) de mensagem nova do `hm-message-scroller`. Desligue no indicador de digitação e em mensagens que não são novidade. As `end` (e… |
|
|
1609
|
+
| `retry` | output | `void` | | "Tentar de novo" do estado `failed`. |
|
|
1610
|
+
|
|
1611
|
+
## `hm-modal`
|
|
1612
|
+
|
|
1613
|
+
`ModalComponent` — import de `@trismegisto/angular/modal` (também na raiz)
|
|
1614
|
+
|
|
1615
|
+
Diálogo modal genérico: sobreposição, foco preso na janela, Esc para fechar, retorno de foco a quem abriu, scroll do body travado.
|
|
1616
|
+
|
|
1617
|
+
Slots: `(padrão)`, `[footer]`
|
|
1618
|
+
|
|
1619
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1620
|
+
|---|---|---|---|---|
|
|
1621
|
+
| `open` | model (obrigatório) | `boolean` | | Visibilidade. Two-way: o próprio modal fecha no Esc e no X. |
|
|
1622
|
+
| `heading` | input (obrigatório) | `string` | | Título da janela: também o rótulo acessível do dialog. |
|
|
1623
|
+
| `size` | input | `ModalSize` | `'medium'` | Largura: `small` (320px), `medium` (640px, padrão), `large` (960px), `xlarge` (1280px) ou `full` (tela cheia: a janela vira a viewport, sem cantos, com a área… |
|
|
1624
|
+
| `closeLabel` | input | `string` | `''` | Vazio = texto do catálogo no idioma ativo (`HERMES_MESSAGES.modal.close`). |
|
|
1625
|
+
| `closable` | input | `boolean` | `true` | |
|
|
1626
|
+
| `beforeClose` | input | `(() => boolean \| Promise<boolean>) \| null` | `null` | Guarda de fechamento (padrão de mercado, como o `canDeactivate`/`beforeClose` dos overlays): chamada antes de o X, o Esc ou o fundo fecharem. Devolvendo `false… |
|
|
1627
|
+
| `closed` | output | `void` | | |
|
|
1628
|
+
|
|
1629
|
+
## `hm-animated-number`
|
|
1630
|
+
|
|
1631
|
+
`AnimatedNumberComponent` — import de `@trismegisto/angular/motion` (também na raiz)
|
|
1632
|
+
|
|
1633
|
+
Número que **conta até o valor** quando entra na vista, e conta de novo (a partir do valor atual) quando o valor muda.
|
|
1634
|
+
|
|
1635
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1636
|
+
|---|---|---|---|---|
|
|
1637
|
+
| `value` | input (obrigatório) | `number` | | O valor final, cru. |
|
|
1638
|
+
| `format` | input | `Intl.NumberFormatOptions` | `{}` | Opções do `Intl.NumberFormat` (moeda, porcentagem, unidade, notação compacta…). |
|
|
1639
|
+
| `duration` | input | `number` | `1000` | Duração da contagem em milissegundos. |
|
|
1640
|
+
| `from` | input | `number` | `0` | De onde a primeira contagem parte. |
|
|
1641
|
+
|
|
1642
|
+
## `[hmFlip]`
|
|
1643
|
+
|
|
1644
|
+
`FlipDirective` — import de `@trismegisto/angular/motion` (também na raiz)
|
|
1645
|
+
|
|
1646
|
+
Rearranjo animado (técnica FLIP): ao reordenar, os itens **deslizam** até a posição nova em vez de saltarem para ela. Útil em listas reordenáveis (`hm-reorder-list`), quadros (`hm-kanban`), grades de cartões e resultados que mudam de ordem.
|
|
1647
|
+
|
|
1648
|
+
Métodos públicos: `capture(): void`
|
|
1649
|
+
|
|
1650
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1651
|
+
|---|---|---|---|---|
|
|
1652
|
+
| `hmFlip` | input | `unknown` | `undefined` | Gatilho: qualquer valor que muda quando a ordem muda (a própria lista, uma versão…). |
|
|
1653
|
+
| `hmFlipItems` | input | `string` | `''` | Seletor CSS dos itens animados, relativo ao contêiner (padrão: filhos diretos). |
|
|
1654
|
+
| `hmFlipDuration` | input | `number \| null` | `null` | Duração em ms; `null` lê `--hm-duration-standard`. |
|
|
1655
|
+
| `hmFlipEasing` | input | `string` | `''` | Curva CSS; vazio lê `--hm-ease-standard`. |
|
|
1656
|
+
|
|
1657
|
+
## `[hmReveal]`
|
|
1658
|
+
|
|
1659
|
+
`RevealDirective` — import de `@trismegisto/angular/motion` (também na raiz)
|
|
1660
|
+
|
|
1661
|
+
Revelação ao rolar: o bloco sobe um degrau e aparece quando entra na vista (`IntersectionObserver`).
|
|
1662
|
+
|
|
1663
|
+
Métodos públicos: `reveal(): void`
|
|
1664
|
+
|
|
1665
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1666
|
+
|---|---|---|---|---|
|
|
1667
|
+
| `hmRevealDelay` | input | `number` | `0` | Atraso em ms antes de revelar (para escalonar uma sequência). |
|
|
1668
|
+
| `hmRevealThreshold` | input | `number` | `0.15` | Quanto o topo do bloco precisa subir na vista para revelar, em fração da altura da vista (0 a 0,9; `0.15` = quando passa dos 85% de baixo). Margem, não fração… |
|
|
1669
|
+
| `hmRevealOnce` | input | `boolean` | `true` | `false` esconde de novo ao sair da vista (revela a cada passagem). |
|
|
1670
|
+
| `revealed` | output | `void` | | Emite quando o bloco é revelado. |
|
|
1671
|
+
|
|
1672
|
+
## `hm-navigation-menu-item`
|
|
1673
|
+
|
|
1674
|
+
`NavigationMenuItemComponent` — import de `@trismegisto/angular/navigation-menu` (também na raiz)
|
|
1675
|
+
|
|
1676
|
+
Um item da barra do `hm-navigation-menu`. Com `href` ou `route` é um **link** direto; sem eles é um **botão que abre um painel** com o conteúdo projetado (normalmente `hm-navigation-menu-link`s, mas aceita qualquer conteúdo: um título de grupo, um destaque, um parágrafo).
|
|
1677
|
+
|
|
1678
|
+
Slots: `(padrão)`
|
|
1679
|
+
|
|
1680
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1681
|
+
|---|---|---|---|---|
|
|
1682
|
+
| `label` | input (obrigatório) | `string` | | Texto do link ou do botão do painel. |
|
|
1683
|
+
| `href` | input | `string \| null` | `null` | Destino do link direto (URL comum). Com `href` (ou `route`), o item não tem painel. |
|
|
1684
|
+
| `route` | input | `string \| readonly unknown[] \| null` | `null` | Destino do link direto pelo roteador (o valor de um `routerLink`). Marca `aria-current="page"` sozinho. |
|
|
1685
|
+
| `exact` | input | `boolean` | `false` | Com `route`: só marca como atual com a URL exatamente igual (padrão: também nas rotas filhas). |
|
|
1686
|
+
| `current` | input | `boolean` | `false` | Com `href`: este link é a página atual (`aria-current="page"`). |
|
|
1687
|
+
| `columns` | input | `number` | `1` | Colunas do painel na barra larga (na tela estreita é sempre uma). |
|
|
1688
|
+
|
|
1689
|
+
## `hm-navigation-menu-link`
|
|
1690
|
+
|
|
1691
|
+
`NavigationMenuLinkComponent` — import de `@trismegisto/angular/navigation-menu` (também na raiz)
|
|
1692
|
+
|
|
1693
|
+
Link dentro do painel de um `hm-navigation-menu-item`: título, descrição curta opcional e ícone opcional, num bloco clicável inteiro. É um `<a>` de verdade (o painel é navegação, não menu de comandos). Clicar fecha o painel sozinho (o `hm-navigation-menu` escuta os links dele).
|
|
1694
|
+
|
|
1695
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1696
|
+
|---|---|---|---|---|
|
|
1697
|
+
| `label` | input (obrigatório) | `string` | | Título do link (o nome acessível; a descrição entra junto, como texto do link). |
|
|
1698
|
+
| `description` | input | `string` | `''` | Uma linha dizendo o que há no destino. |
|
|
1699
|
+
| `icon` | input | `string` | `''` | Ícone à esquerda (nome do catálogo; o app registra). |
|
|
1700
|
+
| `href` | input | `string \| null` | `null` | Destino (URL comum). |
|
|
1701
|
+
| `route` | input | `string \| readonly unknown[] \| null` | `null` | Destino pelo roteador (o valor de um `routerLink`); tem precedência sobre `href`. |
|
|
1702
|
+
| `exact` | input | `boolean` | `false` | Com `route`: só marca como atual com a URL exatamente igual. |
|
|
1703
|
+
| `current` | input | `boolean` | `false` | Com `href`: este link é a página atual (`aria-current="page"`). |
|
|
1704
|
+
|
|
1705
|
+
## `hm-navigation-menu`
|
|
1706
|
+
|
|
1707
|
+
`NavigationMenuComponent` — import de `@trismegisto/angular/navigation-menu` (também na raiz)
|
|
1708
|
+
|
|
1709
|
+
Navegação principal horizontal com painéis ("mega menu"): cada item é um **link** direto ou um **botão que abre um painel** com conteúdo projetado (grupos de links, um destaque, texto curto).
|
|
1710
|
+
|
|
1711
|
+
Slots: `(padrão)`
|
|
1712
|
+
|
|
1713
|
+
Métodos públicos: `toggle(key: string): void`, `hoverTrigger(key: string, event: PointerEvent): void`, `leaveTrigger(): void`, `close(): void`
|
|
1714
|
+
|
|
1715
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1716
|
+
|---|---|---|---|---|
|
|
1717
|
+
| `label` | input (obrigatório) | `string` | | Nome da navegação (`aria-label` do `<nav>` e do botão de menu na tela estreita). Obrigatório quando há mais de um `<nav>` na página. |
|
|
1718
|
+
| `openOnHover` | input | `boolean` | `true` | Abre o painel ao passar o mouse sobre o botão (só mouse, só na barra larga). |
|
|
1719
|
+
| `openDelay` | input | `number` | `NAVIGATION_MENU_OPEN_DELAY` | Espera (ms) com o mouse sobre um botão antes de abrir o painel. |
|
|
1720
|
+
| `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
|
+
|
|
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
|
+
## `hm-page-header`
|
|
1738
|
+
|
|
1739
|
+
`PageHeaderComponent` — import de `@trismegisto/angular/page-header` (também na raiz)
|
|
1740
|
+
|
|
1741
|
+
Cabeçalho de página: título, trilha de navegação opcional, descrição, metadados/status e as ações que valem para a página inteira.
|
|
1742
|
+
|
|
1743
|
+
Slots: `[actions]`, `[meta]`
|
|
1744
|
+
|
|
1745
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1746
|
+
|---|---|---|---|---|
|
|
1747
|
+
| `heading` | input (obrigatório) | `string` | | Título da página. |
|
|
1748
|
+
| `level` | input | `PageHeaderLevel` | `1` | Nível do título (`<h1>`…`<h6>`). Ver a nota da classe sobre um único `<h1>`. |
|
|
1749
|
+
| `headingId` | input | `string` | `''` | `id` do título, para `aria-labelledby` da seção que ele nomeia. |
|
|
1750
|
+
| `description` | input | `string` | `''` | Texto de apoio fixo embaixo do título. |
|
|
1751
|
+
| `summary` | input | `string` | `''` | Contagem/resumo vivo da listagem — anunciado (`role="status"`). |
|
|
1752
|
+
| `breadcrumb` | input | `readonly BreadcrumbItem[]` | `[]` | Trilha de navegação, abaixo do título (reusa `hm-breadcrumb`). Vazia = sem trilha. |
|
|
1753
|
+
| `breadcrumbLabel` | input | `string` | `''` | Nome do `nav` da trilha. Vazio = catálogo ("Você está aqui"); dê outro quando houver duas trilhas na tela. |
|
|
1754
|
+
| `loading` | input | `boolean` | `false` | Silhueta no título, na trilha e no resumo enquanto a tela resolve. |
|
|
1755
|
+
| `breadcrumbClick` | output | `BreadcrumbItem` | | Clique num degrau da trilha (repassado do `hm-breadcrumb`). |
|
|
1756
|
+
|
|
1757
|
+
## `hm-paginator`
|
|
1758
|
+
|
|
1759
|
+
`PaginatorComponent` — import de `@trismegisto/angular/paginator` (também na raiz)
|
|
1760
|
+
|
|
1761
|
+
Controle de paginação: saltos pras pontas, passo a passo, e os números das páginas — a janela desliza em vez de paginar em blocos, então ir de 7 pra 8 não troca a fileira inteira.
|
|
1762
|
+
|
|
1763
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1764
|
+
|---|---|---|---|---|
|
|
1765
|
+
| `state` | input | `PaginationState` | `DEFAULT_STATE` | Página e tamanho atuais. Obrigatório na `full`; na `simple` com cursor pode ficar de fora. |
|
|
1766
|
+
| `totalItems` | input | `number \| null` | `null` | Total de registros. `null` = desconhecido (só faz sentido na `simple`, com `hasNext`). |
|
|
1767
|
+
| `variant` | input | `PaginatorVariant` | `'full'` | |
|
|
1768
|
+
| `label` | input | `string` | `''` | Nome do `nav`. Vazio usa "Paginação" do catálogo. Dê um nome próprio quando houver mais de um paginador na tela (dois landmarks `nav` com o mesmo nome não se d… |
|
|
1769
|
+
| `showPage` | input | `boolean` | `true` | Na `simple`, mostra a posição ("Página 2 de 5", ou "Página 2" sem total). |
|
|
1770
|
+
| `hasNext` | input | `boolean \| undefined` | `undefined` | Há página seguinte? Vazio = calcula pelo total. Use em listas com cursor. |
|
|
1771
|
+
| `hasPrevious` | input | `boolean \| undefined` | `undefined` | Há página anterior? Vazio = calcula pela página atual. |
|
|
1772
|
+
| `sizes` | input | `readonly number[]` | `DEFAULT_SIZES` | |
|
|
1773
|
+
| `maxNumbers` | input | `number` | `7` | Quantos números aparecem antes de a lista virar reticências. |
|
|
1774
|
+
| `stateChanged` | output | `PaginationState` | | |
|
|
1775
|
+
| `nextPage` | output | `void` | | "Próxima página" acionado (as duas variantes) — o gatilho para buscar o próximo cursor. |
|
|
1776
|
+
| `previousPage` | output | `void` | | "Página anterior" acionado (as duas variantes). |
|
|
1777
|
+
|
|
1778
|
+
## `| hmDate` (pipe)
|
|
1779
|
+
|
|
1780
|
+
`HermesDatePipe` — import de `@trismegisto/angular/pipes` (também na raiz)
|
|
1781
|
+
|
|
1782
|
+
Data no idioma ativo da Hermes (`HermesI18nService`), por `Intl.DateTimeFormat`:
|
|
1783
|
+
|
|
1784
|
+
Assinatura: `transform(value: HermesDateInput, presetOrOptions?: HermesDatePreset \| Intl.DateTimeFormatOptions, options?: Intl.DateTimeFormatOptions): string`
|
|
1785
|
+
|
|
1786
|
+
|
|
1787
|
+
## `| hmDateTime` (pipe)
|
|
1788
|
+
|
|
1789
|
+
`HermesDateTimePipe` — import de `@trismegisto/angular/pipes` (também na raiz)
|
|
1790
|
+
|
|
1791
|
+
Data e hora no idioma ativo da Hermes — igual ao `hmDate`, com o preset aplicado também à hora (`timeStyle`): `'short'` (padrão) = 03/10/2026, 14:30; `'medium'` com segundos; `'long'`/`'full'` com o fuso. Relógio de 12/24 h segue o idioma; para forçar, `{ hourCycle: 'h23' }`.
|
|
1792
|
+
|
|
1793
|
+
Assinatura: `transform(value: HermesDateInput, presetOrOptions?: HermesDatePreset \| Intl.DateTimeFormatOptions, options?: Intl.DateTimeFormatOptions): string`
|
|
1794
|
+
|
|
1795
|
+
|
|
1796
|
+
## `| hmTranslate` (pipe)
|
|
1797
|
+
|
|
1798
|
+
`HermesTranslatePipe` — import de `@trismegisto/angular/pipes` (também na raiz)
|
|
1799
|
+
|
|
1800
|
+
Texto do catálogo do `HermesI18nService` pela chave (`seção.chave`), no idioma ativo:
|
|
1801
|
+
|
|
1802
|
+
Assinatura: `transform(key: string \| null \| undefined, params?: MessageParams): string`
|
|
1803
|
+
|
|
1804
|
+
|
|
1805
|
+
## `[hmPopoverTrigger]`
|
|
1806
|
+
|
|
1807
|
+
`PopoverTriggerDirective` — import de `@trismegisto/angular/popover` (também na raiz)
|
|
1808
|
+
|
|
1809
|
+
Gatilho de um `hm-popover`: alterna o cartão no clique e mantém o ARIA do botão em dia — `aria-haspopup="dialog"`, `aria-expanded` e `aria-controls` (só enquanto aberto, apontando para o id do cartão). Vá num elemento que já é botão (`<button>`, `hm-button`, `hm-icon-button`) ou link: a diretiva não cria papel nem foco próprios.
|
|
1810
|
+
|
|
1811
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1812
|
+
|---|---|---|---|---|
|
|
1813
|
+
| `hmPopoverTrigger` | input (obrigatório) | `PopoverComponent` | | O `hm-popover` controlado por este gatilho (referência de template: `#pop`). |
|
|
1814
|
+
|
|
1815
|
+
## `hm-popover`
|
|
1816
|
+
|
|
1817
|
+
`PopoverComponent` — import de `@trismegisto/angular/popover` (também na raiz)
|
|
1818
|
+
|
|
1819
|
+
Popover: cartão não modal ancorado num gatilho, com conteúdo livre (texto, formulário curto, lista de filtros, detalhes de um item). Par com a diretiva `[hmPopoverTrigger]`:
|
|
1820
|
+
|
|
1821
|
+
Slots: `(padrão)`
|
|
1822
|
+
|
|
1823
|
+
Métodos públicos: `show(trigger?: HTMLElement): void`, `close(): void`, `toggle(trigger?: HTMLElement): void`, `registerTrigger(trigger: HTMLElement): void`, `unregisterTrigger(trigger: HTMLElement): void`, `hoverEnter(trigger: HTMLElement): void`, `hoverLeave(): void`, `focusEnter(trigger: HTMLElement): boolean`, `contains(node: Node \| null): boolean`, `focusContent(): boolean`
|
|
1824
|
+
|
|
1825
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1826
|
+
|---|---|---|---|---|
|
|
1827
|
+
| `open` | model | `boolean` | `false` | Aberto/fechado. `[(open)]` para controlar de fora; sem binding, o próprio popover controla. |
|
|
1828
|
+
| `heading` | input | `string` | `''` | Título visível; também nomeia o diálogo (`aria-labelledby`). |
|
|
1829
|
+
| `headingLevel` | input | `number` | `2` | Nível do título para o leitor de tela (`aria-level`). |
|
|
1830
|
+
| `label` | input | `string` | `''` | Nome acessível quando não há `heading` visível. |
|
|
1831
|
+
| `side` | input | `PopoverSide` | `'bottom'` | Lado preferido em relação ao gatilho; vira para o oposto quando não cabe. |
|
|
1832
|
+
| `align` | input | `PopoverAlign` | `'start'` | Encosto no eixo cruzado; troca sozinho por outro que caiba. |
|
|
1833
|
+
| `arrow` | input | `boolean` | `true` | Bico apontando para o gatilho. |
|
|
1834
|
+
| `closable` | input | `boolean` | `false` | Botão de fechar no cabeçalho. Opcional: `Esc` e clique fora já fecham. |
|
|
1835
|
+
| `closeLabel` | input | `string` | `''` | Nome do botão de fechar (padrão do catálogo: "Fechar"). |
|
|
1836
|
+
| `closeOnOutsideClick` | input | `boolean` | `true` | `false` mantém o cartão aberto ao clicar fora (ex.: conteúdo que a pessoa compara com a página). |
|
|
1837
|
+
| `openOn` | input | `'click' \| 'hover'` | `'click'` | `click` (padrão): abre e fecha no clique do gatilho. `hover`: abre ao passar o mouse ou focar o gatilho pelo teclado, com atrasos; no toque, o toque abre e fec… |
|
|
1838
|
+
| `openDelay` | input | `number` | `HOVER_OPEN_DELAY` | Só em `openOn="hover"`: espera (ms) com o mouse/foco no gatilho antes de abrir. |
|
|
1839
|
+
| `closeDelay` | input | `number` | `HOVER_CLOSE_DELAY` | Só em `openOn="hover"`: espera (ms) depois de o mouse sair antes de fechar. |
|
|
1840
|
+
|
|
1841
|
+
## `hm-progress`
|
|
1842
|
+
|
|
1843
|
+
`ProgressComponent` — import de `@trismegisto/angular/progress` (também na raiz)
|
|
1844
|
+
|
|
1845
|
+
Barra de progresso (`role="progressbar"`).
|
|
1846
|
+
|
|
1847
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1848
|
+
|---|---|---|---|---|
|
|
1849
|
+
| `value` | input | `number` | `0` | |
|
|
1850
|
+
| `max` | input | `number` | `100` | |
|
|
1851
|
+
| `label` | input | `string` | `''` | O que está progredindo. Visível quando `labelHidden` é falso. |
|
|
1852
|
+
| `labelHidden` | input | `boolean` | `false` | |
|
|
1853
|
+
| `showValue` | input | `boolean` | `false` | Mostra a porcentagem à direita do rótulo. |
|
|
1854
|
+
| `indeterminate` | input | `boolean` | `false` | |
|
|
1855
|
+
| `intent` | input | `ProgressIntent` | `'accent'` | |
|
|
1856
|
+
| `size` | input | `ProgressSize` | `'medium'` | Espessura da trilha. |
|
|
1857
|
+
| `hint` | input | `string` | `''` | Texto de apoio embaixo da barra ("3 de 8 arquivos"). |
|
|
1858
|
+
|
|
1859
|
+
## `hm-property-view`
|
|
1860
|
+
|
|
1861
|
+
`PropertyViewComponent` — import de `@trismegisto/angular/property-view` (também na raiz)
|
|
1862
|
+
|
|
1863
|
+
Grade de propriedades nome/valor, agrupadas em seções recolhíveis, com busca e **edição inline opcional** por tipo. Diferente do `hm-description-list`, que só exibe uma ficha: aqui o modelo é `[(values)]` e cada linha pode virar editor.
|
|
1864
|
+
|
|
1865
|
+
Métodos públicos: `currentErrors(): Readonly<Record<string, string>>`
|
|
1866
|
+
|
|
1867
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1868
|
+
|---|---|---|---|---|
|
|
1869
|
+
| `properties` | input | `readonly PropertyDefinition[]` | `[]` | As propriedades (linhas), na ordem dentro de cada grupo. |
|
|
1870
|
+
| `groups` | input | `readonly PropertyGroup[]` | `[]` | Os grupos (seções recolhíveis), na ordem da tela. |
|
|
1871
|
+
| `values` | model | `PropertyValues` | `{}` | Valores por chave. Two-way: recebe a cópia com a mudança a cada edição. |
|
|
1872
|
+
| `editable` | input | `boolean` | `false` | Liga a edição inline. Padrão: somente leitura. |
|
|
1873
|
+
| `searchable` | input | `boolean` | `false` | Mostra a busca por propriedade. |
|
|
1874
|
+
| `label` | input | `string` | `''` | Nome da grade para leitor de tela. Vazio = "Propriedades" (catálogo). |
|
|
1875
|
+
| `headingLevel` | input | `number` | `3` | Nível dos cabeçalhos de grupo (`aria-level`). |
|
|
1876
|
+
| `propertyChange` | output | `PropertyChangeEvent` | | Uma propriedade foi editada. |
|
|
1877
|
+
|
|
1878
|
+
## `hm-radio`
|
|
1879
|
+
|
|
1880
|
+
`RadioComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/radio` (também na raiz)
|
|
1881
|
+
|
|
1882
|
+
Grupo de opções mutuamente exclusivas. Mesmo contrato dos outros controles: Reactive Forms, `[(ngModel)]` ou `[(value)]` (ver `HermesFormFieldBase`).
|
|
1883
|
+
|
|
1884
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1885
|
+
|---|---|---|---|---|
|
|
1886
|
+
| `value` | model | `string` | `''` | |
|
|
1887
|
+
| `label` | input (obrigatório) | `string` | | |
|
|
1888
|
+
| `options` | input (obrigatório) | `readonly RadioOption[]` | | |
|
|
1889
|
+
| `appearance` | input | `RadioAppearance \| undefined` | `undefined` | `'list'` (padrão, também sem valor): rádios em lista. `'card'`: cada opção num cartão (ver doc da classe). Sem padrão literal de propósito: o gerador de ícones… |
|
|
1890
|
+
| `layout` | input | `RadioLayout \| undefined` | `undefined` | `'inline'`: opções lado a lado (poucas opções curtas — "Sim / Não", "Dia / Semana / Mês"); em tela estreita quebram para a linha de baixo. Vazio = `'stacked'`.… |
|
|
1891
|
+
| `hint` | input | `string` | `''` | Texto de apoio embaixo do grupo. |
|
|
1892
|
+
| `help` | input | `string` | `''` | Depreciado desde 0.2.0 — use `hint`. |
|
|
1893
|
+
| `disabled` | input (herdado) | `boolean` | `false` | |
|
|
1894
|
+
| `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
|
|
1895
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
|
|
1896
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
|
|
1897
|
+
|
|
1898
|
+
## `hm-reorder-list`
|
|
1899
|
+
|
|
1900
|
+
`ReorderListComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/reorder-list` (também na raiz)
|
|
1901
|
+
|
|
1902
|
+
Lista reordenável (`hm-reorder-list`) por arrasto **e** por teclado. A interação é a do serviço genérico de arrastar e soltar do Hermes (`[hmSortable]` + `[hmDraggable]` + `[hmDragHandle]`, coordenados pelo `HermesDragDropService`).
|
|
1903
|
+
|
|
1904
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1905
|
+
|---|---|---|---|---|
|
|
1906
|
+
| `items` | model | `readonly ReorderListItem[]` | `[]` | Os itens, na ordem atual. Two-way: recebe a ordem nova ao soltar. |
|
|
1907
|
+
| `label` | input | `string` | `''` | Nome da lista (visível, salvo `labelHidden`). Vazio = catálogo ("Lista ordenável"), só para leitor de tela. |
|
|
1908
|
+
| `labelHidden` | input | `boolean` | `false` | |
|
|
1909
|
+
| `hint` | input | `string` | `''` | |
|
|
1910
|
+
| `size` | input | `ReorderListSize` | `'medium'` | |
|
|
1911
|
+
| `removable` | input | `boolean` | `false` | Mostra em cada linha o botão que remove o item da lista. |
|
|
1912
|
+
| `moved` | output | `ReorderListMove` | | Movimento confirmado: item, posição de origem e de destino (índices a partir de 0). |
|
|
1913
|
+
| `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` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
|
|
1916
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
|
|
1917
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
|
|
1918
|
+
|
|
1919
|
+
## `hm-search-field`
|
|
1920
|
+
|
|
1921
|
+
`SearchFieldComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/search-field` (também na raiz)
|
|
1922
|
+
|
|
1923
|
+
Campo de busca: rótulo, lupa, botão de limpar e o termo publicado com espera opcional. Filtrar é de quem tem o dado, não deste componente.
|
|
1924
|
+
|
|
1925
|
+
Métodos públicos: `focus(): void`, `clear(): void`
|
|
1926
|
+
|
|
1927
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1928
|
+
|---|---|---|---|---|
|
|
1929
|
+
| `value` | model | `string` | `''` | |
|
|
1930
|
+
| `label` | input (obrigatório) | `string` | | |
|
|
1931
|
+
| `labelHidden` | input | `boolean` | `false` | Esconde o rótulo da vista, mantendo-o para o leitor de tela. |
|
|
1932
|
+
| `placeholder` | input | `string` | `''` | |
|
|
1933
|
+
| `hint` | input | `string` | `''` | Texto de apoio embaixo do campo. |
|
|
1934
|
+
| `size` | input | `SearchFieldSize` | `'medium'` | |
|
|
1935
|
+
| `debounce` | input | `number` | `0` | Espera (ms) entre a última tecla e o evento `search`. `0` = a cada tecla. |
|
|
1936
|
+
| `landmark` | input | `boolean` | `true` | `role="search"` no contêiner (ver nota da classe). |
|
|
1937
|
+
| `loading` | input | `boolean` | `false` | Silhueta no lugar do campo enquanto a tela resolve. |
|
|
1938
|
+
| `search` | output | `string` | | Termo publicado (com `debounce`); `Enter` e limpar publicam na hora. |
|
|
1939
|
+
| `cleared` | output | `void` | | O termo foi limpo (botão ou `Esc`). |
|
|
1940
|
+
| `disabled` | input (herdado) | `boolean` | `false` | |
|
|
1941
|
+
| `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
|
|
1942
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
|
|
1943
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
|
|
1944
|
+
|
|
1945
|
+
## `hm-segmented-control`
|
|
1946
|
+
|
|
1947
|
+
`SegmentedControlComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/segmented-control` (também na raiz)
|
|
1948
|
+
|
|
1949
|
+
Escolha exclusiva entre poucas opções curtas (2 a 5), todas visíveis de uma vez — "Claro \| Escuro \| Sistema", "Confortável \| Compacta". Para mais opções, ou rótulos longos, use `hm-select`; para ligar/desligar, `hm-switch`.
|
|
1950
|
+
|
|
1951
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1952
|
+
|---|---|---|---|---|
|
|
1953
|
+
| `options` | input (obrigatório) | `readonly SegmentedOption[]` | | |
|
|
1954
|
+
| `value` | model | `string` | `''` | Valor marcado. Two-way. |
|
|
1955
|
+
| `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
|
+
| `size` | input | `SegmentedControlSize` | `'medium'` | |
|
|
1957
|
+
| `emphasis` | input | `SegmentedControlEmphasis` | `'subtle'` | |
|
|
1958
|
+
| `disabled` | input (herdado) | `boolean` | `false` | |
|
|
1959
|
+
| `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
|
|
1960
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
|
|
1961
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
|
|
1962
|
+
|
|
1963
|
+
## `hm-select`
|
|
1964
|
+
|
|
1965
|
+
`SelectComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/select` (também na raiz)
|
|
1966
|
+
|
|
1967
|
+
`<select>` nativo com o mesmo invólucro do `hm-input` (rótulo, moldura, ícone, erro já ligados por aria-describedby/aria-invalid). `<option>` entra por projeção de conteúdo, igual a um `<select>` comum — só o invólucro muda.
|
|
1968
|
+
|
|
1969
|
+
Slots: `(padrão)`
|
|
1970
|
+
|
|
1971
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1972
|
+
|---|---|---|---|---|
|
|
1973
|
+
| `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
|
+
| `label` | input (obrigatório) | `string` | | |
|
|
1975
|
+
| `labelHidden` | input | `boolean` | `false` | Esconde o rótulo da vista, mantendo-o para o leitor de tela. |
|
|
1976
|
+
| `hint` | input | `string` | `''` | Texto de apoio embaixo do campo. |
|
|
1977
|
+
| `disabled` | input (herdado) | `boolean` | `false` | |
|
|
1978
|
+
| `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
|
|
1979
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
|
|
1980
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
|
|
1981
|
+
|
|
1982
|
+
## `hm-session-recovery`
|
|
1983
|
+
|
|
1984
|
+
`SessionRecoveryComponent` — import de `@trismegisto/angular/session-recovery` (também na raiz)
|
|
1985
|
+
|
|
1986
|
+
Botão "voltar para o aplicativo" para quando a sessão/solicitação morreu de vez e não há mais nada a reconstruir na tela — a única saída é voltar a quem mandou a pessoa até aqui.
|
|
1987
|
+
|
|
1988
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
1989
|
+
|---|---|---|---|---|
|
|
1990
|
+
| `origin` | input | `string \| null \| undefined` | `null` | URL de retorno (ex.: referrer do fluxo). Vazio esconde o botão. |
|
|
1991
|
+
| `label` | input | `string` | `''` | Vazio = texto do catálogo no idioma ativo (`HERMES_MESSAGES.sessionRecovery.back`). |
|
|
1992
|
+
| `navigate` | input | `boolean` | `true` | |
|
|
1993
|
+
| `returned` | output | `string` | | |
|
|
1994
|
+
|
|
1995
|
+
## `hm-settings-dialog`
|
|
1996
|
+
|
|
1997
|
+
`SettingsDialogComponent` — import de `@trismegisto/angular/settings` (também na raiz)
|
|
1998
|
+
|
|
1999
|
+
Painel de configurações em janela grande, no formato de preferências de app de desktop: busca e seções à esquerda, a seção escolhida à direita, tudo aplicado na hora (sem botão de salvar).
|
|
2000
|
+
|
|
2001
|
+
Slots: `[settingsNavFooter]`, `(padrão)`
|
|
2002
|
+
|
|
2003
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2004
|
+
|---|---|---|---|---|
|
|
2005
|
+
| `open` | model (obrigatório) | `boolean` | | Visibilidade. Two-way: fecha no Esc, no X e no clique fora. |
|
|
2006
|
+
| `heading` | input (obrigatório) | `string` | | Título (topo da navegação) e rótulo acessível da janela. |
|
|
2007
|
+
| `activeSection` | model | `string` | `''` | Seção aberta (`key` de uma `hm-settings-section`). Vazio = a primeira. Two-way. |
|
|
2008
|
+
| `closeHandler` | input | `HermesSettingsCloseHandler \| null` | `null` | Modo formulário: OK/Cancelar que decidem se a janela fecha (síncrono ou `Promise<boolean>`). Ver `HermesSettingsCloseHandler`. Sem ele (e sem `actions`), tudo… |
|
|
2009
|
+
| `actions` | input | `boolean` | `false` | Mostra o rodapé Cancelar/Salvar mesmo sem `closeHandler` (validação por seção e fecha no OK). |
|
|
2010
|
+
| `submitLabel` | input | `string` | `''` | Rótulos do rodapé. Vazio = catálogo. |
|
|
2011
|
+
| `cancelLabel` | input | `string` | `''` | |
|
|
2012
|
+
| `closed` | output | `void` | | |
|
|
2013
|
+
| `submitted` | output | `void` | | OK com todas as seções válidas e `onSubmit` aceito: a janela fechou salvando. |
|
|
2014
|
+
|
|
2015
|
+
## `hm-settings-row`
|
|
2016
|
+
|
|
2017
|
+
`SettingsRowComponent` — import de `@trismegisto/angular/settings` (também na raiz)
|
|
2018
|
+
|
|
2019
|
+
Uma preferência dentro de `hm-settings-section`: nome e explicação à esquerda, controle (`hm-segmented-control`, `hm-switch`, `hm-select`, botão...) à direita — a linha típica de um painel de configurações. `stacked` põe o controle embaixo do texto, para controles largos (grade de cores, tabela).
|
|
2020
|
+
|
|
2021
|
+
Slots: `[rowDescription]`, `(padrão)`
|
|
2022
|
+
|
|
2023
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2024
|
+
|---|---|---|---|---|
|
|
2025
|
+
| `label` | input (obrigatório) | `string` | | |
|
|
2026
|
+
| `description` | input | `string` | `''` | |
|
|
2027
|
+
| `keywords` | input | `string` | `''` | Termos extras que também acham esta linha na busca (sinônimos, nome antigo da opção). |
|
|
2028
|
+
| `stacked` | input | `boolean` | `false` | |
|
|
2029
|
+
|
|
2030
|
+
## `hm-settings-section`
|
|
2031
|
+
|
|
2032
|
+
`SettingsSectionComponent` — import de `@trismegisto/angular/settings` (também na raiz)
|
|
2033
|
+
|
|
2034
|
+
Uma seção do `hm-settings-dialog` ("Aparência", "Atalhos"...). O diálogo monta a navegação lateral a partir delas — `key`, `label` e `icon` viram o item do menu; não existe lista de seções separada para manter em sincronia.
|
|
2035
|
+
|
|
2036
|
+
Slots: `(padrão)`
|
|
2037
|
+
|
|
2038
|
+
Métodos públicos: `focusFirstInvalid(): void`
|
|
2039
|
+
|
|
2040
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2041
|
+
|---|---|---|---|---|
|
|
2042
|
+
| `key` | input (obrigatório) | `string` | | Identificador estável (também o que `activeSection` do diálogo recebe). |
|
|
2043
|
+
| `label` | input (obrigatório) | `string` | | |
|
|
2044
|
+
| `icon` | input | `string` | `'cog'` | |
|
|
2045
|
+
| `description` | input | `string` | `''` | |
|
|
2046
|
+
| `keywords` | input | `string` | `''` | Termos extras que acham a seção inteira na busca. |
|
|
2047
|
+
| `control` | input | `AbstractControl \| null` | `null` | Formulário da seção: inválido impede o OK do diálogo e marca a seção na navegação. |
|
|
2048
|
+
| `invalid` | input | `boolean` | `false` | Força a seção como inválida (regra de fora do formulário, recusa do servidor). |
|
|
2049
|
+
|
|
2050
|
+
## `hm-shortcut-list`
|
|
2051
|
+
|
|
2052
|
+
`ShortcutListComponent` — import de `@trismegisto/angular/shortcut-list` (também na raiz)
|
|
2053
|
+
|
|
2054
|
+
Painel de atalhos de teclado: um bloco por grupo, cada atalho com a descrição e as teclas desenhadas como tecla (`<kbd>`). Cabe dentro de um `hm-modal` — o diálogo que o `?` costuma abrir.
|
|
2055
|
+
|
|
2056
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2057
|
+
|---|---|---|---|---|
|
|
2058
|
+
| `items` | input | `readonly HermesShortcutItem[]` | `[]` | Atalhos declarados além dos registrados (os que outra peça ou o navegador disparam). |
|
|
2059
|
+
| `registered` | input | `boolean` | `true` | Inclui os atalhos registrados no `HermesShortcutService`. |
|
|
2060
|
+
| `searchable` | input | `boolean` | `false` | Mostra a busca. |
|
|
2061
|
+
| `characterKeysToggle` | input | `boolean` | `false` | Mostra o interruptor dos atalhos de tecla única (WCAG 2.1.4). |
|
|
2062
|
+
| `headingLevel` | input | `number` | `3` | Nível do título de cada grupo (3 = abaixo do título de um `hm-modal`). |
|
|
2063
|
+
|
|
2064
|
+
## `[hmShortcut]`
|
|
2065
|
+
|
|
2066
|
+
`ShortcutDirective` — import de `@trismegisto/angular/shortcut-list` (também na raiz)
|
|
2067
|
+
|
|
2068
|
+
Liga um atalho de teclado a um elemento **enquanto ele existe**: registra no `HermesShortcutService` ao aparecer e remove ao sair da tela (um botão de um diálogo só responde com o diálogo aberto).
|
|
2069
|
+
|
|
2070
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2071
|
+
|---|---|---|---|---|
|
|
2072
|
+
| `hmShortcut` | input (obrigatório) | `string \| readonly string[]` | | Atalho escrito (`'Mod+S'`, `'G H'`) ou alternativas. |
|
|
2073
|
+
| `hmShortcutDescription` | input | `string` | `''` | Como o atalho aparece no `hm-shortcut-list`. |
|
|
2074
|
+
| `hmShortcutGroup` | input | `string` | `''` | Grupo no painel (id padrão ou nome livre). |
|
|
2075
|
+
| `hmShortcutAllowInInputs` | input | `boolean` | `false` | Dispara também com o foco num campo editável. |
|
|
2076
|
+
| `hmShortcutDisabled` | input | `boolean` | `false` | Tira o atalho do registro (e do painel) sem tirar o elemento. |
|
|
2077
|
+
| `hmShortcutAction` | input | `ShortcutAction` | `'auto'` | |
|
|
2078
|
+
| `hmShortcutTriggered` | output | `KeyboardEvent` | | O atalho disparou (depois da ação). |
|
|
2079
|
+
|
|
2080
|
+
## `hm-sidebar-group`
|
|
2081
|
+
|
|
2082
|
+
`SidebarGroupComponent` — import de `@trismegisto/angular/sidebar` (também na raiz)
|
|
2083
|
+
|
|
2084
|
+
Grupo expansível do `hm-sidebar`: cabeçalho clicável (ícone, rótulo, seta) e os links (ou outro grupo, no 3º nível) que abrem embaixo. O primeiro nível nasce aberto; um grupo dentro de outro nasce fechado. O aberto/fechado mora no `HermesSidebarService`, só na sessão.
|
|
2085
|
+
|
|
2086
|
+
Slots: `(padrão)`
|
|
2087
|
+
|
|
2088
|
+
Métodos públicos: `expand(): void`, `markActive(source: object, active: boolean): void`
|
|
2089
|
+
|
|
2090
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2091
|
+
|---|---|---|---|---|
|
|
2092
|
+
| `id` | input (obrigatório) | `string` | | Identifica o grupo no serviço. Use um valor **único** (ex.: o caminho da rota): ids repetidos fazem grupos distintos compartilharem estado. |
|
|
2093
|
+
| `label` | input (obrigatório) | `string` | | |
|
|
2094
|
+
| `icon` | input (obrigatório) | `string` | | |
|
|
2095
|
+
|
|
2096
|
+
## `hm-sidebar-link`
|
|
2097
|
+
|
|
2098
|
+
`SidebarLinkComponent` — import de `@trismegisto/angular/sidebar` (também na raiz)
|
|
2099
|
+
|
|
2100
|
+
Item de navegação: ícone, texto e o destino da rota. Solto dentro do `hm-sidebar` ou aninhado num `hm-sidebar-group` (clicar nele abre o grupo). Só apresentação: aponta para a rota, não decide.
|
|
2101
|
+
|
|
2102
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2103
|
+
|---|---|---|---|---|
|
|
2104
|
+
| `route` | input (obrigatório) | `string \| readonly unknown[]` | | |
|
|
2105
|
+
| `label` | input (obrigatório) | `string` | | Texto do item; único rótulo que resta com a navegação colapsada (via `title`). |
|
|
2106
|
+
| `icon` | input (obrigatório) | `string` | | |
|
|
2107
|
+
|
|
2108
|
+
## `hm-sidebar-node`
|
|
2109
|
+
|
|
2110
|
+
`SidebarNodeComponent` — import de `@trismegisto/angular/sidebar` (também na raiz)
|
|
2111
|
+
|
|
2112
|
+
Desenha um nó da árvore dentro do `hm-sidebar`: sem filhos (ou com `depth <= 0`) vira link direto; com filhos e `depth > 0` vira grupo expansível com os filhos, um nível mais fundo (`depth - 1`) cada. É recursivo, mas **capado em profundidade**: ao chegar em `0` o nó vira link mesmo tendo filhos, porque navegar até ele é entrar na rota, que decide o que fazer com o resto.
|
|
2113
|
+
|
|
2114
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2115
|
+
|---|---|---|---|---|
|
|
2116
|
+
| `node` | input (obrigatório) | `SidebarNode` | | |
|
|
2117
|
+
| `depth` | input | `number` | `1` | Quantos níveis de grupo ainda restam, incluindo este. `0` trava como link mesmo com filhos. |
|
|
2118
|
+
|
|
2119
|
+
## `hm-sidebar`
|
|
2120
|
+
|
|
2121
|
+
`SidebarComponent` — import de `@trismegisto/angular/sidebar` (também na raiz)
|
|
2122
|
+
|
|
2123
|
+
Navegação lateral do shell. Em tela larga tem três modos (`HermesSidebarService`); o padrão, **auto**, é compacta em repouso e abre por cima do conteúdo ao aproximar o ponteiro ou o foco de teclado. Abaixo de 768px vira sobreposição, aberta pelo gatilho do `hm-header`.
|
|
2124
|
+
|
|
2125
|
+
Slots: `(padrão)`
|
|
2126
|
+
|
|
2127
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2128
|
+
|---|---|---|---|---|
|
|
2129
|
+
| `label` | input (obrigatório) | `string` | | Nome da navegação para leitor de tela. |
|
|
2130
|
+
| `heading` | input | `string` | `''` | O que a coluna mostra — o módulo em que se está. Vazio não desenha cabeçalho (nível raiz). Também é a chave da troca de conteúdo: quando muda, o nível é recria… |
|
|
2131
|
+
| `headingIcon` | input | `string` | `'grid'` | |
|
|
2132
|
+
| `backLabel` | input | `string` | `''` | Rótulo da volta para o nível de cima. Vazio não desenha o botão. |
|
|
2133
|
+
| `direction` | input | `'forward' \| 'back'` | `'forward'` | Para que lado a troca de nível se move. |
|
|
2134
|
+
| `collapsible` | input | `boolean` | `true` | Oferece a escolha de modo no rodapé. |
|
|
2135
|
+
| `back` | output | `void` | | |
|
|
2136
|
+
|
|
2137
|
+
## `hm-skeleton`
|
|
2138
|
+
|
|
2139
|
+
`SkeletonComponent` — import de `@trismegisto/angular/skeleton` (também na raiz)
|
|
2140
|
+
|
|
2141
|
+
O único estado de espera do Hermes — não há spinner genérico. Um esqueleto reserva o espaço que o conteúdo vai ocupar e responde "vai chegar o quê", que é a pergunta de quem espera; um spinner centrado numa região vazia é trocado por uma lista de linhas e a página salta no instante em que o dado chega — bem na tela em que a pessoa estava olhando.
|
|
2142
|
+
|
|
2143
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2144
|
+
|---|---|---|---|---|
|
|
2145
|
+
| `shape` | input | `SkeletonShape` | `'text'` | |
|
|
2146
|
+
| `count` | input | `number` | `3` | Quantas linhas, itens ou cartões desenhar. |
|
|
2147
|
+
| `label` | input (obrigatório) | `string` | | O que está sendo carregado, para quem usa leitor de tela — puramente visual sem isto. |
|
|
2148
|
+
|
|
2149
|
+
## `hm-slider`
|
|
2150
|
+
|
|
2151
|
+
`SliderComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/slider` (também na raiz)
|
|
2152
|
+
|
|
2153
|
+
Controle deslizante — valor único ou intervalo (dois polegares), com o padrão WAI-ARIA APG **Slider** / **Multi-Thumb Slider**: - cada polegar é um `role="slider"` focável com `aria-valuenow/min/max` e `aria-valuetext` — o texto sai de `Intl.NumberFormat` no idioma do catálogo (opções em `format`, ex. `{ style: 'currency', currency: 'BRL' }`) ou da função `valueText`; - teclado: setas (±`step`),…
|
|
2154
|
+
|
|
2155
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2156
|
+
|---|---|---|---|---|
|
|
2157
|
+
| `value` | model | `SliderModelValue` | `null` | |
|
|
2158
|
+
| `label` | input (obrigatório) | `string` | | |
|
|
2159
|
+
| `labelHidden` | input | `boolean` | `false` | |
|
|
2160
|
+
| `hint` | input | `string` | `''` | |
|
|
2161
|
+
| `min` | input | `number` | `0` | |
|
|
2162
|
+
| `max` | input | `number` | `100` | |
|
|
2163
|
+
| `step` | input | `number` | `1` | |
|
|
2164
|
+
| `largeStep` | input | `number \| null` | `null` | Passo de PageUp/PageDown. Padrão: ~10% da faixa, arredondado ao `step`. |
|
|
2165
|
+
| `range` | input | `boolean` | `false` | Dois polegares; o valor vira `{ start, end }`. |
|
|
2166
|
+
| `minDistance` | input | `number` | `0` | Distância mínima entre os polegares do intervalo. |
|
|
2167
|
+
| `marks` | input | `boolean \| readonly (number \| SliderMarkInput)[]` | `false` | Marcas na trilha: `true` = uma por passo; ou a lista (`[0, 50, { value: 100, label: 'Máx.' }]`). |
|
|
2168
|
+
| `showValue` | input | `boolean` | `false` | Mostra o valor (formatado) ao lado do rótulo. |
|
|
2169
|
+
| `tooltip` | input | `SliderTooltip` | `'auto'` | |
|
|
2170
|
+
| `orientation` | input | `SliderOrientation` | `'horizontal'` | |
|
|
2171
|
+
| `size` | input | `SliderSize` | `'medium'` | |
|
|
2172
|
+
| `format` | input | `Intl.NumberFormatOptions \| null` | `null` | Opções do `Intl.NumberFormat` para o valor exibido e anunciado. |
|
|
2173
|
+
| `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` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
|
|
2176
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
|
|
2177
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
|
|
2178
|
+
|
|
2179
|
+
## `hm-spinner`
|
|
2180
|
+
|
|
2181
|
+
`SpinnerComponent` — import de `@trismegisto/angular/spinner` (também na raiz)
|
|
2182
|
+
|
|
2183
|
+
Indicador de carregamento indeterminado: o anel giratório do `.hm-spinner` (core) com tamanho, versão inversa e texto anunciado.
|
|
2184
|
+
|
|
2185
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2186
|
+
|---|---|---|---|---|
|
|
2187
|
+
| `size` | input | `SpinnerSize` | `'medium'` | `small` (18px, cabe numa linha de texto), `medium` (36px) ou `large` (72px). |
|
|
2188
|
+
| `inverse` | input | `boolean` | `false` | Cores para fundo preenchido com a cor de ação ou de status (botão sólido, banner, faixa escura). |
|
|
2189
|
+
| `label` | input | `string` | `''` | O que está carregando. Vazio cai no "Carregando" do catálogo. |
|
|
2190
|
+
| `labelVisible` | input | `boolean` | `false` | Mostra o texto ao lado do anel (por padrão ele só é lido pelo leitor de tela). |
|
|
2191
|
+
| `decorative` | input | `boolean` | `false` | Sem `role="status"` nem texto: outra parte da tela já anuncia o carregamento. |
|
|
2192
|
+
| `done` | input | `boolean` | `false` | Terminou: o anel vira um ✓ e o texto anunciado passa a `doneLabel` (padrão "Concluído"). |
|
|
2193
|
+
| `doneLabel` | input | `string` | `''` | O que terminou ("Servidores carregados"). Vazio cai no "Concluído" do catálogo. |
|
|
2194
|
+
|
|
2195
|
+
## `hm-splitter-panel`
|
|
2196
|
+
|
|
2197
|
+
`SplitterPanelComponent` — import de `@trismegisto/angular/splitter` (também na raiz)
|
|
2198
|
+
|
|
2199
|
+
Painel de um `hm-splitter`. Marque com o atributo `primary` (o painel cujo tamanho o divisor controla — é ele que o `aria-controls` do separador aponta) ou `secondary` (o resto do espaço). Recebe um `id` automático se você não der um; use `hm-splitter-panel` quando quiser que o splitter descubra o `aria-controls` sozinho. Qualquer elemento com `primary`/`secondary` também é projetado, mas aí o id…
|
|
2200
|
+
|
|
2201
|
+
Slots: `(padrão)`
|
|
2202
|
+
|
|
2203
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2204
|
+
|---|---|---|---|---|
|
|
2205
|
+
| `id` | input | `string` | `''` | Id do painel; vazio = gerado. |
|
|
2206
|
+
|
|
2207
|
+
## `hm-splitter`
|
|
2208
|
+
|
|
2209
|
+
`SplitterComponent` — import de `@trismegisto/angular/splitter` (também na raiz)
|
|
2210
|
+
|
|
2211
|
+
Dois painéis com um divisor arrastável entre eles — padrão WAI-ARIA APG "Window Splitter".
|
|
2212
|
+
|
|
2213
|
+
Slots: `[primary]`, `[secondary]`
|
|
2214
|
+
|
|
2215
|
+
Métodos públicos: `restoreDefault(): void`
|
|
2216
|
+
|
|
2217
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2218
|
+
|---|---|---|---|---|
|
|
2219
|
+
| `orientation` | input | `SplitterOrientation` | `'horizontal'` | |
|
|
2220
|
+
| `position` | model | `number` | `50` | Tamanho do painel primário, em %. |
|
|
2221
|
+
| `min` | input | `number` | `10` | |
|
|
2222
|
+
| `max` | input | `number` | `90` | |
|
|
2223
|
+
| `step` | input | | `DEFAULT_SPLITTER_STEP` | Passo das setas, em pontos percentuais. |
|
|
2224
|
+
| `largeStep` | input | | `DEFAULT_SPLITTER_LARGE_STEP` | Passo com `Shift`+seta. |
|
|
2225
|
+
| `label` | input (obrigatório) | `string` | | Nome acessível do separador (obrigatório): diga o que ele redimensiona. |
|
|
2226
|
+
| `controls` | input | `string` | `''` | Id do painel primário pro `aria-controls` — dispensável com `hm-splitter-panel primary`. |
|
|
2227
|
+
| `defaultPosition` | input | `number \| null` | `null` | Posição do duplo clique; `null` = a posição com que o splitter nasceu. |
|
|
2228
|
+
| `collapsible` | input | `boolean` | `false` | `Enter` recolhe o primário até `min` e o restaura no próximo `Enter`. |
|
|
2229
|
+
| `dragEnd` | output | `number` | | Fim de um arrasto (soltar ou cancelar) — útil pra persistir só no fim do gesto. |
|
|
2230
|
+
|
|
2231
|
+
## `hm-stat-card`
|
|
2232
|
+
|
|
2233
|
+
`StatCardComponent` — import de `@trismegisto/angular/stat-card` (também na raiz)
|
|
2234
|
+
|
|
2235
|
+
Casca de card pra métrica (ícone + rótulo + valor num destaque), sobre o `hm-card`: a borda, o padding, o raio e a altura 100% (estica junto com os vizinhos do grid) já vêm prontos — não reimplemente essa casca no app.
|
|
2236
|
+
|
|
2237
|
+
Slots: `[trailing]`, `[footer]`
|
|
2238
|
+
|
|
2239
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2240
|
+
|---|---|---|---|---|
|
|
2241
|
+
| `icon` | input | `string` | `''` | Ícone do círculo ao lado do rótulo. Vazio = sem círculo. |
|
|
2242
|
+
| `label` | input (obrigatório) | `string` | | |
|
|
2243
|
+
| `value` | input (obrigatório) | `number \| string` | | |
|
|
2244
|
+
| `intent` | input | `IconStatus` | `'neutral'` | Cor do círculo do ícone e do valor. Mesmo eixo `status` do `hm-icon`. |
|
|
2245
|
+
| `fill` | input | `boolean` | `true` | Mesmo `fill` do `hm-card`: liga quando a altura vem de fora (grid com `align-items: stretch`), pra o card preencher a célula inteira em vez de só a altura do p… |
|
|
2246
|
+
| `description` | input | `string` | `''` | Frase curta, sempre visível, sob o valor: o que o indicador conta. |
|
|
2247
|
+
| `details` | input | `readonly StatCardDetail[]` | `[]` | Fragmentos do detalhamento, separados por `·`. |
|
|
2248
|
+
| `trend` | input | `StatCardTrend \| null` | `null` | Variação do número, com seta. |
|
|
2249
|
+
| `hint` | input | `string` | `''` | Explicação do indicador, num `hm-toggletip` ao lado do rótulo. |
|
|
2250
|
+
| `size` | input | `StatCardSize` | `'medium'` | |
|
|
2251
|
+
| `selectable` | input | `boolean` | `false` | O cartão vira botão de alternância (`aria-pressed`), para agir como filtro. |
|
|
2252
|
+
| `selected` | input | `boolean` | `false` | Este é o cartão escolhido. Só tem efeito com `selectable`. |
|
|
2253
|
+
| `selectedChange` | output | `boolean` | | Pedido de troca, com o valor desejado (`!selected`). Só emite com `selectable`. |
|
|
2254
|
+
| `loading` | input | `boolean` | `false` | O dado ainda não chegou: valor, detalhamento e variação viram esqueleto. |
|
|
2255
|
+
|
|
2256
|
+
## `hm-stat-group`
|
|
2257
|
+
|
|
2258
|
+
`StatGroupComponent` — import de `@trismegisto/angular/stat-group` (também na raiz)
|
|
2259
|
+
|
|
2260
|
+
Várias métricas de uma mesma categoria sob um título, com uma ação "ver mais" opcional. Sobre o `hm-card`: o título vira o `heading` do card, então o grupo é uma região nomeada (`role="region"`) — dê títulos distintos a grupos na mesma tela.
|
|
2261
|
+
|
|
2262
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2263
|
+
|---|---|---|---|---|
|
|
2264
|
+
| `heading` | input (obrigatório) | `string` | | Categoria que as métricas compartilham (`MPLS`, `Internet`). Nomeia a região. |
|
|
2265
|
+
| `icon` | input | `string` | `''` | Ícone ao lado do título. Decorativo. |
|
|
2266
|
+
| `metrics` | input (obrigatório) | `readonly StatGroupMetric[]` | | |
|
|
2267
|
+
| `intent` | input | `IconStatus` | `'neutral'` | Cor dos valores (o grupo inteiro fala de uma categoria só). Padrão `neutral`. |
|
|
2268
|
+
| `hint` | input | `string` | `''` | Explicação da regra por trás das métricas, num `hm-toggletip` no canto do cabeçalho. |
|
|
2269
|
+
| `moreLabel` | input | `string` | `''` | Texto da ação "ver mais". Vazio, com `moreLink`/`showMore`, usa o do catálogo. |
|
|
2270
|
+
| `moreLink` | input | `string` | `''` | Destino da ação: vira link. Sem ele (e com `moreLabel`), botão que emite `more`. |
|
|
2271
|
+
| `moreAction` | input | `boolean` | `false` | Liga a ação mesmo sem `moreLabel`/`moreLink` (texto do catálogo, emite `more`). |
|
|
2272
|
+
| `fill` | input | `boolean` | `true` | Mesmo `fill` do `hm-card` (altura vinda da grade). |
|
|
2273
|
+
| `loading` | input | `boolean` | `false` | Valores ainda não chegaram: viram esqueleto; rótulos ficam; a ação some. |
|
|
2274
|
+
| `more` | output | `void` | | A pessoa acionou "ver mais" (também emite quando é link, antes de navegar). |
|
|
2275
|
+
|
|
2276
|
+
## `hm-state-page`
|
|
2277
|
+
|
|
2278
|
+
`StatePageComponent` — import de `@trismegisto/angular/state-page` (também na raiz)
|
|
2279
|
+
|
|
2280
|
+
Página de estado pronta — não encontrada, sem permissão, sem resultados, sessão expirada, sessão finalizada, erro, tela não publicada, bloqueado, nova versão disponível (`outdated`: o app foi atualizado e os arquivos da tela aberta sumiram do servidor — a ação recarrega a página): <hm-state-page kind="no-rights" (actionTriggered)="goHome()" />
|
|
2281
|
+
|
|
2282
|
+
Slots: `(padrão)`
|
|
2283
|
+
|
|
2284
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2285
|
+
|---|---|---|---|---|
|
|
2286
|
+
| `kind` | input (obrigatório) | `StatePageKind` | | |
|
|
2287
|
+
| `heading` | input | `string \| undefined` | `undefined` | Omitido = catálogo; `""` = sem título. |
|
|
2288
|
+
| `description` | input | `string \| undefined` | `undefined` | Omitido = catálogo; `""` = sem descrição. |
|
|
2289
|
+
| `action` | input | `string \| undefined` | `undefined` | Omitido = catálogo; `""` = sem botão. |
|
|
2290
|
+
| `actionIcon` | input | `string \| undefined` | `undefined` | |
|
|
2291
|
+
| `actionTriggered` | output | `void` | | |
|
|
2292
|
+
|
|
2293
|
+
## `hm-state-screen`
|
|
2294
|
+
|
|
2295
|
+
`StateScreenComponent` — import de `@trismegisto/angular/state-screen` (também na raiz)
|
|
2296
|
+
|
|
2297
|
+
Tela inteira de feedback: título, descrição, ilustração e a ação de retorno — estado vazio e feedback com a mesma anatomia, mudando só a situação.
|
|
2298
|
+
|
|
2299
|
+
Slots: `[illustration]`, `(padrão)`
|
|
2300
|
+
|
|
2301
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2302
|
+
|---|---|---|---|---|
|
|
2303
|
+
| `heading` | input (obrigatório) | `string` | | |
|
|
2304
|
+
| `description` | input | `string` | `''` | Uma frase dizendo o que aconteceu ou o que fazer em seguida. |
|
|
2305
|
+
| `situation` | input | `StateScreenSituation` | `'empty'` | |
|
|
2306
|
+
| `action` | input | `string` | `''` | Rótulo da ação; vazio não desenha o botão. |
|
|
2307
|
+
| `actionIcon` | input | `string` | `'arrow-left'` | |
|
|
2308
|
+
| `actionTriggered` | output | `void` | | Clique na ação. Navegar é de quem usa a peça, não dela. |
|
|
2309
|
+
|
|
2310
|
+
## `hm-step`
|
|
2311
|
+
|
|
2312
|
+
`StepComponent` — import de `@trismegisto/angular/stepper` (também na raiz)
|
|
2313
|
+
|
|
2314
|
+
Uma etapa de `hm-stepper`/`hm-wizard`: o rótulo e a situação dela entram no indicador (desenhado pelo grupo), e o conteúdo (`<ng-content>`) só aparece enquanto ela é a etapa aberta.
|
|
2315
|
+
|
|
2316
|
+
Slots: `(padrão)`
|
|
2317
|
+
|
|
2318
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2319
|
+
|---|---|---|---|---|
|
|
2320
|
+
| `label` | input | `string` | `''` | Rótulo da etapa no indicador e título do painel. |
|
|
2321
|
+
| `description` | input | `string` | `''` | Texto curto sob o rótulo no indicador. |
|
|
2322
|
+
| `optional` | input | `boolean` | `false` | Pode ser pulada sem ser concluída (não bloqueia o avanço no modo linear). |
|
|
2323
|
+
| `disabled` | input | `boolean` | `false` | Fora do alcance: não navegável, pulada por Avançar/Voltar. |
|
|
2324
|
+
| `error` | input | `boolean` | `false` | Força a etapa como com erro (por exemplo, o servidor recusou um dado dela). |
|
|
2325
|
+
| `completed` | input | `boolean \| null` | `null` | Força concluída (`true`) ou pendente (`false`); `null` deixa o stepper decidir ao avançar. |
|
|
2326
|
+
| `stepControl` | input | `AbstractControl \| null` | `null` | Formulário da etapa: precisa estar válido para avançar no modo linear. |
|
|
2327
|
+
| `canAdvance` | input | `HermesStepGuard \| null` | `null` | Regra extra de avanço, síncrona ou assíncrona. |
|
|
2328
|
+
| `summary` | input | `HermesStepSummary \| null` | `null` | O que a etapa coletou, para a página de resumo do `hm-wizard`. `null` = fica fora do resumo. |
|
|
2329
|
+
|
|
2330
|
+
## `hm-stepper`
|
|
2331
|
+
|
|
2332
|
+
`StepperComponent` — import de `@trismegisto/angular/stepper` (também na raiz)
|
|
2333
|
+
|
|
2334
|
+
Indicador de etapas de um fluxo (`hm-stepper` + `hm-step`): onde a pessoa está, o que já ficou pronto, o que deu erro — e o conteúdo da etapa aberta logo abaixo (ou ao lado, na vertical).
|
|
2335
|
+
|
|
2336
|
+
Slots: `(padrão)`
|
|
2337
|
+
|
|
2338
|
+
Métodos públicos: `isActive(step: object): boolean`, `next(): Promise<boolean>`, `previous(): void`, `goTo(index: number): Promise<boolean>`, `complete(): Promise<boolean>`, `reset(): void`
|
|
2339
|
+
|
|
2340
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2341
|
+
|---|---|---|---|---|
|
|
2342
|
+
| `selectedIndex` | model | `number` | `0` | Two-way: índice da etapa aberta. |
|
|
2343
|
+
| `linear` | input | `boolean` | `false` | Não avança sem validar a etapa aberta e não pula etapas pelos rótulos. |
|
|
2344
|
+
| `orientation` | input | `StepperOrientation` | `'horizontal'` | Direção da trilha. A horizontal deita sozinha em contêiner estreito. |
|
|
2345
|
+
| `readOnly` | input | `boolean` | `false` | Ninguém navega pelos rótulos: as etapas só informam. |
|
|
2346
|
+
| `label` | input | `string` | `''` | Nome da lista de etapas. Vazio = catálogo ("Etapas"). |
|
|
2347
|
+
| `level` | input | `number` | `3` | Nível do título de cada painel (`aria-level`). |
|
|
2348
|
+
| `hideHeading` | input | `boolean` | `false` | Título do painel só para leitor de tela (quando o conteúdo já tem o próprio título). |
|
|
2349
|
+
| `steps` | input | `readonly StepComponent[] \| null` | `null` | Etapas vindas de fora em vez dos `hm-step` filhos. Uso do `hm-wizard`, que re-projeta as etapas dele (e um `contentChildren` não enxerga conteúdo re-projetado). |
|
|
2350
|
+
|
|
2351
|
+
## `hm-switch`
|
|
2352
|
+
|
|
2353
|
+
`SwitchComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/switch` (também na raiz)
|
|
2354
|
+
|
|
2355
|
+
Interruptor: liga e desliga uma preferência **com efeito imediato**. Mesmo contrato dos outros controles: Reactive Forms, `[(ngModel)]` ou `[(value)]` (ver `HermesFormFieldBase`).
|
|
2356
|
+
|
|
2357
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2358
|
+
|---|---|---|---|---|
|
|
2359
|
+
| `value` | model | `boolean` | `false` | |
|
|
2360
|
+
| `label` | input (obrigatório) | `string` | | |
|
|
2361
|
+
| `hint` | input | `string` | `''` | Texto auxiliar permanente abaixo do controle. |
|
|
2362
|
+
| `help` | input | `string` | `''` | Depreciado desde 0.2.0 — use `hint`. |
|
|
2363
|
+
| `labelPosition` | input | `SwitchLabelPosition` | `'after'` | `before` põe o rótulo à esquerda do controle — para uma linha de configuração, onde a coluna de interruptores alinha à direita e o olho desce por ela. |
|
|
2364
|
+
| `loading` | input | `boolean` | `false` | Silhueta de carregamento no lugar do controle. Estado da peça, como `disabled`. |
|
|
2365
|
+
| `disabled` | input (herdado) | `boolean` | `false` | |
|
|
2366
|
+
| `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
|
|
2367
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
|
|
2368
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
|
|
2369
|
+
|
|
2370
|
+
## `hm-tab-bar`
|
|
2371
|
+
|
|
2372
|
+
`TabBarComponent` — import de `@trismegisto/angular/tab-bar` (também na raiz)
|
|
2373
|
+
|
|
2374
|
+
A fileira de abas "de navegador": escolher, fechar, reordenar e arrastar. Apresentacional — não sabe o que é uma página, só desenha o que recebe; quem decide o resto é quem consome `(activated)`/`(closed)`/`(reordered)`.
|
|
2375
|
+
|
|
2376
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2377
|
+
|---|---|---|---|---|
|
|
2378
|
+
| `tabs` | input (obrigatório) | `readonly TabItem[]` | | |
|
|
2379
|
+
| `active` | input (obrigatório) | `string` | | |
|
|
2380
|
+
| `label` | input | `string` | `''` | Vazio = texto do catálogo no idioma ativo (`HERMES_MESSAGES.tabBar.label`). |
|
|
2381
|
+
| `allowNewTab` | input | `boolean` | `true` | Mostra o `+` no fim da fileira. |
|
|
2382
|
+
| `contentId` | input | `string` | `''` | Id do elemento que as abas controlam (`aria-controls`) — normalmente a região de conteúdo que troca ao ativar uma aba. Sem isto, nenhuma aba recebe `aria-contr… |
|
|
2383
|
+
| `tabGroup` | input | `unknown` | `null` | Grupo de arrasto: fileiras com o mesmo valor (comparado por identidade — uma string ou um objeto, como o store do `hm-workspace`) aceitam abas umas das outras… |
|
|
2384
|
+
| `activated` | output | `string` | | |
|
|
2385
|
+
| `closed` | output | `string` | | |
|
|
2386
|
+
| `reordered` | output | `{ id: string; index: number }` | | Reordenar (arrasto, teclado do arrasto ou `Ctrl+←/→`): `index` é a posição final da aba. |
|
|
2387
|
+
| `newTabRequested` | output | `void` | | |
|
|
2388
|
+
| `contextMenuRequested` | output | `{ id: string; anchor: PopoverAnchor }` | | Botão direito sobre uma aba: quem consome decide o que abrir ali (ex.: um `hm-menu`). |
|
|
2389
|
+
| `tabReceived` | output | `TabReceivedEvent` | | Aba de outra fileira do mesmo `tabGroup` solta aqui: quem consome a move de fato (a fileira não é dona do estado). |
|
|
2390
|
+
|
|
2391
|
+
## `ng-template[hmTabContent]`
|
|
2392
|
+
|
|
2393
|
+
`TabContentDirective` — import de `@trismegisto/angular/tabs` (também na raiz)
|
|
2394
|
+
|
|
2395
|
+
Conteúdo preguiçoso de um `hm-tab`: o template só é montado na **primeira vez** que a aba é selecionada, e depois fica montado (escondido com `hidden` enquanto outra aba está em cena), para não perder estado (rolagem, formulário digitado) ao voltar. Com `destroyOnHide` no `hm-tab`, o conteúdo é destruído ao sair e montado de novo ao voltar.
|
|
2396
|
+
|
|
2397
|
+
_Sem inputs/outputs._
|
|
2398
|
+
|
|
2399
|
+
## `hm-tab`
|
|
2400
|
+
|
|
2401
|
+
`TabComponent` — import de `@trismegisto/angular/tabs` (também na raiz)
|
|
2402
|
+
|
|
2403
|
+
O painel de uma aba: só o conteúdo (`<ng-content>`) mostrado quando esta aba está selecionada. O botão da aba em si (o `role="tab"`) é responsabilidade do `hm-tabs`, que lê `label` e `disabled` de cada item para montar a tablist — este componente cuida só do `tabpanel`.
|
|
2404
|
+
|
|
2405
|
+
Slots: `(padrão)`
|
|
2406
|
+
|
|
2407
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2408
|
+
|---|---|---|---|---|
|
|
2409
|
+
| `id` | input | `string` | `''` | Identifica a aba dentro do grupo e liga o botão da tablist a este painel. Não é `input.required`: `active()` (abaixo) lê `group.selected()`, que itera o `id` d… |
|
|
2410
|
+
| `label` | input | `string` | `''` | Texto do botão na tablist. Mesma razão do `id` acima para não ser `input.required`. |
|
|
2411
|
+
| `disabled` | input | `boolean` | `false` | |
|
|
2412
|
+
| `count` | input | `number \| null` | `null` | Quanta coisa há dentro da aba, desenhada ao lado do rótulo. |
|
|
2413
|
+
| `route` | input | `string \| readonly unknown[] \| null` | `null` | Destino da aba no modo `nav` do `hm-tabs` (o mesmo valor que se passaria a um `routerLink`: string ou array de segmentos, relativo à rota de quem declara o `hm… |
|
|
2414
|
+
| `exact` | input | `boolean` | `false` | No modo `nav`, a aba só conta como ativa com a URL **exatamente** igual ao destino (o `routerLinkActiveOptions: { exact: true }`). O padrão (`false`) marca a a… |
|
|
2415
|
+
| `destroyOnHide` | input | `boolean` | `false` | Com conteúdo preguiçoso (`hmTabContent`), destrói o conteúdo ao trocar de aba em vez de mantê-lo montado e escondido. Use quando o conteúdo precisa recomeçar a… |
|
|
2416
|
+
|
|
2417
|
+
## `hm-tabs`
|
|
2418
|
+
|
|
2419
|
+
`TabsComponent` — import de `@trismegisto/angular/tabs` (também na raiz)
|
|
2420
|
+
|
|
2421
|
+
Grupo de abas de conteúdo: uma tablist de botões e o painel da aba selecionada, no padrão ARIA completo (`tablist`/`tab`/`tabpanel`, `aria-selected`, `aria-controls`, `aria-orientation`) com navegação por teclado e roving tabindex — só a aba ativa é parada de `Tab`, e as setas movem entre as demais (←/→ no horizontal, ↑/↓ no `orientation="vertical"`; `Home`/`End` nas pontas).
|
|
2422
|
+
|
|
2423
|
+
Slots: `[actions]`, `(padrão)`
|
|
2424
|
+
|
|
2425
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2426
|
+
|---|---|---|---|---|
|
|
2427
|
+
| `label` | input (obrigatório) | `string` | | Nome do grupo de abas (ou da região de navegação, no modo `nav`), lido pelo leitor de tela. |
|
|
2428
|
+
| `active` | model | `string` | `''` | Two-way: id da aba ativa. Assume a primeira aba não desabilitada quando não informado. No modo `nav`, segue a rota. |
|
|
2429
|
+
| `orientation` | input | `HermesTabsOrientation` | `'horizontal'` | `horizontal` (padrão) ou `vertical` (faixa à esquerda do painel, setas ↑/↓). |
|
|
2430
|
+
| `mode` | input | `HermesTabsMode` | `'tabs'` | `tabs` (padrão): tablist com painéis. `nav`: links de rota (subnav), com `aria-current="page"`. |
|
|
2431
|
+
| `overflow` | input | `HermesTabsOverflow` | `'menu'` | Abas que não cabem: `menu` (padrão) vão para o botão "Mais"; `wrap` quebra/rola como antes. Só no horizontal. |
|
|
2432
|
+
| `fillHeight` | input | `boolean` | `false` | As abas ocupam a altura que sobrar e o painel rola por dentro dele mesmo. |
|
|
2433
|
+
| `noPanelGap` | input | `boolean` | `false` | O painel da aba abre mão do respiro próprio. |
|
|
2434
|
+
|
|
2435
|
+
## `hm-tag`
|
|
2436
|
+
|
|
2437
|
+
`TagComponent` — import de `@trismegisto/angular/tag` (também na raiz)
|
|
2438
|
+
|
|
2439
|
+
Marcação curta com nome e cor — a etiqueta de um cartão do quadro Kanban, ou o **status** de um objeto ("Ativa", "Bloqueada", "Em análise"). Diferente do `hm-badge` (contador que diz QUANTOS) e do `hm-chip` (item que a pessoa escolheu e pode remover), a etiqueta não se remove: é um atributo do objeto. A cor é fechada a uma paleta pequena de tokens semânticos, pra não abrir hex arbitrário.
|
|
2440
|
+
|
|
2441
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2442
|
+
|---|---|---|---|---|
|
|
2443
|
+
| `name` | input (obrigatório) | `string` | | |
|
|
2444
|
+
| `color` | input | `TagColor` | `'neutral'` | |
|
|
2445
|
+
| `compact` | input | `boolean` | `false` | Versão barra: só a cor, sem o nome escrito — o rosto de um cartão do Kanban, no padrão do Trello. O nome não desaparece: continua acessível por `title` (dica d… |
|
|
2446
|
+
|
|
2447
|
+
## `[hmTextareaPrefix], [hmTextareaSuffix], [hmTextareaActions], [hmTextareaActionsEnd]`
|
|
2448
|
+
|
|
2449
|
+
`TextareaAddonDirective` — import de `@trismegisto/angular/textarea` (também na raiz)
|
|
2450
|
+
|
|
2451
|
+
Marca um conteúdo projetado no `hm-textarea` como complemento do campo: - `hmTextareaPrefix` / `hmTextareaSuffix`: ao lado do texto, no início/fim da linha (ícone, avatar, botão curto); - `hmTextareaActions` / `hmTextareaActionsEnd`: na barra embaixo do texto, no início (anexar, formatar) e no fim (enviar).
|
|
2452
|
+
|
|
2453
|
+
_Sem inputs/outputs._
|
|
2454
|
+
|
|
2455
|
+
## `hm-textarea`
|
|
2456
|
+
|
|
2457
|
+
`TextareaComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/textarea` (também na raiz)
|
|
2458
|
+
|
|
2459
|
+
Textarea com rótulo, texto de apoio, contador de caracteres opcional e mensagem de erro, no mesmo contrato do `hm-input`: Reactive Forms, `[(ngModel)]` ou `[(value)]` (ver `HermesFormFieldBase`).
|
|
2460
|
+
|
|
2461
|
+
Slots: `[hmTextareaPrefix]`, `[hmTextareaSuffix]`, `[hmTextareaActions]`, `[hmTextareaActionsEnd]`
|
|
2462
|
+
|
|
2463
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2464
|
+
|---|---|---|---|---|
|
|
2465
|
+
| `value` | model | `string` | `''` | |
|
|
2466
|
+
| `label` | input (obrigatório) | `string` | | |
|
|
2467
|
+
| `hint` | input | `string` | `''` | Texto de apoio embaixo do campo. |
|
|
2468
|
+
| `help` | input | `string` | `''` | Depreciado desde 0.2.0 — use `hint`. |
|
|
2469
|
+
| `placeholder` | input | `string` | `''` | |
|
|
2470
|
+
| `maxLength` | input | `number \| null` | `null` | Limite exibido no contador; também vira `maxlength` do `<textarea>`. |
|
|
2471
|
+
| `rows` | input | `number` | `3` | Linhas visíveis antes de crescer (com `autoGrow`) ou rolar. |
|
|
2472
|
+
| `autoGrow` | input | `boolean` | `false` | Cresce junto com o conteúdo em vez de rolar por dentro; mede o DOM, só no navegador. |
|
|
2473
|
+
| `labelHidden` | input | `boolean` | `false` | Esconde o rótulo da vista, mantendo-o para o leitor de tela. |
|
|
2474
|
+
| `loading` | input | `boolean` | `false` | |
|
|
2475
|
+
| `maxRows` | input | `number \| null` | `null` | Com `autoGrow`: cresce até este número de linhas e passa a rolar por dentro. `null` = sem limite. |
|
|
2476
|
+
| `submitKey` | input | `TextareaSubmitKey` | `'none'` | Atalho de teclado que emite `submitted` (ver `TextareaSubmitKey`). |
|
|
2477
|
+
| `submitted` | output | `string` | | A pessoa usou o atalho de envio (`submitKey`); leva o texto atual. Limpar o campo é do app. |
|
|
2478
|
+
| `disabled` | input (herdado) | `boolean` | `false` | |
|
|
2479
|
+
| `required` | input (herdado) | `boolean` | `false` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
|
|
2480
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
|
|
2481
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
|
|
2482
|
+
|
|
2483
|
+
## `hm-theme-builder`
|
|
2484
|
+
|
|
2485
|
+
`ThemeBuilderComponent` — import de `@trismegisto/angular/theme-builder` (também na raiz)
|
|
2486
|
+
|
|
2487
|
+
Editor de família de cor: parte de uma família existente, edita as cores-base (accent e painel por tema, mais as superfícies do escuro — derivadas do accent ou à mão), **valida o contraste AA ao vivo** e exporta CSS, JSON (W3C DTCG, igual ao `families.tokens.json`) ou TypeScript para copiar ou baixar.
|
|
2488
|
+
|
|
2489
|
+
Métodos públicos: `download(): void`
|
|
2490
|
+
|
|
2491
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2492
|
+
|---|---|---|---|---|
|
|
2493
|
+
| `families` | input | `readonly HermesFamily[]` | `HERMES_FAMILIES` | Famílias oferecidas como ponto de partida (e comparadas na distinção). |
|
|
2494
|
+
| `baseFamily` | input | `string` | `''` | Id da família de partida (padrão: a primeira de `families`). |
|
|
2495
|
+
| `systemColors` | input | `FamilySystemColors` | `HERMES_FAMILY_SYSTEM_COLORS` | Cores do sistema usadas na validação (padrão: as do `tokens.css`). |
|
|
2496
|
+
| `exportFormats` | input | `readonly ThemeBuilderFormat[]` | `['css', 'json', 'typescript']` | Formatos de exportação oferecidos, na ordem. |
|
|
2497
|
+
| `headingLevel` | input | `2 \| 3 \| 4` | `2` | Nível dos títulos das seções (2 numa página própria; 3 dentro de outra seção). |
|
|
2498
|
+
| `draftChange` | output | `FamilyDraft` | | Emite o rascunho a cada mudança. |
|
|
2499
|
+
|
|
2500
|
+
## `hm-theme-picker`
|
|
2501
|
+
|
|
2502
|
+
`ThemePickerComponent` — import de `@trismegisto/angular/theme-picker` (também na raiz)
|
|
2503
|
+
|
|
2504
|
+
Conteúdo do modal de tema: grade de famílias de cor (aqui as mesmas 12 do design de referência, ver families.ts) e o par claro/escuro embaixo.
|
|
2505
|
+
|
|
2506
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2507
|
+
|---|---|---|---|---|
|
|
2508
|
+
| `families` | input (obrigatório) | `readonly HermesFamily[]` | | |
|
|
2509
|
+
| `family` | input (obrigatório) | `string` | | |
|
|
2510
|
+
| `theme` | input (obrigatório) | `HermesThemeName` | | |
|
|
2511
|
+
| `showMode` | input | `boolean` | `true` | Mostra o par claro/escuro embaixo da grade. `false` quando o modo é escolhido em outro controle (ex.: `hm-segmented-control` com a opção "Sistema", no painel d… |
|
|
2512
|
+
| `familyChosen` | output | `string` | | |
|
|
2513
|
+
| `themeChosen` | output | `HermesThemeName` | | |
|
|
2514
|
+
|
|
2515
|
+
## `[hermesTheme]`
|
|
2516
|
+
|
|
2517
|
+
`HermesThemeDirective` — import de `@trismegisto/angular/theme` (também na raiz)
|
|
2518
|
+
|
|
2519
|
+
Aplica o tema atual ao elemento: `data-theme`/`data-family` (que ativam tokens.css) e as cores de ação/painel da família (ver `themeHostProps` em @trismegisto/primitives). Tudo dentro herda os tokens `--hm-*`.
|
|
2520
|
+
|
|
2521
|
+
_Sem inputs/outputs._
|
|
2522
|
+
|
|
2523
|
+
## `hm-time-picker`
|
|
2524
|
+
|
|
2525
|
+
`TimePickerComponent` · `ControlValueAccessor` · estende `HermesFormFieldBase` — import de `@trismegisto/angular/time-picker` (também na raiz)
|
|
2526
|
+
|
|
2527
|
+
Campo de hora. Digita-se a hora com máscara no relógio do idioma — 24 h (`14:30`) ou 12 h (`02:30 PM`, uma letra `a`/`p` completa o período), decidido por `Intl.DateTimeFormat(locale).resolvedOptions().hourCycle` do `meta.locale` ou forçado por `hourCycle` — ou escolhe-se na lista de horários sugeridos (`interval` em minutos, dentro de `min`/`max`).
|
|
2528
|
+
|
|
2529
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2530
|
+
|---|---|---|---|---|
|
|
2531
|
+
| `value` | model | `string \| null` | `null` | |
|
|
2532
|
+
| `label` | input (obrigatório) | `string` | | |
|
|
2533
|
+
| `labelHidden` | input | `boolean` | `false` | |
|
|
2534
|
+
| `hint` | input | `string` | `''` | |
|
|
2535
|
+
| `placeholder` | input | `string` | `''` | |
|
|
2536
|
+
| `min` | input | `IsoTime \| null` | `null` | Primeiro horário aceito (`HH:mm`). |
|
|
2537
|
+
| `max` | input | `IsoTime \| null` | `null` | Último horário aceito (`HH:mm`). |
|
|
2538
|
+
| `interval` | input | `number` | `30` | Intervalo, em minutos, entre os horários sugeridos. |
|
|
2539
|
+
| `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` | Obrigatório sem formulário (com formulário, vale `Validators.required` do controle). |
|
|
2542
|
+
| `error` | input (herdado) | `string` | `''` | Erro definido por quem usa (validação própria, resposta do servidor). Tem precedência sobre o do controle. |
|
|
2543
|
+
| `messages` | input (herdado) | `Readonly<Record<string, string>>` | `{}` | Texto por chave de erro de validação (`{ email: 'Informe um e-mail válido.' }`). |
|
|
2544
|
+
|
|
2545
|
+
## `hm-timeline-item`
|
|
2546
|
+
|
|
2547
|
+
`TimelineItemComponent` — import de `@trismegisto/angular/timeline` (também na raiz)
|
|
2548
|
+
|
|
2549
|
+
Um item de `hm-timeline`: título, data, descrição, situação e — no `<ng-content>` — qualquer conteúdo extra (um link, um anexo, um comentário). Não desenha nada sozinho: o `hm-timeline` monta a lista (`<ol>`/`<li>`) e encaixa o conteúdo deste item no lugar certo.
|
|
2550
|
+
|
|
2551
|
+
Slots: `(padrão)`
|
|
2552
|
+
|
|
2553
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2554
|
+
|---|---|---|---|---|
|
|
2555
|
+
| `key` | input | `string` | `''` | Identificador do item, comparado com o `current` do `hm-timeline`. |
|
|
2556
|
+
| `label` | input (obrigatório) | `string` | | Título do item ("Pedido recebido"). |
|
|
2557
|
+
| `date` | input | `TimelineDateValue` | `null` | Quando aconteceu: `Date`, ISO ou epoch. Formatado no idioma do catálogo. |
|
|
2558
|
+
| `description` | input | `string` | `''` | Texto curto sob o título. |
|
|
2559
|
+
| `status` | input | `TimelineStatus \| null` | `null` | Situação explícita. Vazia (`null`): deriva do `current`/`outcome` do `hm-timeline`. |
|
|
2560
|
+
| `icon` | input | `string` | `''` | Ícone da marca no lugar do padrão da situação (decorativo: a situação continua em texto). |
|
|
2561
|
+
|
|
2562
|
+
## `hm-timeline`
|
|
2563
|
+
|
|
2564
|
+
`TimelineComponent` — import de `@trismegisto/angular/timeline` (também na raiz)
|
|
2565
|
+
|
|
2566
|
+
Linha do tempo (`hm-timeline` + `hm-timeline-item`): a trilha de algo que anda sozinho — uma solicitação, um pedido, um chamado — com o que já aconteceu, onde está e o que falta.
|
|
2567
|
+
|
|
2568
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2569
|
+
|---|---|---|---|---|
|
|
2570
|
+
| `orientation` | input | `TimelineOrientation` | `'vertical'` | Direção da trilha. A horizontal serve a poucos itens curtos; com muitos, use a vertical. |
|
|
2571
|
+
| `current` | input | `string` | `''` | `key` do item em que o processo está agora. Vazio: nenhum (tudo pendente, salvo `status` explícito). |
|
|
2572
|
+
| `outcome` | input | `TimelineOutcome` | `'running'` | Como o processo está: correndo (o atual pulsa), concluído (tudo concluído) ou com falha (o atual com erro). |
|
|
2573
|
+
| `label` | input | `string` | `''` | Nome da lista para leitor de tela. Vazio = catálogo ("Linha do tempo"). |
|
|
2574
|
+
| `dateFormat` | input | `Intl.DateTimeFormatOptions` | `TIMELINE_DATE_FORMAT` | Formato das datas (`Intl.DateTimeFormatOptions`). Padrão: data média e hora curta. |
|
|
2575
|
+
|
|
2576
|
+
## `hm-toast-stack`
|
|
2577
|
+
|
|
2578
|
+
`ToastStackComponent` — import de `@trismegisto/angular/toast` (também na raiz)
|
|
2579
|
+
|
|
2580
|
+
A pilha de avisos flutuantes, montada uma vez pro app inteiro (ver `HermesToastService`).
|
|
2581
|
+
|
|
2582
|
+
_Sem inputs/outputs._
|
|
2583
|
+
|
|
2584
|
+
## `hm-toast`
|
|
2585
|
+
|
|
2586
|
+
`ToastComponent` — import de `@trismegisto/angular/toast` (também na raiz)
|
|
2587
|
+
|
|
2588
|
+
Um aviso que chega sozinho, em cartão flutuante: ícone da variante, título, mensagem, ação opcional (ex.: "Desfazer"), botão de fechar e a barra de tempo que ele tem na tela.
|
|
2589
|
+
|
|
2590
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2591
|
+
|---|---|---|---|---|
|
|
2592
|
+
| `variant` | input | `AlertVariant` | `'info'` | |
|
|
2593
|
+
| `title` | input | `string` | `''` | Vazio = título padrão da variante, do catálogo (`HERMES_MESSAGES.toast.titles`, acompanha o idioma). |
|
|
2594
|
+
| `message` | input (obrigatório) | `string` | | |
|
|
2595
|
+
| `duration` | input | `number` | `0` | Milissegundos até sair sozinho. `0` fica até alguém fechar (é o que a pausa usa). |
|
|
2596
|
+
| `actionLabel` | input | `string` | `''` | Texto do botão de ação (ex.: "Desfazer"). Vazio não desenha o botão. |
|
|
2597
|
+
| `action` | output | `void` | | Clique no botão de ação. Quem usa decide se fecha (o `hm-toast-stack` roda a ação e fecha). |
|
|
2598
|
+
| `closed` | output | `void` | | |
|
|
2599
|
+
|
|
2600
|
+
## `hm-toggle-group-item`
|
|
2601
|
+
|
|
2602
|
+
`ToggleGroupItemComponent` — import de `@trismegisto/angular/toggle-group` (também na raiz)
|
|
2603
|
+
|
|
2604
|
+
Um botão de `hm-toggle-group`. `value` identifica o item no `[(value)]` do grupo.
|
|
2605
|
+
|
|
2606
|
+
Slots: `(padrão)`
|
|
2607
|
+
|
|
2608
|
+
Métodos públicos: `focus(): void`
|
|
2609
|
+
|
|
2610
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2611
|
+
|---|---|---|---|---|
|
|
2612
|
+
| `value` | input (obrigatório) | `string` | | Identifica o item no `[(value)]` do grupo. Único dentro do grupo. |
|
|
2613
|
+
| `icon` | input | `string` | `''` | Ícone do catálogo antes do texto (ou sozinho). Decorativo. |
|
|
2614
|
+
| `iconDirection` | input | `string` | `''` | Direção de ícones direcionais (`angle`, `arrow`...). |
|
|
2615
|
+
| `label` | input | `string` | `''` | Nome acessível quando o item é só ícone (`aria-label`). Com texto projetado, deixe vazio. |
|
|
2616
|
+
| `disabled` | input | `boolean` | `false` | |
|
|
2617
|
+
|
|
2618
|
+
## `hm-toggle-group`
|
|
2619
|
+
|
|
2620
|
+
`ToggleGroupComponent` — import de `@trismegisto/angular/toggle-group` (também na raiz)
|
|
2621
|
+
|
|
2622
|
+
Grupo de botões de alternância — a barra "negrito \| itálico \| sublinhado" ou "alinhar à esquerda \| ao centro \| à direita", em geral só com ícones.
|
|
2623
|
+
|
|
2624
|
+
Slots: `(padrão)`
|
|
2625
|
+
|
|
2626
|
+
Métodos públicos: `isMultiple(): boolean`, `isPressed(value: string): boolean`, `isDisabled(): boolean`, `tabIndexFor(value: string): number \| null`, `focused(value: string): void`, `activate(value: string): void`
|
|
2627
|
+
|
|
2628
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2629
|
+
|---|---|---|---|---|
|
|
2630
|
+
| `label` | input (obrigatório) | `string` | | Nome do grupo para leitor de tela (`aria-label`). Obrigatório: os itens costumam ser só ícone. |
|
|
2631
|
+
| `multiple` | input | `boolean` | `false` | Escolha múltipla (`[(value)]` vira lista e os itens viram botões com `aria-pressed`). |
|
|
2632
|
+
| `value` | model | `T` | `[] as unknown as T` | Item marcado (texto, escolha única) ou itens ligados (lista, múltipla). Two-way. |
|
|
2633
|
+
| `appearance` | input | `ToggleGroupAppearance` | `'outlined'` | |
|
|
2634
|
+
| `size` | input | `ToggleGroupSize` | `'medium'` | |
|
|
2635
|
+
| `orientation` | input | `ToggleGroupOrientation` | `'horizontal'` | |
|
|
2636
|
+
| `disabled` | input | `boolean` | `false` | Desabilita todos os itens. |
|
|
2637
|
+
|
|
2638
|
+
## `hm-toggletip`
|
|
2639
|
+
|
|
2640
|
+
`ToggletipComponent` — import de `@trismegisto/angular/toggletip` (também na raiz)
|
|
2641
|
+
|
|
2642
|
+
Dica de clique ("toggletip"): um ícone de informação que, **ao clique**, abre um balão de ajuda que fica até a pessoa fechar — clicando fora, no `Esc` (o foco volta ao ícone) ou de novo no ícone. O balão entra numa região `role="status"`, então o leitor de tela anuncia o texto ao abrir.
|
|
2643
|
+
|
|
2644
|
+
Slots: `(padrão)`
|
|
2645
|
+
|
|
2646
|
+
Métodos públicos: `close(): void`
|
|
2647
|
+
|
|
2648
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2649
|
+
|---|---|---|---|---|
|
|
2650
|
+
| `label` | input (obrigatório) | `string` | | Nome acessível do ícone — diga sobre o que é a ajuda: "Mais informações sobre o prazo". |
|
|
2651
|
+
| `text` | input | `string` | `''` | Texto do balão. Pode ser substituído/complementado por conteúdo projetado. |
|
|
2652
|
+
| `side` | input | `ToggletipSide` | `'bottom'` | |
|
|
2653
|
+
| `intent` | input | `'default' \| 'danger'` | `'default'` | `danger`: ícone vermelho, para o aviso de um grupo sem campo próprio. |
|
|
2654
|
+
| `icon` | input | `string` | `'info-circle'` | |
|
|
2655
|
+
|
|
2656
|
+
## `hm-toolbar`
|
|
2657
|
+
|
|
2658
|
+
`ToolbarComponent` — import de `@trismegisto/angular/toolbar` (também na raiz)
|
|
2659
|
+
|
|
2660
|
+
Barra de ferramentas: agrupa os controles de uma tela ou região (busca, filtros, ações) num único ponto de parada do Tab. Comportamento do padrão Toolbar do WAI-ARIA APG.
|
|
2661
|
+
|
|
2662
|
+
Slots: `[start]`, `(padrão)`, `[end]`
|
|
2663
|
+
|
|
2664
|
+
Métodos públicos: `items(): HTMLElement[]`, `sync(): void`
|
|
2665
|
+
|
|
2666
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2667
|
+
|---|---|---|---|---|
|
|
2668
|
+
| `label` | input (obrigatório) | `string` | | Nome da barra (`aria-label`). Obrigatório: é o que distingue esta barra das outras. |
|
|
2669
|
+
|
|
2670
|
+
## `[hmTooltip]`
|
|
2671
|
+
|
|
2672
|
+
`TooltipDirective` — import de `@trismegisto/angular/tooltip` (também na raiz)
|
|
2673
|
+
|
|
2674
|
+
Dica: texto curto que nomeia ou complementa o elemento, aberto no **hover e no foco** (só hover excluiria quem navega por teclado). Diretiva, no padrão de mercado (`matTooltip`, Radix Tooltip): `<hm-icon-button hmTooltip="Exportar" … />`.
|
|
2675
|
+
|
|
2676
|
+
Métodos públicos: `show(): void`, `hide(): void`
|
|
2677
|
+
|
|
2678
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2679
|
+
|---|---|---|---|---|
|
|
2680
|
+
| `hmTooltip` | input (obrigatório) | `string` | | Texto da dica. Vazio desliga a dica. |
|
|
2681
|
+
| `hmTooltipSide` | input | `PopoverSide` | `'top'` | Lado preferido; vira sozinho quando não cabe. |
|
|
2682
|
+
| `hmTooltipDisabled` | input | `boolean` | `false` | |
|
|
2683
|
+
| `hmTooltipShowDelay` | input | `number` | `400` | Espera antes de abrir no hover (ms). No foco abre na hora. |
|
|
2684
|
+
| `hmTooltipHideDelay` | input | `number` | `120` | Espera antes de fechar ao sair o ponteiro (ms) — o tempo de chegar com ele até a dica. |
|
|
2685
|
+
|
|
2686
|
+
## `hm-tree`
|
|
2687
|
+
|
|
2688
|
+
`TreeComponent` — import de `@trismegisto/angular/tree` (também na raiz)
|
|
2689
|
+
|
|
2690
|
+
Árvore no padrão `role="tree"`, com as funcionalidades do `hermes-tree` do hermes-ui antigo: - **Seleção múltipla tri-state** (`selectable`, padrão): caixa `.hm-check` por nó — marcada, desmarcada ou indeterminada quando só parte dos filhos está marcada. Marcar uma pasta marca todas as folhas dela. Recebe `selected` e emite `changed` (lote) — não decide o domínio. - **Navegação** (`[selectable]="…
|
|
2691
|
+
|
|
2692
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2693
|
+
|---|---|---|---|---|
|
|
2694
|
+
| `nodes` | input (obrigatório) | `readonly TreeNode[]` | | |
|
|
2695
|
+
| `label` | input (obrigatório) | `string` | | Nome da árvore para leitor de tela. |
|
|
2696
|
+
| `emptyMessage` | input | `string` | | |
|
|
2697
|
+
| `selectable` | input | `boolean` | `true` | Mostra as caixas de marcação (seleção múltipla). `false` = árvore de navegação. |
|
|
2698
|
+
| `selectionMode` | input | `TreeSelectionMode \| null` | `null` | Seleção por `aria-selected` (ver doc da classe). `null` (padrão) = comportamento de sempre, decidido por `selectable` (caixas tri-state ou navegação com `activ… |
|
|
2699
|
+
| `selection` | model | `ReadonlySet<string>` | `new Set<string>()` | Two-way: ids selecionados em `selectionMode` `single`/`multiple`. |
|
|
2700
|
+
| `selected` | input | `ReadonlySet<string>` | `new Set<string>()` | Ids marcados agora (folhas; ou pasta lazy ainda fechada). |
|
|
2701
|
+
| `expanded` | model | `ReadonlySet<string>` | `new Set<string>()` | Two-way: ids das pastas abertas. |
|
|
2702
|
+
| `activeId` | model | `string \| null` | `null` | Two-way: nó ativo (destacado, `aria-selected`) — seleção única / navegação. |
|
|
2703
|
+
| `loadChildren` | input | `TreeChildrenLoader \| null` | `null` | Busca os filhos de um nó `expandable` na primeira vez que ele é aberto. |
|
|
2704
|
+
| `changed` | output | `readonly TreeSelectionChange[]` | | O que marcar/desmarcar — sempre em lote, mesmo quando é uma folha só. |
|
|
2705
|
+
| `activated` | output | `TreeNode` | | Nó ativado (clique/Enter) — em árvore de navegação, ou clique no rótulo com `selectable`. |
|
|
2706
|
+
| `draggable` | input | `boolean` | `false` | Liga mover nó por arrasto (ponteiro e teclado). Nó desabilitado não é arrastado. |
|
|
2707
|
+
| `canDrop` | input | `TreeCanDrop \| null` | `null` | Filtro de destino: pode soltar `node` em `position` de `target`? Substitui o padrão, que só aceita "dentro" de nó que pode ter filhos (`treeAcceptsChildren`).… |
|
|
2708
|
+
| `moved` | output | `TreeMoveEvent` | | Nó solto num novo lugar. Os dados não mudam sozinhos: o app aplica (ex.: `moveTreeNode`). |
|
|
2709
|
+
| `nodeActions` | input | `TreeNodeActions` | `EMPTY_ACTIONS` | Itens do menu de contexto do nó (vazio = menu nativo do navegador). Função = itens por nó. |
|
|
2710
|
+
| `nodeAction` | output | `TreeNodeActionEvent` | | Item escolhido no menu de contexto de um nó. |
|
|
2711
|
+
|
|
2712
|
+
## `ng-template[hmTreeNode]`
|
|
2713
|
+
|
|
2714
|
+
`TreeNodeTemplateDirective` — import de `@trismegisto/angular/tree` (também na raiz)
|
|
2715
|
+
|
|
2716
|
+
Conteúdo customizado do nó (no lugar de ícone + rótulo).
|
|
2717
|
+
|
|
2718
|
+
_Sem inputs/outputs._
|
|
2719
|
+
|
|
2720
|
+
## `hm-wizard`
|
|
2721
|
+
|
|
2722
|
+
`WizardComponent` — import de `@trismegisto/angular/wizard` (também na raiz)
|
|
2723
|
+
|
|
2724
|
+
Assistente em etapas: o `hm-stepper` dentro de um `hm-modal` (ou direto na página, `mode="page"`), com o rodapé Cancelar / Voltar / Avançar — que vira Concluir na última etapa.
|
|
2725
|
+
|
|
2726
|
+
Slots: `(padrão)`
|
|
2727
|
+
|
|
2728
|
+
Métodos públicos: `isActive(step: object): boolean`
|
|
2729
|
+
|
|
2730
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2731
|
+
|---|---|---|---|---|
|
|
2732
|
+
| `heading` | input | `string` | `''` | Título do assistente (cabeçalho do modal e nome acessível do diálogo). |
|
|
2733
|
+
| `mode` | input | `WizardMode` | `'modal'` | `modal` (padrão) ou `page` — o mesmo fluxo no corpo da página, sem sobreposição. |
|
|
2734
|
+
| `open` | model | `boolean` | `false` | Visibilidade no modo `modal`. Two-way. |
|
|
2735
|
+
| `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
|
+
| `selectedIndex` | model | `number` | `0` | Two-way: índice da etapa aberta. |
|
|
2737
|
+
| `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
|
+
| `loading` | input | `boolean` | `false` | Salvando: o Concluir carrega, os demais botões e o X travam. |
|
|
2740
|
+
| `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
|
+
| `level` | input | `number` | `3` | Nível do título de cada etapa (`aria-level`): 3 cabe sob o título do modal (`h2`). |
|
|
2742
|
+
| `resetOnOpen` | input | `boolean` | `true` | Volta o indicador à primeira etapa a cada abertura. |
|
|
2743
|
+
| `backLabel` | input | `string` | `''` | Rótulos do rodapé. Vazio = catálogo. |
|
|
2744
|
+
| `nextLabel` | input | `string` | `''` | |
|
|
2745
|
+
| `finishLabel` | input | `string` | `''` | |
|
|
2746
|
+
| `cancelLabel` | input | `string` | `''` | |
|
|
2747
|
+
| `summary` | input | `boolean` | `false` | Monta a página de resumo no fim do fluxo com o que cada `hm-step` entrega em `summary`. Padrão desligado (compatível: sem ele o wizard é o mesmo de antes). |
|
|
2748
|
+
| `summaryLabel` | input | `string` | `''` | Rótulo da etapa de resumo e texto de apoio no topo dela. Vazio = catálogo ("Revisão"). |
|
|
2749
|
+
| `summaryDescription` | input | `string` | `''` | |
|
|
2750
|
+
| `completed` | output | `void` | | Concluir com a última etapa válida. |
|
|
2751
|
+
| `cancelled` | output | `void` | | Cancelado (e confirmado, se `confirmCancel`). |
|
|
2752
|
+
|
|
2753
|
+
## `hm-workspace-node`
|
|
2754
|
+
|
|
2755
|
+
`WorkspaceNodeComponent` — import de `@trismegisto/angular/workspace` (também na raiz)
|
|
2756
|
+
|
|
2757
|
+
Um nó da árvore do `hm-workspace`: ou é um painel-folha (fileira de abas + conteúdo projetado), ou é uma divisão (dois nós filhos dentro de um `hm-splitter`) — recursivo, se renderiza a si mesmo pros dois lados. Não é público (`hm-workspace` é a peça que se usa; este é o motor de apresentação por trás dela).
|
|
2758
|
+
|
|
2759
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2760
|
+
|---|---|---|---|---|
|
|
2761
|
+
| `node` | input (obrigatório) | `PanelNode` | | |
|
|
2762
|
+
| `path` | input | `SplitPath` | `[]` | |
|
|
2763
|
+
| `store` | input (obrigatório) | `WorkspaceStore` | | |
|
|
2764
|
+
| `focusedPanelId` | input (obrigatório) | `string` | | |
|
|
2765
|
+
| `panelLabels` | input (obrigatório) | `ReadonlyMap<string, string>` | | |
|
|
2766
|
+
| `contentTemplate` | input (obrigatório) | `TemplateRef<WorkspaceTabContext>` | | |
|
|
2767
|
+
| `keepAlive` | input | `boolean` | `false` | Ver `hm-workspace`: mantém as abas inativas montadas, escondidas. |
|
|
2768
|
+
| `newTabRequested` | output | `string` | | O `+` de algum painel (não importa quão fundo na árvore) — borbulha até a raiz. O motor não sabe o que uma aba nova deveria conter (apresentacional, como o res… |
|
|
2769
|
+
|
|
2770
|
+
## `hm-workspace`
|
|
2771
|
+
|
|
2772
|
+
`WorkspaceComponent` — import de `@trismegisto/angular/workspace` (também na raiz)
|
|
2773
|
+
|
|
2774
|
+
Área de trabalho em painéis, estilo VS Code: dividir, mover aba entre painéis, redimensionar, fechar (funde o painel de volta). Apresentacional como o resto da base — não sabe o que é o conteúdo de uma aba, só desenha o que vem do `<ng-template #content let-tab>` projetado; quem decide o que cada `tab.id` significa é quem consome.
|
|
2775
|
+
|
|
2776
|
+
Slots: `(padrão)`
|
|
2777
|
+
|
|
2778
|
+
Templates no conteúdo: `<ng-template #content>`
|
|
2779
|
+
|
|
2780
|
+
| Nome | Tipo | Tipo TS | Padrão | Descrição |
|
|
2781
|
+
|---|---|---|---|---|
|
|
2782
|
+
| `initialTabs` | input | `readonly TabItem[]` | `[]` | Abas do painel inicial (único, antes de qualquer divisão) — ignorado se `providedStore` vier preenchido. |
|
|
2783
|
+
| `initialActiveId` | input | `string` | `''` | Vazio = a primeira aba de `initialTabs`. |
|
|
2784
|
+
| `keepAlive` | input | `boolean` | `false` | Mantém montada a página de cada aba (as inativas ficam só escondidas) em vez de recriar a tela a cada troca de aba -- preserva estado, filtros, rolagem e requi… |
|
|
2785
|
+
| `label` | input | `string` | `''` | Nome da região (`aria-label`). Padrão do catálogo ("Área de trabalho"). Duas áreas de trabalho na mesma tela precisam de nomes diferentes (axe `landmark-unique… |
|
|
2786
|
+
| `providedStore` | input | `WorkspaceStore \| null` | `null` | Store já pronto (ex.: restaurado de `sessionStorage` via `restoreWorkspaceStore` — ver `@trismegisto/primitives`'s `workspace.ts`) — quando fornecido, o compon… |
|
|
2787
|
+
| `stateChange` | output | `WorkspaceState` | | A árvore inteira, a cada mudança — observar é opcional (ex.: persistência própria de quem consome). |
|
|
2788
|
+
| `newTabRequested` | output | `string` | | O `+` de algum painel (o id do painel vem no evento) — motor não sabe o que uma aba nova deveria conter, quem consome decide. Para abrir a aba, quem consome pr… |
|