Modales y Overlays

Modal

Un componente modal base que provee backdrop, transiciones y bloqueo de scroll. Tú proporcionas el contenido.
Tests
100%

Uso

SModal es un modal de bajo nivel que teletransporta contenido al body con un overlay de backdrop, transiciones de fade/slide y bloqueo automático de scroll. No incluye contenido estilizado — tú proporcionas tu propia tarjeta, formulario o layout dentro.

Usa v-model:open o :open + @update:open para controlar la visibilidad.

Responsive

Por defecto, responsive está en true. En móvil, el contenido del modal se posiciona en la parte inferior de la pantalla. En pantallas más grandes (breakpoint sm en adelante), se centra verticalmente. Establece responsive en false para centrar siempre el contenido.

Posicion

Usa la prop position para controlar la ubicacion vertical del modal en la pantalla. Los valores disponibles son top, nearTop, center y bottom. Cuando responsive esta en true, la posicion solo aplica en escritorio — en movil, el modal siempre se desliza desde abajo.

Prevenir Cierre

Cuando preventClose está habilitado, hacer clic en el backdrop no cierra el modal. El usuario debe cerrarlo mediante una acción explícita, como un botón de cerrar dentro del contenido.

Props

PropTipoDefaultDescripción
openboolean-Controla la visibilidad del modal
position'top' | 'nearTop' | 'center' | 'bottom'-Posicion vertical del modal en la pantalla
responsivebooleantrueCuando es true, posiciona el contenido en la parte inferior en movil y centrado en escritorio
preventClosebooleanfalsePreviene que el modal se cierre al hacer clic en el backdrop

Eventos

EventoPayloadDescripción
update:openbooleanSe emite cuando el modal solicita cerrarse (clic en backdrop)
close-Se emite cuando el modal solicita cerrarse (deprecado, usar update:open)

Slots

NombreDescripción
defaultContenido del modal. Debes proporcionar tu propio contenedor estilizado (tarjeta, panel, etc.)
Copyright © 2026