Pular para o conteúdo
nexus-dialogs
GitHub npm

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-dialogs
empleados.ts
import { confirmDelete } from 'nexus-dialogs/patterns'

if (await confirmDelete({ what: 'Laura Méndez' })) {
  await api.funcionarios.excluir(id)
}
Roda com a biblioteca desta página

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.

Ver código
import { confirmDelete } from 'nexus-dialogs/patterns'

import { confirmDelete } from 'nexus-dialogs/patterns'

if (await confirmDelete({ what: 'Laura Méndez' })) {
  // excluir
}

—downloads no npm, última semana
11.2 KBo núcleo, gzip
9modelos de RH
AAobjetivo WCAG 2.2, com testes axe
Sem dependências TypeScript Shadow DOM Objetivo WCAG 2.2 AA Vue React Angular SweetAlert2
npm v1.1.1 núcleo 11.2 KB gzip licença MIT CI testes a cada mudança

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ê costuma juntar de vários pacotes e onde está no nexus-dialogs
O que você precisaCostuma ser montado comNo nexus-dialogs
Confirmar, aprovar, avisar de mudançasUma biblioteca de alertas ou de modaisconfirmDelete, approval, unsavedChanges
Formulários com validaçãoUma biblioteca de formulários e outra de validaçãoform, com RFC, CLABE e mais já validados
Datas e dias úteisUm componente de calendário à parteO campo daterange com businessDays
Importar e exportar ExcelMais um utilitário, com sua própria interfaceimportData e exportData
Avisos que desaparecemUma biblioteca de toaststoast, com «Desfazer»
AcessibilidadeRevisar cada peça separadamenteFoco, 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.

RotaPara quêTamanho
nexus-dialogsalert, confirm, prompt, open11.2 KB
nexus-dialogs/formsform, wizard, formFromJSON e os campos24.9 KB
nexus-dialogs/toastAvisos com fila5.1 KB
nexus-dialogs/patternsReceitas: excluir, não salvo, sessão, aprovar, ações em massa6.2 KB
nexus-dialogs/importImportar e exportar CSV e Excel10.1 KB
nexus-dialogs/tableEscolher linhas de uma tabela3.6 KB
nexus-dialogs/tabsAbas acessíveis, soltas ou em um diálogo; tamanhos e adaptáveis3.2 KB
nexus-dialogs/timelineAcompanhamento por etapas com estado, data e progresso2.9 KB
nexus-dialogs/mxRFC, CURP, NSS, CLABE, dias úteis1.1 KB
nexus-dialogs/rrhhModelos de RH em JSON4.0 KB
nexus-dialogs/themesBootstrap, Tailwind, Material, escuro1.3 KB
nexus-dialogs/vue · /reactPlugin e hooks que fecham os diálogos ao desmontar0.8 KB · 1.0 KB
nexus-dialogs/swalCompatível com SweetAlert27.5 KB

As rotas que dependem do núcleo o compartilham: não é baixado duas vezes.