com.vaadin.flow.dom

Interface DomListenerRegistration

All Superinterfaces:

Registration, Serializable

public interface DomListenerRegistration
extends Registration

A registration for configuring or removing a DOM event listener added to an element.

Since:

1.0

Author:

Vaadin Ltd

See Also:

Element.addEventListener(String, DomEventListener)

Method Summary

Modifier and Type	Method and Description
DomListenerRegistration	addEventData(String eventData) Add a JavaScript expression for extracting event data.
default DomListenerRegistration	debounce(int timeout) Configures this listener to be notified only when at least timeout milliseconds has passed since the last time the event was triggered.
DomListenerRegistration	debounce(int timeout, DebouncePhase firstPhase, DebouncePhase... rest) Configures the debouncing phases for which this listener should be triggered.
String	getFilter() Gets the currently set filter expression.
DomListenerRegistration	setDisabledUpdateMode(DisabledUpdateMode disabledUpdateMode) Configure whether this listener will be called even in cases when the element is disabled.
DomListenerRegistration	setFilter(String filter) Sets a JavaScript expression that is used for filtering events to this listener.
default DomListenerRegistration	throttle(int period) Configures this listener to not be notified more often than period milliseconds.

Methods inherited from interface com.vaadin.flow.shared.Registration

remove

Method Detail

addEventData

DomListenerRegistration addEventData(String eventData)

Add a JavaScript expression for extracting event data. When an event is fired in the browser, the expression is evaluated and its value is sent back to the server. The expression is evaluated in a context where element refers to this element and event refers to the fired event. If multiple expressions are defined for the same event, their order of execution is undefined.

The result of the evaluation is available in DomEvent.getEventData() with the expression as the key in the JSON object. An expression might be e.g.

• element.value the get the value of an input element for a change event.
• event.button === 0 to get true for click events triggered by the primary mouse button.

Parameters:

eventData - definition for data that should be passed back to the server together with the event, not null

Returns:

this registration, for chaining

setFilter

DomListenerRegistration setFilter(String filter)

Sets a JavaScript expression that is used for filtering events to this listener. When an event is fired in the browser, the expression is evaluated and an event is sent to the server only if the expression value is true-ish according to JavaScript type coercion rules. The expression is evaluated in a context where element refers to this element and event refers to the fired event.

An expression might be e.g. event.button === 0 to only forward events triggered by the primary mouse button.

Any previous filter for this registration is discarded.

Parameters:

filter - the JavaScript filter expression, or null to clear the filter

Returns:

this registration, for chaining

getFilter

String getFilter()

Gets the currently set filter expression.

Returns:

the current filter expression, or null if no filter is in use

See Also:

setFilter(String)

setDisabledUpdateMode

DomListenerRegistration setDisabledUpdateMode(DisabledUpdateMode disabledUpdateMode)

Configure whether this listener will be called even in cases when the element is disabled.

Parameters:

disabledUpdateMode - controls RPC communication from the client side to the server side when the element is disabled, not null

Returns:

this registration, for chaining

debounce

DomListenerRegistration debounce(int timeout,
                                 DebouncePhase firstPhase,
                                 DebouncePhase... rest)

Configures the debouncing phases for which this listener should be triggered. Debouncing is disabled and the set phases are ignored if timeout is set to 0.

This methods overrides the settings previously set through debounce(int), throttle(int) or debounce(int, DebouncePhase, DebouncePhase...).

Parameters:

timeout - the debounce timeout in milliseconds, or 0 to disable debouncing

firstPhase - the first phase to use

rest - any remaining phases to use

Returns:

this registration, for chaining

See Also:

DebouncePhase

debounce

default DomListenerRegistration debounce(int timeout)

Configures this listener to be notified only when at least timeout milliseconds has passed since the last time the event was triggered. This is useful for cases such as text input where it's only relevant to know the result once the user stops typing.

Debouncing is disabled if the timeout is set to 0.

This methods overrides the settings previously set through debounce(int), throttle(int) or debounce(int, DebouncePhase, DebouncePhase...).

Parameters:

timeout - the debounce timeout in milliseconds, or 0 to disable debouncing

Returns:

this registration, for chaining

throttle

default DomListenerRegistration throttle(int period)

Configures this listener to not be notified more often than period milliseconds.

Throttling is disabled if the period is set to 0.

This methods overrides the settings previously set through debounce(int), throttle(int) or debounce(int, DebouncePhase, DebouncePhase...).

Parameters:

period - the minimum period between listener invocations, or 0 to disable throttling

Returns:

this registration, for chaining