com.vaadin.event.

Class FieldEvents.TextChangeEvent

  • All Implemented Interfaces:

    Serializable

    Direct Known Subclasses:

    AbstractTextField.TextChangeEventImpl

    Enclosing interface:

    FieldEvents


    public abstract static class FieldEvents.TextChangeEvent
extends Component.Event

    TextChangeEvents are fired when the user is editing the text content of a field. Most commonly text change events are triggered by typing text with keyboard, but e.g. pasting content from clip board to a text field also triggers an event.

    TextChangeEvents differ from Field.ValueChangeEvents so that they are triggered repeatedly while the end user is filling the field. ValueChangeEvents are not fired until the user for example hits enter or focuses another field. Also note the difference that TextChangeEvents are only fired if the change is triggered from the user, while ValueChangeEvents are also fired if the field value is set by the application code.

    The FieldEvents.TextChangeNotifiers implementation may decide when exactly TextChangeEvents are fired. TextChangeEvents are not necessary fire for example on each key press, but buffered with a small delay. The TextField component supports different modes for triggering TextChangeEvents.

    Since:

    6.5

    See Also:

    FieldEvents.TextChangeListener, FieldEvents.TextChangeNotifier, TextField#setTextChangeEventMode(com.vaadin.ui.TextField.TextChangeEventMode), Serialized Form