Diálogos, formulários e assistentes
Sobre o <dialog> nativo, sem dependências e com acessibilidade testada.
Para : pedidos de férias, admissões de funcionários, aprovações com motivo, exclusões com confirmação e importar do Excel.
npm i nexus-dialogsimport { confirmDelete } from 'nexus-dialogs/patterns'
if (await confirmDelete({ what: 'Laura Méndez' })) {
await api.funcionarios.excluir(id)
}
Veja em ação
É uma maquete que você pode usar: digite, clique e teste a validação. Escolha a cena e a aparência; os diálogos de verdade desta página mudam com a aparência.
Excluir Laura Méndez?
O registro será excluído. Esta ação não pode ser desfeita.
Ver código
import { confirmDelete } from 'nexus-dialogs/patterns'
import { confirmDelete } from 'nexus-dialogs/patterns'
if (await confirmDelete({ what: 'Laura Méndez' })) {
// excluir
}
Novidades
O mais recente da versão 1.1.1. Ver todas as mudanças.
Abas
Dados gerais, agendamento e entrevista em um mesmo diálogo, com teclado e leitores de tela. Testar · Guia
Acompanhamento por etapas
O andamento de um candidato ou de um trâmite com estado, data e progresso, vertical ou horizontal. Testar · Guia
Tamanhos e adaptável
Abas e acompanhamento em sm, md ou lg, e se ajustam à largura do espaço, também no celular. Testar · Guia
HTML seguro por padrão
O html em texto aparece como texto, a menos que você o permita com strictHtml ou o filtre com sanitize, também no build sem bundler com Swal.configure. Segurança
Formulários em colunas
columns: 'auto': duas colunas no telefone, três no desktop, e os campos longos em linha inteira. Guia
Teste aqui mesmo
Estes botões usam a biblioteca desta página, não capturas de tela.
Por quê
Os alertas resolvem o «Tem certeza?» e pouco mais. O nexus-dialogs traz também formulários com validação, assistentes de vários passos, importar e exportar Excel, validadores do México e modelos de RH.
Camada superior real
Sem guerras de z-index com Bootstrap, outras bibliotecas ou seu menu fixo. O fundo fica inerte e a rolagem bloqueada.
Shadow DOM
O CSS da sua página não o quebra e o dele não vaza. Funciona com uma CSP estrita, sem unsafe-inline.
Promessas que não falham
const r = await dialog.confirm(…) sempre resolve com { confirmed, denied, value, reason }.
Acessível de verdade
Foco inicial correto, Esc, retorno do foco, erros ligados a cada campo, toasts anunciados e movimento reduzido. Testado com axe.
Feito para RH e contabilidade
RFC, CURP, NSS e CLABE com dígito verificador, valores em pesos, dias úteis e feriados, assinatura, endereço por código postal.
Migre do SweetAlert2
Troque o import e seu código continua funcionando. Veja como migrar.
Uma peça em vez de várias
O que em um sistema empresarial costuma ser montado juntando pacotes diferentes, aqui vem em um só e sem dependências.
| O que você precisa | Costuma ser montado com | No nexus-dialogs |
|---|---|---|
| Confirmar, aprovar, avisar de mudanças | Uma biblioteca de alertas ou de modais | confirmDelete, approval, unsavedChanges |
| Formulários com validação | Uma biblioteca de formulários e outra de validação | form, com RFC, CLABE e mais já validados |
| Datas e dias úteis | Um componente de calendário à parte | O campo daterange com businessDays |
| Importar e exportar Excel | Mais um utilitário, com sua própria interface | importData e exportData |
| Avisos que desaparecem | Uma biblioteca de toasts | toast, com «Desfazer» |
| Acessibilidade | Revisar cada peça separadamente | Foco, teclado e objetivo WCAG 2.2 AA, com testes axe |
Cada peça que você soma é outra versão para atualizar e outro estilo para igualar. Aqui é uma, com um só tema.
Em uma linha
Cada receita já traz o texto, os botões, o foco e a acessibilidade corretos.
import { dialog } from 'nexus-dialogs'
import { confirmDelete } from 'nexus-dialogs/patterns'
import { form } from 'nexus-dialogs/forms'
import { toast } from 'nexus-dialogs/toast'
if (await confirmDelete({ what: 'Laura Méndez' })) await api.funcionarios.excluir(id)
const r = await form({
title: 'Nova despesa',
fields: [
{ name: 'rfc', label: 'RFC do fornecedor', type: 'rfc', required: true },
{ name: 'valor', label: 'Valor', type: 'money', required: true },
],
})
if (r.confirmed) toast.success('Enviado para aprovação')Módulos: instale só o que usa
Tamanhos medidos ao construir este site (minificado + gzip). Cada rota é importada separadamente.
| Rota | Para quê | Tamanho |
|---|---|---|
nexus-dialogs | alert, confirm, prompt, open | 11.2 KB |
nexus-dialogs/forms | form, wizard, formFromJSON e os campos | 24.9 KB |
nexus-dialogs/toast | Avisos com fila | 5.1 KB |
nexus-dialogs/patterns | Receitas: excluir, não salvo, sessão, aprovar, ações em massa | 6.2 KB |
nexus-dialogs/import | Importar e exportar CSV e Excel | 10.1 KB |
nexus-dialogs/table | Escolher linhas de uma tabela | 3.6 KB |
nexus-dialogs/tabs | Abas acessíveis, soltas ou em um diálogo; tamanhos e adaptáveis | 3.2 KB |
nexus-dialogs/timeline | Acompanhamento por etapas com estado, data e progresso | 2.9 KB |
nexus-dialogs/mx | RFC, CURP, NSS, CLABE, dias úteis | 1.1 KB |
nexus-dialogs/rrhh | Modelos de RH em JSON | 4.0 KB |
nexus-dialogs/themes | Bootstrap, Tailwind, Material, escuro | 1.3 KB |
nexus-dialogs/vue · /react | Plugin e hooks que fecham os diálogos ao desmontar | 0.8 KB · 1.0 KB |
nexus-dialogs/swal | Compatível com SweetAlert2 | 7.5 KB |
As rotas que dependem do núcleo o compartilham: não é baixado duas vezes.