#ctx.modal

Eine auf Ant Design Modal basierende Shortcut-API, die verwendet wird, um in RunJS aktiv Modal-Fenster (Informationshinweise, Bestätigungs-Popups usw.) zu öffnen. Sie wird durch ctx.viewer / das Ansichtssystem implementiert.

#Anwendungsfälle

Hinweis: ctx.modal ist in RunJS-Umgebungen mit einem Ansichtskontext verfügbar (z. B. JS-Blöcke innerhalb einer Seite, Workflows usw.); in Backend- oder Nicht-UI-Kontexten existiert es möglicherweise nicht. Es wird empfohlen, beim Aufruf die optionale Verkettung (ctx.modal?.confirm?.()) zu verwenden.

#Typdefinition

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>;  // Gibt true zurück, wenn der Benutzer auf OK klickt, false beim Abbrechen
};

ModalConfig entspricht der Konfiguration der statischen Methoden von Ant Design Modal.

#Gängige Methoden

#Konfigurationsparameter

Konsistent mit Ant Design Modal, zu den gängigen Feldern gehören:

#Beziehung zu ctx.message und ctx.openView

#Beispiele

#Einfaches Informations-Modal

ctx.modal.info({
  title: 'Hinweis',
  content: 'Vorgang abgeschlossen',
});

#Bestätigungs-Modal und Ablaufsteuerung

const confirmed = await ctx.modal.confirm({
  title: 'Löschen bestätigen',
  content: 'Sind Sie sicher, dass Sie diesen Datensatz löschen möchten?',
  okText: 'Bestätigen',
  cancelText: 'Abbrechen',
});
if (!confirmed) {
  ctx.exit();  // Beendet nachfolgende Schritte, wenn der Benutzer abbricht
  return;
}
await ctx.runAction('destroy', { filterByTk: ctx.record?.id });

#Bestätigungs-Modal mit onOk

await ctx.modal.confirm({
  title: 'Einreichung bestätigen',
  content: 'Änderungen können nach dem Absenden nicht mehr bearbeitet werden. Möchten Sie fortfahren?',
  async onOk() {
    await ctx.form.submit();
  },
});

#Fehlermeldung

try {
  await someOperation();
  ctx.modal.success({ title: 'Erfolg', content: 'Vorgang abgeschlossen' });
} catch (e) {
  ctx.modal.error({ title: 'Fehler', content: e.message });
}

#Verwandte Themen

• ctx.message: Leichtgewichtiger temporärer Hinweis, verschwindet automatisch
• ctx.exit(): Wird häufig als if (!confirmed) ctx.exit() verwendet, um den Ablauf zu beenden, wenn ein Benutzer die Bestätigung abbricht
• ctx.openView(): Öffnet eine benutzerdefinierte Ansicht, geeignet für komplexe Interaktionen