Alertas, Toasts y Modales con Promesas para Tailwind CSS
Librería ultraligera diseñada para la web moderna. Manejo seguro de errores, protección nativa contra XSS, animaciones a 60 FPS, soporte de async/await y estilo visual oscuro nativo.
Configurador Interactivo
Personaliza y dispara cualquier tipo de alerta en tiempo real.
// Configurando...
¿Por qué Alertwind v1.0?
- ✓ Seguridad contra XSS: Sanitización de contenido por defecto para evitar inyecciones.
-
✓
Basado en Promesas: Usa
const ok = await Alertwind.confirm(...)sin callbacks confusos. - ✓ Zero Dependencies: Funciona con o sin Tailwind en cualquier proyecto HTML o SPA.
- ✓ Pausa en Hover: Si el usuario pasa el cursor sobre el toast, la cuenta regresiva se congela.
Casos de Uso del Mundo Real
Guardado con Éxito
Ideal para formularios, compras o confirmaciones de guardado.
Eliminación Crítica (Confirm)
Modal con promesa para validar antes de borrar un recurso.
Banner Superior de Estado
Notificación fija arriba para mantenimiento o nuevas versiones.
Integra Alertwind en Cualquier Proyecto
Cero dependencias externas. Compatible con HTML puro, PHP/Laravel, WordPress, React, Next.js, Vue, Svelte y Astro.
CDN / Script Tag
Pégalo justo antes de cerrar la etiqueta </body> en tu HTML o plantilla Blade/PHP.
<!-- Alertwind Core v1.0 -->
<script src="https://tocinocode.com/generator/Alertwind/Alertwind.min.js"></script>
<script>
Alertwind.toast({
title: '¡Bienvenido!',
message: 'Alertwind cargado exitosamente',
type: 'success'
});
</script>
Descarga Local (.js)
Descarga el archivo y colócalo en tu carpeta /js/ o /assets/.
<script src="/js/Alertwind.min.js"></script>
<script>
// Disponible globalmente en window.Alertwind
Alertwind.toast({ title: 'Modo Offline', message: 'Sin peticiones externas' });
</script>
ES Modules / Frameworks
Importación directa para código modular y arquitectura orientada a componentes.
import Alertwind from './Alertwind.js';
// Diálogos con Promesas nativas (async / await)
const borrar = await Alertwind.confirm({
title: '¿Confirmar eliminación?',
message: 'Esta acción no se puede deshacer.',
type: 'error'
});
if (borrar) {
// Lógica de borrado...
}
Next.js App Router (SSR)
Ideal si requieres importar la librería dinámicamente solo en el cliente (SSR-safe).
'use client';
async function notificar() {
const { default: Alertwind } = await import('@/lib/Alertwind.js');
Alertwind.toast({
title: 'Sincronizado',
message: 'Seguro en Next.js App Router',
type: 'success'
});
}
Parámetros y Opciones Configurables
Cada método de Alertwind acepta un objeto con las siguientes opciones para personalizar su apariencia y comportamiento:
| Parámetro | Tipo | Por Defecto | Métodos Compatibles | Descripción |
|---|---|---|---|---|
| title | string | '' | toast, confirm, alert, prompt | Título destacado del mensaje o diálogo. |
| message | string | '' | Todos | Cuerpo del texto principal (sanitizado contra ataques XSS). |
| type | 'success' | 'error' | 'warning' | 'info' | 'brand' | 'info' | Todos | Define la paleta de color, estilo de barra y el icono SVG asociado. |
| position | 'top-right' | 'top-left' | 'top-center' | 'bottom-right' | 'bottom-left' | 'bottom-center' | 'top-right' | toast | Ubicación física en pantalla donde se apilan las notificaciones. |
| duration | number (ms) | 3500 | toast | Tiempo antes del auto-cierre. Usa 0 para mantenerlo fijo hasta clic. |
| showProgress | boolean | true | toast | Muestra la barra de progreso animada que se congela automáticamente al pausar el cursor sobre el toast. |
| sound | boolean | false | Todos | Reproduce una nota sintetizada suave mediante Web Audio API nativo. |
| confirmText | string | 'Confirmar' | confirm, alert, prompt | Texto del botón principal de confirmación. |
| cancelText | string | 'Cancelar' | confirm, prompt | Texto del botón de cancelación. |
| placeholder | string | '' | prompt | Texto de ayuda dentro del input de texto. |
| onClose | () => void | null | toast | Callback disparado inmediatamente después de que el toast desaparece. |
| Alertwind.dismissAll() | function | - | Global | Método estático para cerrar instantáneamente todas las alertas y toasts en pantalla. |
¿Necesitas un sistema empresarial o arquitectura de software completa?
Diseñamos soluciones personalizadas que responden con precisión a tus operaciones: plataformas web de alta disponibilidad, aplicaciones móviles y apps de Smart TV.