Event Options
ElementEventOptions is een veelzijdige webforJ-hulpmiddel ontworpen om configuratie-instellingen voor Element-gebeurtenissen binnen webforJ-toepassingen in te kapselen en te beheren. Als een container voor verschillende opties stelt het ontwikkelaars in staat om nauwkeurig te bepalen hoe gebeurtenissen die zijn gekoppeld aan elementen moeten worden verwerkt.
Gegevens van evenementen
Gegevens van evenementen zijn een belangrijke functie van ElementEventOptions, waarmee ontwikkelaars specifieke informatie aan de evenementopties kunnen koppelen. Deze functionaliteit vergemakkelijkt het doorgeven van aangepaste gegevens van de client naar de server wanneer een evenement wordt geactiveerd. Deze mogelijkheid is van cruciaal belang voor het overbrengen van extra context of parameters die aan het evenement zijn gekoppeld en maakt het mogelijk om informatie te verkrijgen en te gebruiken zonder dat extra verzoeken naar de client hoeven te worden gedaan.
Bijvoorbeeld, beschouw een scenario waarin u een knopklikgebeurtenis heeft, en u wilt de gebruikersnaam van de huidige gebruiker doorgeven samen met het evenement. In plaats van elke keer de gebruikersnaam van de client op te vragen, stuurt u deze informatie samen met het evenement als gegevens.
Voor meer informatie, zie de events en Client/Server Interaction pagina's.
Om gegevens aan de evenementopties toe te voegen, kunt u de addData()-methode gebruiken.
JavaScript uitvoeren
De ElementEventOptions-klasse stelt ontwikkelaars in staat om JavaScript-code op te geven die aan de clientzijde moet worden geëvalueerd voordat het bijbehorende evenement wordt geactiveerd. Deze functie stelt clients in staat om evenementgegevens voor te bereiden of extra evenementen te triggeren indien nodig. Dit is in veel gevallen nuttig, bijvoorbeeld wanneer u formuliergegevens aan de clientzijde wilt valideren voordat u deze indient via een formulierindieningsevenement.
Gebruik
Om de evenementcode in te stellen, gebruikt u de setCode()-methode.
Evenementen filteren
ElementEventOptions bevat een functie voor het instellen van een filterexpressie die aan de clientzijde moet worden geëvalueerd voordat het evenement wordt geactiveerd. Deze filterexpressie stelt de client in staat om te bepalen of het evenement moet doorgaan of moet worden gestopt op basis van bepaalde voorwaarden. Overweeg een invoerveld waar u een evenement alleen wilt triggeren als de ingevoerde tekst aan specifieke criteria voldoet, zoals een minimale lengte.
Gebruik
Om de evenementfilter in te stellen, gebruikt u de setFilter()-methode.
Debouncing en throttling
Doel
ElementEventOptions biedt mechanismen voor het debouncen en throttlen van evenementen. Deze functies zijn nuttig voor het controleren van de frequentie van gebeurtenislokators, zodat ze alleen onder bepaalde voorwaarden worden geactiveerd.
Gebruik
- Om debounce in te stellen, gebruikt u de
setDebounce-methode. - Om throttle in te stellen, gebruikt u de
setThrottle-methode.
Voorbeeld
In scenario's waarin u snel gebruikersinvoer wilt verwerken, zoals zoekinvoervelden, kunt u debounce gebruiken om de uitvoering uit te stellen totdat de gebruiker klaar is met typen.
Evenementopties samenvoegen
De ElementEventOptions-klasse ondersteunt het samenvoegen met andere instanties, waardoor ontwikkelaars verschillende opties kunnen aggregeren. Deze functie is nuttig bij het combineren van instellingen vanuit verschillende bronnen.
Annotaties
Doel
Voor het gemak kan ElementEventOptions worden geconfigureerd met behulp van annotaties. Deze annotaties bieden een beknoptere en expressievere manier om evenementopties in te stellen.
Voorbeeld
Overweeg de volgende voorbeeldannotatie:
@EventOptions(data = {@EventData(key = "value", exp = "component.value")},
debounce = @DebounceSettings(value = 200))