ui.util.throttle
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Encapsule une fonction pour lui permettre d'être appelée au maximum deux fois par intervalle. Si la fonction wrapper est appelée plusieurs fois avant l'expiration du délai, seuls le premier et le dernier appels seront exécutés.
Exemple d'utilisation : pour le rappel d'un événement de diapositive sur un ui.Slider. Le rappel s'exécutera immédiatement, ce qui donnera l'impression que l'action de balayage est réactive. L'exécution du rappel est également garantie une fois que l'utilisateur a fini d'interagir avec le curseur, ce qui garantit que la dernière invocation du rappel a accès à la valeur finale du curseur.
Renvoie la fonction encapsulée.
| Utilisation | Renvoie |
|---|
ui.util.throttle(func, delay, scope) | Fonction |
| Argument | Type | Détails |
|---|
func | Fonction | Fonction à appeler. |
delay | Nombre | Délai, en millisecondes, pour la limitation. La fonction ne peut être appelée qu'une seule fois après l'appel initial, une fois le délai écoulé. |
scope | Objet, facultatif | Objet dans la portée duquel appeler la fonction. |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 2025/07/26 (UTC)."],[[["\u003cp\u003eLimits a function's execution to at most twice per specified interval, ensuring responsiveness and capturing the final state.\u003c/p\u003e\n"],["\u003cp\u003eUseful for scenarios like UI slider events where immediate feedback and final value processing are crucial.\u003c/p\u003e\n"],["\u003cp\u003eWraps the original function and returns a new function that manages the throttling behavior.\u003c/p\u003e\n"],["\u003cp\u003eCustomizable with a delay parameter (in milliseconds) and an optional scope for execution context.\u003c/p\u003e\n"]]],[],null,["# ui.util.throttle\n\n\u003cbr /\u003e\n\nWraps a function to allow it to be called, at most, twice per interval. If the wrapper function is called multiple times before the delay elapses, only the first and the last calls will go through.\n\n\u003cbr /\u003e\n\nExample use: For the callback to a slide event on a ui.Slider. The callback will run immediately, making the slide action feel responsive. The callback is also guaranteed to run after the user has finished interacting with the slider, ensuring that the final callback invocation has access to the slider's final value.\n\nReturns the wrapped function.\n\n| Usage | Returns |\n|--------------------------------------------|----------|\n| `ui.util.throttle(func, delay, `*scope*`)` | Function |\n\n| Argument | Type | Details |\n|----------|------------------|----------------------------------------------------------------------------------------------------------------------------------------------------|\n| `func` | Function | The function to call. |\n| `delay` | Number | The delay, in milliseconds, for the throttle. The function can only be called once after the initial invocation until after the delay has elapsed. |\n| `scope` | Object, optional | The object in whose scope to call the function. |"]]
