logologo
Start
Handbuch
Entwicklung
Plugins
API
Startseite
English
简体中文
日本語
한국어
Español
Português
Deutsch
Français
Русский
Start
Handbuch
Entwicklung
Plugins
API
Startseite
logologo
RunJS Übersicht
Module importieren
Rendern im Container

Globale Variablen

window
document
navigator

ctx

ctx.blockModel
ctx.collection
ctx.collectionField
ctx.dataSource
ctx.dataSourceManager
ctx.element
ctx.exit()
ctx.exitAll()
ctx.filterManager
ctx.form
ctx.getModel()
ctx.getValue()
ctx.getVar()
ctx.i18n
ctx.importAsync()
ctx.initResource()
ctx.libs
ctx.location
ctx.logger
ctx.makeResource()
ctx.message
ctx.modal
ctx.model
ctx.notification
ctx.off()
ctx.on()
ctx.openView()
ctx.render()
ctx.request()
ctx.requireAsync()
ctx.resource
ctx.route
ctx.router
ctx.setValue()
ctx.sql
ctx.t()
ctx.view
Previous Pagectx.model
Next Pagectx.off()
KI-Übersetzungshinweis

Dieses Dokument wurde von KI übersetzt. Für genaue Informationen lesen Sie bitte die englische Version.

#ctx.notification

Basierend auf der Ant Design Notification ist dies eine globale Benachrichtigungs-API, die verwendet wird, um Benachrichtigungs-Panels in der oberen rechten Ecke der Seite anzuzeigen. Im Vergleich zu ctx.message können Benachrichtigungen einen Titel und eine Beschreibung enthalten, wodurch sie sich für Inhalte eignen, die über einen längeren Zeitraum angezeigt werden sollen oder die Aufmerksamkeit der Benutzer erfordern.

#Anwendungsfälle

SzenarioBeschreibung
JSBlock / AktionsereignisseBenachrichtigungen über den Abschluss von Aufgaben, Ergebnisse von Stapelverarbeitungen, Abschluss von Exporten usw.
Workflow (FlowEngine)Systemweite Warnungen nach dem Ende asynchroner Prozesse.
Inhalte, die eine längere Anzeige erfordernVollständige Benachrichtigungen mit Titeln, Beschreibungen und Aktionsschaltflächen.

#Typdefinition

notification: NotificationInstance;

NotificationInstance ist das Ant Design Notification-Interface, das die folgenden Methoden bereitstellt.

#Gängige Methoden

MethodeBeschreibung
open(config)Öffnet eine Benachrichtigung mit benutzerdefinierter Konfiguration
success(config)Zeigt eine Benachrichtigung vom Typ "Erfolg" an
info(config)Zeigt eine Benachrichtigung vom Typ "Information" an
warning(config)Zeigt eine Benachrichtigung vom Typ "Warnung" an
error(config)Zeigt eine Benachrichtigung vom Typ "Fehler" an
destroy(key?)Schließt die Benachrichtigung mit dem angegebenen Schlüssel (Key); wird kein Key übergeben, werden alle geschlossen

Konfigurationsparameter (konsistent mit Ant Design notification):

ParameterTypBeschreibung
messageReactNodeTitel der Benachrichtigung
descriptionReactNodeBeschreibung der Benachrichtigung
durationnumberVerzögerung für das automatische Schließen (Sekunden). Standard ist 4,5 Sekunden; auf 0 setzen, um das automatische Schließen zu deaktivieren
keystringEindeutige Kennung der Benachrichtigung, wird für destroy(key) zum Schließen einer bestimmten Benachrichtigung verwendet
onClose() => voidCallback-Funktion beim Schließen
placementstringPosition: topLeft | topRight | bottomLeft | bottomRight

#Beispiele

#Grundlegende Verwendung

ctx.notification.open({
  message: 'Vorgang erfolgreich',
  description: 'Die Daten wurden auf dem Server gespeichert.',
});

#Schnellaufrufe nach Typ

ctx.notification.success({
  message: ctx.t('Export completed'),
  description: ctx.t('Exported {{count}} records', { count: 10 }),
});

ctx.notification.error({
  message: ctx.t('Export failed'),
  description: ctx.t('Please check the console for details'),
});

ctx.notification.warning({
  message: ctx.t('Warning'),
  description: ctx.t('Some data may be incomplete'),
});

#Benutzerdefinierte Dauer und Key

ctx.notification.open({
  key: 'task-123',
  message: ctx.t('Task in progress'),
  description: ctx.t('Please wait...'),
  duration: 0,  // Schließt nicht automatisch
});

// Nach Abschluss der Aufgabe manuell schließen
ctx.notification.destroy('task-123');

#Alle Benachrichtigungen schließen

ctx.notification.destroy();

#Unterschied zu ctx.message

Merkmalctx.messagectx.notification
PositionOben in der Mitte der SeiteObere rechte Ecke (konfigurierbar)
StrukturEinzeiliger kurzer HinweisKann Titel + Beschreibung enthalten
ZweckTemporäres Feedback, verschwindet automatischVollständigere Benachrichtigung, kann lange angezeigt werden
Typische SzenarienErfolg einer Operation, Validierungsfehler, Kopieren erfolgreichAufgabenabschluss, Systemmeldungen, längere Inhalte, die Aufmerksamkeit erfordern

#Verwandte Themen

  • ctx.message - Kurzer Hinweis oben, geeignet für schnelles Feedback
  • ctx.modal - Modal-Bestätigung, blockierende Interaktion
  • ctx.t() - Internationalisierung, wird häufig zusammen mit Benachrichtigungen verwendet