Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
blockly > utils > browserEvents > conditionalBind
Funzione utils.browserEvents.conditionalBind()
Associa un gestore di eventi che può essere ignorato se non fa parte dello stream di tocco attivo. Da utilizzare per gli eventi che avviano o continuano un gesto composto da più parti (ad es. mousedown o mousemove, che possono essere parte di un trascinamento o di un clic).
Firma:
export declare function conditionalBind(node: EventTarget, name: string, thisObject: object | null, func: Function, opt_noCaptureIdentifier?: boolean): Data;
Parametri
| Parametro |
Tipo |
Descrizione |
| nodo |
EventTarget |
Nodo su cui ascoltare. |
| nome |
stringa |
Nome dell'evento da ascoltare (ad es. "mousedown"). |
| thisObject |
object | null |
Il valore di "this" nella funzione. |
| func |
Funzione |
Funzione da chiamare quando viene attivato l'evento. |
| opt_noCaptureIdentifier |
booleano |
(Facoltativo) True se l'attivazione di questo evento non deve bloccare l'esecuzione di altri gestori eventi su questo tocco o su altri tocchi simultanei. False per impostazione predefinita. |
Restituisce:
Dati
Dati non trasparenti che possono essere passati a unbindEvent_.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[[["\u003cp\u003e\u003ccode\u003eutils.browserEvents.conditionalBind()\u003c/code\u003e allows binding event handlers that can be selectively ignored based on touch stream activity, making it suitable for multi-part gestures like dragging or clicking.\u003c/p\u003e\n"],["\u003cp\u003eThe function takes parameters for the target node, event name, function to execute, context (\u003ccode\u003ethis\u003c/code\u003e value), and an optional flag to control blocking behavior.\u003c/p\u003e\n"],["\u003cp\u003eIt returns an opaque data object that can be later used to unbind the event using \u003ccode\u003eunbindEvent_\u003c/code\u003e.\u003c/p\u003e\n"]]],["The `conditionalBind` function binds an event handler to a specified node. It takes the node, event name, a `this` object, the handler function, and an optional boolean to control blocking of other event handlers. When the event is triggered, the provided function is executed. This is intended for events related to multi-part gestures. It returns data used for unbinding the event later. This allows to control whether to block execution of other handlers for touches.\n"],null,["[blockly](./blockly.md) \\\u003e [utils](./blockly.utils_namespace.md) \\\u003e [browserEvents](./blockly.utils_namespace.browserevents_namespace.md) \\\u003e [conditionalBind](./blockly.utils_namespace.browserevents_namespace.conditionalbind_1_function.md)\n\nutils.browserEvents.conditionalBind() function\n----------------------------------------------\n\nBind an event handler that can be ignored if it is not part of the active touch stream. Use this for events that either start or continue a multi-part gesture (e.g. mousedown or mousemove, which may be part of a drag or click).\n\n**Signature:** \n\n export declare function conditionalBind(node: EventTarget, name: string, thisObject: object | null, func: Function, opt_noCaptureIdentifier?: boolean): Data;\n\nParameters\n----------\n\n| Parameter | Type | Description |\n|-------------------------|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| node | EventTarget | Node upon which to listen. |\n| name | string | Event name to listen to (e.g. 'mousedown'). |\n| thisObject | object \\| null | The value of 'this' in the function. |\n| func | Function | Function to call when event is triggered. |\n| opt_noCaptureIdentifier | boolean | *(Optional)* True if triggering on this event should not block execution of other event handlers on this touch or other simultaneous touches. False by default. |\n\n**Returns:**\n\n[Data](./blockly.browserevents_namespace.data_typealias.md)\n\nOpaque data that can be passed to unbindEvent_."]]
