Migrar do SweetAlert2
Esta página está disponível apenas em espanhol.
Dos caminos: cambiar solo el import y migrar poco a poco, o pasar directo a la API propia. Puedes mezclar los dos en el mismo proyecto.
Camino 1: cambia el import
El adaptador nexus-dialogs/swal acepta el mismo código que ya tienes: Swal.fire, mixin, toasts, inputs, preConfirm, pasos, timers y los métodos de consulta. Aplica el estándar de botones de la librería.
// antes
import Swal from 'sweetalert2'
// después
import Swal from 'nexus-dialogs/swal'
Sin bundler, cambia el <script> por este (define window.Swal):
<script src="https://cdn.jsdelivr.net/npm/nexus-dialogs/dist/nexus-dialogs.swal.iife.js"></script>
Camino 2: la API propia
Más corta, con tipos precisos y recetas ya hechas (confirmDelete, unsavedChanges, approval, bulkAction…). Cada ejemplo trae los dos botones: el primero corre el código de SweetAlert2 con el adaptador, el segundo la versión propia.
Confirmar un borrado
El caso más común. El adaptador pone el botón en rojo y el foco en «Cancelar» porque el texto dice «eliminar».
Antes: SweetAlert2
const r = await Swal.fire({
title: '¿Eliminar a Laura Méndez?',
text: 'No podrás revertirlo',
icon: 'warning',
showCancelButton: true,
confirmButtonText: 'Sí, eliminar',
})
if (r.isConfirmed) await borrar(id)Después: API propia
import { confirmDelete } from 'nexus-dialogs/patterns'
if (await confirmDelete({ what: 'a Laura Méndez' })) await borrar(id)Aviso de éxito que se cierra solo
El timer se pausa con el mouse o el foco encima, y se respeta «reducir movimiento».
Antes: SweetAlert2
await Swal.fire({
icon: 'success',
title: 'Guardado',
text: 'Los cambios ya están en el sistema',
timer: 2500,
showConfirmButton: false,
})Después: API propia
import { dialog } from 'nexus-dialogs'
await dialog.success({ title: 'Guardado', text: 'Los cambios ya están en el sistema', timer: 2500 })Pedir un dato con validación
inputValidator pasa a `validate`; el error queda ligado al campo y se anuncia a lectores de pantalla.
Antes: SweetAlert2
const { value: correo } = await Swal.fire({
title: 'Correo del cliente',
input: 'email',
inputValidator: (v) => (!v ? 'Escribe un correo' : undefined),
})
if (correo) await enviar(correo)Después: API propia
import { form } from 'nexus-dialogs/forms'
const r = await form({
title: 'Correo del cliente',
fields: [{ name: 'correo', label: 'Correo', type: 'email', required: true }],
})
if (r.confirmed) await enviar(r.value.correo)Formulario con varios campos
En SweetAlert2 se arma con HTML y preConfirm leyendo el DOM. Aquí los campos son datos y la validación va por campo.
Antes: SweetAlert2
const { value } = await Swal.fire({
title: 'Nuevo gasto',
html: '<input id="rfc" class="swal2-input"><input id="importe" class="swal2-input">',
focusConfirm: false,
preConfirm: () => ({
rfc: document.getElementById('rfc').value,
importe: document.getElementById('importe').value,
}),
})Después: API propia
import { form } from 'nexus-dialogs/forms'
const r = await form({
title: 'Nuevo gasto',
fields: [
{ name: 'rfc', label: 'RFC del proveedor', type: 'rfc', required: true },
{ name: 'importe', label: 'Importe', type: 'money', required: true },
],
})Varios pasos
progressSteps y `Swal.mixin().queue` pasan a un asistente con revisión final y progreso accesible.
Antes: SweetAlert2
const Pasos = Swal.mixin({ progressSteps: ['1', '2', '3'], confirmButtonText: 'Siguiente' })
await Pasos.fire({ title: 'Datos', currentProgressStep: 0 })
await Pasos.fire({ title: 'Puesto', currentProgressStep: 1 })
await Pasos.fire({ title: 'Prestaciones', currentProgressStep: 2 })Después: API propia
import { wizard } from 'nexus-dialogs/forms'
const r = await wizard({
title: 'Alta de empleado',
review: true,
steps: [
{ title: 'Datos', fields: [{ name: 'nombre', label: 'Nombre', required: true }] },
{ title: 'Puesto', fields: [{ name: 'puesto', label: 'Puesto', required: true }] },
{ title: 'Prestaciones', fields: [{ name: 'vales', label: 'Vales de despensa', type: 'switch' }] },
],
})Aviso tipo toast
Los toasts comparten una cola y se anuncian en una región viva. Admiten acción «Deshacer».
Antes: SweetAlert2
Swal.fire({
toast: true,
position: 'top-end',
icon: 'success',
title: 'Empleado guardado',
timer: 3000,
showConfirmButton: false,
})Después: API propia
import { toast } from 'nexus-dialogs/toast'
toast.success('Empleado guardado', { action: { label: 'Deshacer', onClick: deshacer } })Operación larga con «Cargando…»
preConfirm async muestra «Procesando…»; si la promesa falla, el error aparece dentro del diálogo y no se cierra.
Antes: SweetAlert2
const r = await Swal.fire({
title: '¿Enviar a timbrar?',
showCancelButton: true,
showLoaderOnConfirm: true,
preConfirm: () => timbrar().catch((e) => Swal.showValidationMessage(e.message)),
})Después: API propia
import { dialog } from 'nexus-dialogs'
const r = await dialog.confirm({
title: '¿Enviar a timbrar?',
preConfirm: () => timbrar(), // si lanza, el error se muestra y el diálogo sigue abierto
})Equivalencias
| SweetAlert2 | nexus-dialogs |
|---|---|
Swal.fire({ icon, title, text }) | dialog.success / error / warning / info |
showCancelButton + isConfirmed | dialog.confirm(…) → r.confirmed |
input + inputValidator | form({ fields }) con required, validate |
html + preConfirm leyendo el DOM | form, datos en r.value |
progressSteps / queue | wizard({ steps, review }) |
toast: true | toast.success / error / info |
showLoaderOnConfirm + preConfirm | preConfirm async (muestra «Procesando…») |
timer, timerProgressBar | timer (se pausa con mouse o foco) |
result.isDismissed, dismiss | r.reason (cancel, escape, backdrop, timer, program) |
Swal.close() | dialog.close() / dialog.closeAll() |
Swal.mixin(defaults) | configure({ defaults }) |
theme, customClass | configure({ theme, scheme }) y variables --nd-* |
Qué cambia a propósito
- Botones: Cancelar, Denegar, Confirmar, en ese orden; una confirmación que dice «eliminar» o «borrar» pasa sola a peligro, con el foco en Cancelar.
- Colores y clases:
confirmButtonColorycustomClassse ignoran; los colores vienen del tema. - El contenido vive en un Shadow DOM: en lugar de
document.getElementById('x')usaSwal.getHtmlContainer().querySelector('#x'). Tu CSS ya no lo rompe. htmlse muestra como texto (desde la 0.5.0): SweetAlert2 lo interpreta; aquí hace faltaconfigure({ strictHtml: false })si es contenido tuyo, oconfigure({ sanitize })si no lo es. Es la única línea que suele hacer falta al migrar.- Idioma: los textos por omisión salen en el idioma configurado («Aceptar», «Cancelar»).
- Sin equivalente:
Swal.version,topLayer,showClass/hideClassyanimation.
Diferencias de comportamiento que conviene revisar
Una API compatible no quiere decir que todo sea intercambiable. Estas son las diferencias que afectan a código que ya funciona.
| Con SweetAlert2 | Con nexus-dialogs/swal | Qué hacer |
|---|---|---|
footer acepta HTML | El pie se muestra como texto plano (las etiquetas se quitan). | Pon el enlace o formato dentro de html. |
html en cadena se interpreta | Se muestra como texto por omisión (strictHtml). Ver Seguridad. | configure({ strictHtml: false }) con contenido tuyo, o configure({ sanitize }) si no lo es. |
El contenido está en el document | Está dentro de un Shadow DOM: document.getElementById no lo encuentra. | Usa Swal.getHtmlContainer().querySelector(…). |
CSS de la página (Bootstrap, .swal2-*) cambia su aspecto | El CSS de la página ya no entra; el aspecto sale del tema. | Usa configure({ theme }) o un tema listo. |
confirmButtonColor, customClass, background, backdrop… | Se aceptan y se ignoran. | Quita esas opciones; un color por intención. |
| Orden y foco de los botones libres | Siempre Cancelar, Denegar, Confirmar; un botón «eliminar» pasa solo a peligro y el foco empieza en Cancelar. | Revisa los borrados; fuerza con danger: true o reverseButtons. |
| Textos por omisión en inglés | Salen en el idioma configurado. | configure({ lang }) o labels. |
| Toasts con posiciones y apilado propios | Usan la cola de nexus-dialogs/toast, una sola posición para todos. | Revisa dónde esperabas verlos. |
showClass, hideClass, animation, topLayer, Swal.version | No existen. | El movimiento sale del tema y respeta «reducir movimiento». |
template con <swal-function-param> | No se acepta. | Pasa la función por opciones. |
Lista de verificación
- Instala
nexus-dialogsy cambia el import (o el<script>). - Si usas
html, agrega una vezconfigure({ strictHtml: false })(contenido tuyo) oconfigure({ sanitize })(contenido de fuera). - Busca en tu código
document.getElementByIdoquerySelectordentro dehtml:ydidOpen; cámbialos porSwal.getHtmlContainer(). - Quita
customClassyconfirmButtonColor; configura un tema una sola vez conconfigure. - Revisa los diálogos de borrado: ahora el foco empieza en «Cancelar».
- Migra primero lo que más se repite (borrar, guardar, formularios) a las recetas y a
form. - Prueba con teclado: Tab, Esc y regreso del foco al botón que abrió el diálogo.
¿Falta algo? La lista completa de lo que cubre el adaptador está en la Guía.