Modal(options: ModalOptions): ModalInstance
| Opción | Tipo · Defecto | Descripción |
|---|---|---|
| titlev2.0.6+ | string defecto: '' |
Texto mostrado en la barra de título superior de la ventana modal. |
| draggablev2.0.6+ | boolean defecto: false |
Permite arrastrar la ventana desde su barra de título respetando los límites del viewport. |
| windowModev2.0.6+ | boolean defecto: false |
Abre el modal sin overlay de fondo y habilita múltiples ventanas simultáneas con apilamiento z-index. |
| hideWhenClickOverlayopcional | boolean defecto: false |
Cierra el modal clásico al pulsar sobre el fondo semitransparente. |
| positionopcional | { x: number, y: number } defecto: centrado |
Coordenadas iniciales personalizadas de la ventana en el viewport. |
| resizable / classNameopcional | boolean / string defecto: false / '' |
Habilita redimensionado de ventana o añade clases CSS adicionales al contenedor. |
Modales clásicos y modo ventana (v2.0.6+)
Modal() reutiliza la misma sintaxis de controller + render() que Component, añadiendo el método this.close(...args) en el controlador.
- Overlay tradicional: bloquea el fondo y cierra al hacer clic fuera si
hideWhenClickOverlay: true. - Modo ventana (
windowMode: true): elimina el overlay, permite abrir varias ventanas a la vez y trae al frente la ventana pulsada. - Arrastre inteligente (
draggable: true): restringe el movimiento al viewport y desactiva el arrastre en pantallas táctiles pequeñas.
import { Modal } from '@pablotheblink/scopejs';
Modal({
title: 'Editar usuario',
draggable: true,
windowMode: true,
position: { x: 100, y: 80 },
controller: class {
constructor() { this.name = ''; }
save() { this.close(this.name); }
},
render() {
return `<input model="name" /><button onclick="save()">Guardar</button>`;
}
});