Saltar al contenido
nexus-dialogs
GitHub npm

Compatibilidad con SweetAlert2

Qué parte de SweetAlert2 cubre nexus-dialogs/swal y qué no. La compatibilidad no es absoluta ni se pretende: es una puerta para migrar poco a poco hacia la API propia. Esta tabla se verifica en cada cambio (test/unit/swal-matriz.test.ts): si el adaptador reconoce un parámetro que no está aquí, o uno «compatible» no tiene prueba, el CI falla.

#Qué significa cada estado

EstadoSignificado
compatibleHace lo mismo que en SweetAlert2 y tiene una prueba.
parcialFunciona con una limitación o una diferencia (ver la nota).
ignoradoSe acepta para que tu código no falle, pero no tiene efecto: el aspecto lo decide el estándar de botones y el tema.
sin soporteSe acepta y no hace nada porque no tiene equivalente.

#Parámetros

ParámetroEstadoNota
titlecompatible
titleTextcompatible
textcompatible
htmlparcialSe muestra como texto por omisión (strictHtml); con contenido propio, configure({ strictHtml: false }) (sin bundler, Swal.configure(…)).
iconcompatible
footerparcialSe muestra como texto plano: las etiquetas se quitan.
toastparcialUsa la cola de nexus-dialogs/toast; no admite todos los parámetros de un diálogo.
positionparcialSolo para toasts, y cambia la posición de todos los toasts (la cola es una sola).
widthparcialSolo números y px; con otras unidades se usa el ancho estándar.
timercompatible
timerProgressBarcompatible
showConfirmButtoncompatible
showDenyButtoncompatible
showCancelButtoncompatible
showCloseButtoncompatible
confirmButtonTextcompatible
denyButtonTextcompatible
cancelButtonTextcompatible
focusCancelcompatible
focusDenycompatible
allowOutsideClickcompatible
allowEscapeKeycompatible
inputcompatible
inputLabelcompatible
inputPlaceholdercompatible
inputValuecompatible
inputOptionscompatible
inputAttributescompatible
inputValidatorcompatible
validationMessagecompatible
preConfirmcompatible
preDenycompatible
willOpencompatible
didOpencompatible
didRendercompatible
willClosecompatible
didClosecompatible
didDestroycompatible
iconHtmlparcialPasa por sanitize / strictHtml como html.
imageUrlcompatible
imageWidthcompatible
imageHeightcompatible
imageAltcompatible
progressStepscompatible
currentProgressStepcompatible
progressStepsDistancecompatible
closeButtonHtmlparcialPasa por sanitize / strictHtml como html.
closeButtonAriaLabelcompatible
confirmButtonAriaLabelcompatible
denyButtonAriaLabelcompatible
cancelButtonAriaLabelcompatible
reverseButtonscompatible
allowEnterKeycompatible
inputAutoFocuscompatible
inputAutoTrimcompatible
returnInputValueOnDenycompatible
targetparcialMonta el diálogo en ese elemento, pero sigue siendo modal y en la capa superior.
themeparcialEntiende light, dark y auto; los temas de la librería se eligen con configure({ theme }).
templateparcialLee <swal-title>, <swal-html>, <swal-icon>, <swal-image>, <swal-input>, <swal-button>, <swal-footer> y <swal-param>; no acepta <swal-function-param>.
draggablecompatible
confirmButtonColorignoradoLos colores salen del estándar de botones y del tema.
denyButtonColorignoradoIgual que confirmButtonColor.
cancelButtonColorignoradoIgual que confirmButtonColor.
buttonsStylingignoradoLos botones siempre llevan el estilo estándar.
customClassignoradoEl contenido vive en un Shadow DOM: las clases de tu CSS no llegan. Usa temas.
backgroundignoradoUsa configure({ theme }).
colorignoradoUsa configure({ theme }).
paddingignoradoEl espaciado es el del tema.
iconColorignoradoEl color del icono depende del tipo.
backdropignoradoEl fondo siempre es el del navegador (<dialog> modal).
growignoradoLos tamaños son size o width.
animationsin soporteEl movimiento sale del tema y respeta «reducir movimiento».
showClasssin soporteIgual que animation.
hideClasssin soporteIgual que animation.
heightAutoignoradoNo hace falta: el diálogo no altera la altura de la página.
scrollbarPaddingignoradoLa librería compensa la barra de desplazamiento sola.
topLayersin soporteSiempre está en la capa superior del navegador.
stopKeydownPropagationignoradoNo se detiene la propagación del teclado.
keydownListenerCaptureignoradoLos eventos de teclado no se capturan en la fase de captura.
showLoaderOnConfirmignoradoCon preConfirm async el indicador de «procesando» siempre se muestra.
showLoaderOnDenyignoradoCon preDeny async el indicador de «procesando» siempre se muestra.
focusConfirmignoradoEl foco inicial lo decide la librería (en acciones destructivas, Cancelar).
returnFocusignoradoAl cerrar, el foco siempre vuelve al elemento que abrió el diálogo.
loaderHtmlparcialPasa por sanitize / strictHtml como html.

#Métodos y accesores

Compatibles: Swal.fire, mixin, close, update, isVisible, showLoading, hideLoading, isLoading, getLoader, showValidationMessage, resetValidationMessage, enableButtons, disableButtons, enableInput, disableInput, clickConfirm, clickDeny, clickCancel, los accesores (getPopup, getContainer, getTitle, getHtmlContainer, getIcon, getImage, getInput, getActions, getFooter, getCloseButton, getTimerProgressBar, getProgressSteps, getFocusableElements…), los temporizadores (stopTimer, resumeTimer, toggleTimer, increaseTimer, getTimerLeft, isTimerRunning), argsToParams, isValidParameter, isUpdatableParameter, bindClickHandler y DismissReason.

Sin equivalente: Swal.version.

#Diferencias intencionales

Guía de migración con ejemplos que se ejecutan: migracion.html.