Event Options
ElementEventOptions est un outil polyvalent de webforJ conçu pour encapsuler et gérer les paramètres de configuration des événements Element au sein des applications webforJ. En tant que conteneur pour diverses options, il permet aux développeurs de dicter précisément comment les événements associés aux éléments doivent être traités.
Données des événements
Les données des événements sont une fonctionnalité clé de ElementEventOptions, permettant aux développeurs d'attacher des informations spécifiques aux options d'événements. Cette fonctionnalité facilite le passage de données personnalisées du client au serveur lorsqu'un événement est déclenché. Cette capacité est essentielle pour transmettre un contexte supplémentaire ou des paramètres associés à l'événement, et permet d'accéder et d'utiliser des informations sans avoir besoin d'effectuer des requêtes supplémentaires au client.
Par exemple, considérons un scénario où vous avez un événement de clic sur un bouton et que vous souhaitez passer le nom d'utilisateur actuel de l'utilisateur avec l'événement. Au lieu de requêter le nom d'utilisateur d'un utilisateur depuis le client à chaque fois, envoyez cette information avec l'événement comme données.
Pour plus d'informations, consultez les pages events et Client/Server Interaction.
Pour ajouter des données aux options d'événements, vous pouvez utiliser la méthode addData().
Exécution de JavaScript
La classe ElementEventOptions permet aux développeurs de spécifier du code JavaScript à évaluer côté client avant que l'événement associé ne soit déclenché. Cette fonctionnalité permet aux clients de préparer des données d'événements ou de déclencher des événements supplémentaires si nécessaire. Cela est utile dans de nombreux cas, par exemple lorsque vous souhaitez valider les données d'un formulaire côté client avant de les soumettre via un événement de soumission de formulaire.
Utilisation
Pour définir le code de l'événement, utilisez la méthode setCode().
Filtrage des événements
ElementEventOptions inclut une fonctionnalité permettant de définir une expression de filtre à évaluer sur le client avant que l'événement ne soit déclenché. Cette expression de filtre permet au client de déterminer si l'événement doit se poursuivre ou être arrêté en fonction de certaines conditions. Considérez un champ de saisie où vous souhaitez déclencher un événement uniquement si le texte saisi répond à des critères spécifiques, tels qu'une longueur minimale.
Utilisation
Pour définir le filtre de l'événement, utilisez la méthode setFilter().
Debouncing et throttling
Objectif
ElementEventOptions fournit des mécanismes pour le debouncing et le throttling des événements. Ces fonctionnalités sont utiles pour contrôler la fréquence des écouteurs d'événements, en s'assurant qu'ils ne sont déclenchés que sous certaines conditions.
Utilisation
- Pour définir le debouncing, utilisez la méthode
setDebounce. - Pour définir le throttling, utilisez la méthode
setThrottle.
Exemple
Dans les scénarios où vous souhaitez gérer des saisies rapides de l'utilisateur, telles que des champs de saisie de recherche, vous pouvez utiliser le debouncing pour retarder l'exécution jusqu'à ce que l'utilisateur ait terminé de taper.
Fusionner les options d'événements
La classe ElementEventOptions prend en charge la fusion avec d'autres instances, permettant aux développeurs de regrouper diverses options. Cette fonctionnalité est utile lors de la combinaison de paramètres provenant de différentes sources.
Annotations
Objectif
Pour plus de commodité, ElementEventOptions peut être configuré à l'aide d'annotations. Ces annotations offrent une manière plus concise et expressive de définir des options d'événements.
Exemple
Considérez l'exemple d'annotation suivant :
@EventOptions(data = {@EventData(key = "value", exp = "component.value")},
debounce = @DebounceSettings(value = 200))