Aquila – Biblioteca de Componentes Angular Brand Kit
Aquila (código aberto) / Angular Brand Kit (antigo NDBX) é a biblioteca de componentes do Design System da Allianz para Angular. Use padrões modernos do Angular (v19+): componentes standalone, signals, novo fluxo de controle (@if, @for), inject(), etc.
Regras de Importação
Os componentes Aquila são standalone. Importe o componente diretamente:
import { NxButtonComponent } from '@allianz/ng-aquila/button';
import { NxFormfieldComponent } from '@allianz/ng-aquila/formfield';
import { NxInputDirective } from '@allianz/ng-aquila/input';
@Component({
imports: [NxButtonComponent, NxFormfieldComponent, NxInputDirective],
})
Padrão do caminho de importação: @allianz/ng-aquila/{nome-do-componente}
Regras Específicas da Aquila
- Nunca use
NxInputDirectivesem envolver<input nxInput>em<nx-formfield> - Use
<nx-error nxFormfieldError>para mensagens de validação dentro de formfields - Sempre defina
type="button"em<button nxButton>para evitar envio acidental do formulário - Prefira Formulários Reativos com componentes de formulário da Aquila
- Não use estilos CSS inline; confie no estilo interno da Aquila
Formfield com Validação (Formulários Reativos)
<form [formGroup]="form">
<nx-formfield label="Email">
<input nxInput formControlName="email" type="email" />
@if (form.controls.email.errors) {
<nx-error nxFormfieldError>Por favor, insira um email válido</nx-error>
}
</nx-formfield>
</form>
Dropdown
<nx-formfield label="País">
<nx-dropdown formControlName="country">
<nx-dropdown-item value="DE">Alemanha</nx-dropdown-item>
<nx-dropdown-item value="CH">Suíça</nx-dropdown-item>
<nx-dropdown-item value="AT">Áustria</nx-dropdown-item>
</nx-dropdown>
</nx-formfield>
Diálogo Modal
import { NxDialogService } from '@allianz/ng-aquila/modal';
const modalRef = inject(NxDialogService).open(MyDialogComponent);
modalRef.afterClosed().subscribe(result => { /* tratar resultado */ });
Sistema de Grade
Grade responsiva de 12 colunas. nxCol aceita até 7 valores de breakpoint separados por vírgula
na ordem: tiny, small, medium, large, xlarge, 2xlarge, 3xlarge.
Se menos de 7 valores forem fornecidos, o último se repete para os breakpoints restantes
(por exemplo, nxCol="12,8" → 12,8,8,8,8,8,8).
<div nxLayout="grid">
<div nxRow>
<div nxCol="12,12,6">Esquerda</div>
<div nxCol="12,12,6">Direita</div>
</div>
</div>
Componentes Mais Usados
| Componente | Seletor |
|---|---|
| formfield | nx-formfield |
| input | input[nxInput] |
| button | button[nxButton] |
| icon | nx-icon |
| dropdown | nx-dropdown |
| checkbox | nx-checkbox |
| grid | [nxLayout] |
| headline | [nxHeadline] |
| copytext | [nxCopytext] |
| link | nx-link |
| accordion | nx-accordion |
| popover | [nxPopoverTriggerFor] |
| badge | nx-badge |
| datefield | input[nxDatefield] |
| modal | nx-modal |
| message | nx-message |
| data-display | nx-data-display |
| table | [nxHeaderCell] |
| tabs | nx-tab |
| list | ul[nxList] |
| radio-toggle | nx-radio-toggle |
| tooltip | [nxTooltip] |
| switcher | nx-switcher |
| spinner | nx-spinner |
| pagination | nx-pagination |
Encontre Componentes por Caso de Uso
- formulário: autocomplete, checkbox, circle-toggle, code-input, datefield, dropdown, file-uploader, formfield, input, natural-language-form, phone-input, radio-toggle, rating, slider, switcher, timefield
- navegação: breadcrumb, header, menu, tabs, pagination
- tabela: comparison-table, dynamic-table, table
- feedback: badge, indicator, message, modal, notification-panel, progress-stepper, progressbar, spinner, tooltip
- layout: accordion, card, footer, grid, sidepanel, small-stage, toolbar
- overlay: modal, overlay, popover
- mídia: avatar, icon, image, video
- interação: action, button, link, page-search, signal-button
- seleção: checkbox, circle-toggle, dropdown, radio-toggle, taglist
API Detalhada
Para a API completa dos componentes (inputs, outputs, métodos), leia a documentação do componente no pacote instalado do projeto:
geralmente em node_modules/@allianz/ng-aquila/mcp/generated/components/{nome-do-componente}.md ou em um caminho semelhante dependendo da configuração do projeto.
Alternativa: execute uma busca glob com **/mcp/generated/**/.