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.makeResource()
Next Pagectx.modal
KI-Übersetzungshinweis

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

#ctx.message

Ant Design globale message API, zur Anzeige von temporären Kurzhinweisen in der oberen Mitte der Seite. Nachrichten werden nach einer bestimmten Zeit automatisch geschlossen oder können manuell vom Benutzer geschlossen werden.

#Anwendungsbereiche

SzenarioBeschreibung
JSBlock / JSField / JSItem / JSColumnFeedback zu Operationen, Validierungshinweise, Kopiererfolg und andere Kurzhinweise
Formularoperationen / WorkflowFeedback für erfolgreiches Absenden, Speicherfehler, fehlgeschlagene Validierung usw.
Aktionsereignisse (JSAction)Sofortiges Feedback für Klicks, Abschluss von Stapelverarbeitungen usw.

#Typdefinition

message: MessageInstance;

MessageInstance ist die Ant Design message-Schnittstelle, die die folgenden Methoden bereitstellt.

#Häufige Methoden

MethodeBeschreibung
success(content, duration?)Zeigt einen Erfolgshinweis an
error(content, duration?)Zeigt einen Fehlerhinweis an
warning(content, duration?)Zeigt einen Warnhinweis an
info(content, duration?)Zeigt einen Informationshinweis an
loading(content, duration?)Zeigt einen Ladehinweis an (muss manuell geschlossen werden)
open(config)Öffnet eine Nachricht mit benutzerdefinierter Konfiguration
destroy()Schließt alle aktuell angezeigten Nachrichten

Parameter:

  • content (string | ConfigOptions): Nachrichtentext oder Konfigurationsobjekt
  • duration (number, optional): Verzögerung für automatisches Schließen (Sekunden), Standard ist 3 Sekunden; der Wert 0 bedeutet kein automatisches Schließen

ConfigOptions (wenn content ein Objekt ist):

interface ConfigOptions {
  content: React.ReactNode;  // Nachrichtentext
  duration?: number;        // Verzögerung für automatisches Schließen (Sekunden)
  onClose?: () => void;    // Callback beim Schließen
  icon?: React.ReactNode;  // Benutzerdefiniertes Symbol
}

#Beispiele

#Grundlegende Verwendung

ctx.message.success('Operation erfolgreich');
ctx.message.error('Operation fehlgeschlagen');
ctx.message.warning('Bitte wählen Sie zuerst Daten aus');
ctx.message.info('Wird verarbeitet...');

#Internationalisierung mit ctx.t

ctx.message.success(ctx.t('Copied'));
ctx.message.warning(ctx.t('Please select at least one row'));
ctx.message.success(ctx.t('Exported {{count}} records', { count: rows.length }));

#Loading und manuelles Schließen

const hide = ctx.message.loading(ctx.t('Saving...'));
// Asynchrone Operation ausführen
await saveData();
hide();  // Ladehinweis manuell schließen
ctx.message.success(ctx.t('Saved'));

#Benutzerdefinierte Konfiguration mit open

ctx.message.open({
  type: 'success',
  content: 'Benutzerdefinierter Erfolgshinweis',
  duration: 5,
  onClose: () => console.log('message closed'),
});

#Alle Nachrichten schließen

ctx.message.destroy();

#Unterschied zwischen ctx.message und ctx.notification

Merkmalctx.messagectx.notification
PositionObere Mitte der SeiteRechte obere Ecke
ZweckTemporärer Kurzhinweis, verschwindet automatischBenachrichtigungs-Panel, kann Titel und Beschreibung enthalten, geeignet für längere Anzeige
Typische SzenarienFeedback zu Operationen, Validierungshinweise, KopiererfolgBenachrichtigungen über Aufgabenabschluss, Systemnachrichten, längere Inhalte, die Aufmerksamkeit erfordern

#Verwandte Themen

  • ctx.notification - Benachrichtigungen oben rechts, geeignet für längere Anzeigedauer
  • ctx.modal - Modal-Bestätigung, blockierende Interaktion
  • ctx.t() - Internationalisierung, wird häufig zusammen mit message verwendet