Saltar al contenido
nexus-dialogs
GitHub npm

Primeros pasos

Cinco minutos: instalar, abrir tu primer diálogo y resolver tres casos de todos los días. No necesitas leer la guía completa para empezar; cuando te haga falta algo más, el último apartado te dice dónde buscarlo.

#1. Instalar

npm i nexus-dialogs

Sin bundler, con un <script> desde un CDN, también sirve: ver la guía.

#2. Tu primer diálogo: confirmar una operación

import { dialog } from 'nexus-dialogs'

const r = await dialog.confirm({
  title: '¿Enviar el pedido?',
  text: 'Se avisará al almacén.',
  confirmText: 'Enviar',
})

if (r.confirmed) await enviarPedido()

Cancelar, cerrar con Esc o hacer clic fuera no es un error: la promesa resuelve siempre con { confirmed, denied, value, reason }. Si lo que borras no tiene vuelta atrás, agrega danger: true y el foco queda en Cancelar.

#3. Pedir datos: crear un cliente

import { form } from 'nexus-dialogs/forms'
import { toast } from 'nexus-dialogs/toast'

const nuevo = await form<{ nombre: string; correo: string }>({
  title: 'Nuevo cliente',
  submitText: 'Crear cliente',
  fields: [
    { name: 'nombre', label: 'Nombre', required: true },
    { name: 'correo', label: 'Correo', type: 'email', required: true },
  ],
  preConfirm: (v) => api.clientes.crear(v), // muestra «Procesando…»; si lanza, el error se ve dentro del diálogo
})

if (nuevo.confirmed) toast.success('Cliente creado')

La validación (campos obligatorios, correo válido) y los errores de cada campo ya vienen hechos.

#4. Registrar una compra

const compra = await form({
  title: 'Registrar compra',
  columns: 2,
  fields: [
    { name: 'proveedor', label: 'Proveedor', required: true },
    { name: 'producto', label: 'Producto', type: 'select', options: ['Papelería', 'Limpieza', 'Equipo'], required: true },
    { name: 'cantidad', label: 'Cantidad', type: 'number', min: 1, required: true },
    { name: 'importe', label: 'Importe', type: 'money', min: 1, required: true },
  ],
  validate: (v) => (v.importe > 50000 ? { importe: 'Más de $50,000 requiere orden de compra.' } : undefined),
})

validate revisa varios campos a la vez y devuelve un mensaje por campo.

#5. Importar productos desde Excel o CSV

import { importData } from 'nexus-dialogs/import'

const r = await importData({
  title: 'Importar productos',
  columns: [
    { name: 'sku', label: 'SKU', required: true, unique: true },
    { name: 'nombre', label: 'Nombre', required: true },
    { name: 'precio', label: 'Precio', type: 'number' },
  ],
  onImport: (filas) => api.post('/productos/lote', filas),
})

El usuario elige el archivo, se relacionan las columnas solas por nombre y se revisa cuántas filas están bien antes de importar. Todo corre en el navegador.

#Qué sigue

Si necesitas…Ve a
Recetas de todos los días (borrar, sin guardar, sesión, aprobar)Guía: recetas
Más campos, columnas y asistentesGuía: formularios y asistentes
Pestañas, tablas y seguimiento por etapasGuía: tablas, pestañas y seguimiento
Vue, React o AngularGuía: Vue 3, React y Angular
Plantillas de RR. HH. y validadores de México (RFC, CURP, NSS, CLABE)Guía: plantillas de RR. HH. y validadores
Cambiar desde SweetAlert2Migrar
Probar todo en vivoEjemplos
Qué garantiza cada módulo y qué no haceLimitaciones y garantías