#ctx.modal

Una API de acceso rápido basada en Ant Design Modal, utilizada para abrir activamente cuadros modales (avisos de información, ventanas emergentes de confirmación, etc.) en RunJS. Es implementada por ctx.viewer / el sistema de vistas.

#Escenarios de uso

Nota: ctx.modal está disponible en entornos RunJS con un contexto de vista (como JSBlocks dentro de una página, flujos de trabajo, etc.); es posible que no exista en el backend o en contextos sin interfaz de usuario (UI). Se recomienda utilizar el encadenamiento opcional (ctx.modal?.confirm?.()) al llamarlo.

#Definición de tipos

modal: {
  info: (config: ModalConfig) => Promise<void>;
  success: (config: ModalConfig) => Promise<void>;
  error: (config: ModalConfig) => Promise<void>;
  warning: (config: ModalConfig) => Promise<void>;
  confirm: (config: ModalConfig) => Promise<boolean>;  // Devuelve true si el usuario hace clic en Aceptar, false si cancela
};

ModalConfig es consistente con la configuración de los métodos estáticos de Modal en Ant Design.

#Métodos comunes

#Parámetros de configuración

Consistente con Modal de Ant Design, los campos comunes incluyen:

#Relación con ctx.message y ctx.openView

#Ejemplos

#Modal de información simple

ctx.modal.info({
  title: 'Aviso',
  content: 'Operación completada',
});

#Modal de confirmación y control de flujo

const confirmed = await ctx.modal.confirm({
  title: 'Confirmar eliminación',
  content: '¿Está seguro de que desea eliminar este registro?',
  okText: 'Confirmar',
  cancelText: 'Cancelar',
});
if (!confirmed) {
  ctx.exit();  // Termina los pasos posteriores si el usuario cancela
  return;
}
await ctx.runAction('destroy', { filterByTk: ctx.record?.id });

#Modal de confirmación con onOk

await ctx.modal.confirm({
  title: 'Confirmar envío',
  content: 'Los cambios no podrán modificarse después del envío. ¿Desea continuar?',
  async onOk() {
    await ctx.form.submit();
  },
});

#Aviso de error

try {
  await someOperation();
  ctx.modal.success({ title: 'Éxito', content: 'Operación completada' });
} catch (e) {
  ctx.modal.error({ title: 'Error', content: e.message });
}

#Relacionado

• ctx.message: Aviso temporal ligero, desaparece automáticamente.
• ctx.exit(): Comúnmente utilizado como if (!confirmed) ctx.exit() para terminar el flujo cuando un usuario cancela la confirmación.
• ctx.openView(): Abre una vista personalizada, adecuada para interacciones complejas.