Zum Hauptinhalt springen

Event Options

ChatGPT öffnen
Java API

ElementEventOptions ist ein vielseitiges webforJ-Tool, das entwickelt wurde, um Konfigurationseinstellungen für Element-Ereignisse innerhalb von webforJ-Anwendungen zu kapseln und zu verwalten. Als Container für verschiedene Optionen ermöglicht es Entwicklern, präzise festzulegen, wie Ereignisse, die mit Elementen verbunden sind, verarbeitet werden sollen.

Ereignisdaten

Ereignisdaten sind eine Schlüsselkomponente von ElementEventOptions, die es Entwicklern ermöglichen, spezifische Informationen an die Ereignisoptionen anzuhängen. Diese Funktionalität erleichtert das Übermitteln von benutzerdefinierten Daten vom Client zum Server, wenn ein Ereignis ausgelöst wird. Diese Fähigkeit ist entscheidend, um zusätzlichen Kontext oder Parameter, die mit dem Ereignis verbunden sind, zu übermitteln und ermöglicht es, Informationen zu nutzen, ohne dass zusätzliche Anfragen an den Client gemacht werden müssen.

Betrachten Sie beispielsweise ein Szenario, in dem Sie ein Klickereignis eines Buttons haben und den aktuellen Benutzernamen des Benutzers zusammen mit dem Ereignis übermitteln möchten. Anstatt den Benutzernamen jedes Mal vom Client abzufragen, senden Sie diese Informationen zusammen mit dem Ereignis als Daten.

Info

Für weitere Informationen, siehe die Seiten Ereignisse und Client/Server-Interaktion.

Um Daten zu den Ereignisoptionen hinzuzufügen, können Sie die Methode addData() verwenden.

Ausführen von JavaScript

Die Klasse ElementEventOptions ermöglicht es Entwicklern, JavaScript-Code zu spezifizieren, der auf der Client-Seite evaluiert werden soll, bevor das zugehörige Ereignis ausgelöst wird. Diese Funktion ermöglicht es den Clients, Ereignisdaten vorzubereiten oder zusätzliche Ereignisse nach Bedarf auszulösen. Dies ist in vielen Fällen hilfreich, zum Beispiel, wenn Formulardaten auf der Client-Seite validiert werden sollen, bevor sie über ein Formulareignis gesendet werden.

Verwendung

Um den Ereigniscode festzulegen, verwenden Sie die Methode setCode().

Filtern von Ereignissen

ElementEventOptions enthält eine Funktion zum Festlegen eines Filterausdrucks, der auf dem Client vor dem Auslösen des Ereignisses ausgewertet wird. Dieser Filterausdruck ermöglicht es dem Client zu bestimmen, ob das Ereignis fortgesetzt oder gestoppt werden soll, basierend auf bestimmten Bedingungen. Betrachten Sie ein Eingabefeld, bei dem Sie ein Ereignis nur auslösen möchten, wenn der eingegebene Text bestimmten Kriterien entspricht, z. B. einer Mindestlänge.

Verwendung

Um den Ereignisfilter festzulegen, verwenden Sie die Methode setFilter().

Debouncing und Throttling

Zweck

ElementEventOptions bietet Mechanismen zum Debouncing und Throttling von Ereignissen. Diese Funktionen sind nützlich, um die Häufigkeit von Ereignis-Listenern zu steuern und sicherzustellen, dass sie nur unter bestimmten Bedingungen ausgelöst werden.

Verwendung

  • Um Debounce festzulegen, verwenden Sie die Methode setDebounce.
  • Um Throttle festzulegen, verwenden Sie die Methode setThrottle.

Beispiel

In Szenarien, in denen Sie rasches Benutzereingaben, wie zum Beispiel bei Suchfeldern, behandeln möchten, können Sie Debounce verwenden, um die Ausführung zu verzögern, bis der Benutzer mit dem Tippen fertig ist.

Zusammenführen von Ereignisoptionen

Die Klasse ElementEventOptions unterstützt das Zusammenführen mit anderen Instanzen, sodass Entwickler verschiedene Optionen aggregieren können. Diese Funktion ist hilfreich, wenn Einstellungen aus verschiedenen Quellen kombiniert werden.

Anmerkungen

Zweck

Zur Vereinfachung kann ElementEventOptions mithilfe von Anmerkungen konfiguriert werden. Diese Anmerkungen bieten eine prägnantere und ausdrucksstarke Möglichkeit, Ereignisoptionen festzulegen.

Beispiel

Betrachten Sie das folgende Beispiel einer Anmerkung:

@EventOptions(data = {@EventData(key = "value", exp = "component.value")}, 
debounce = @DebounceSettings(value = 200))