ScopeJS v2.0.8
Ventanas emergentes

Modales y ventanas Modal(options)

Lanza modales clásicos con overlay o múltiples ventanas arrastrables simultáneas con barra de título y apilamiento automático.

types/index.d.ts
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>`;
  }
});