Package com.vaadin.flow.component.textfield

Class AbstractNumberField<C extends AbstractNumberField<C,T>,T extends Number>

java.lang.Object
com.vaadin.flow.component.Component
com.vaadin.flow.component.AbstractField<C,T>
com.vaadin.flow.component.AbstractSinglePropertyField<TComponent,TValue>
com.vaadin.flow.component.textfield.TextFieldBase<C,T>
com.vaadin.flow.component.textfield.AbstractNumberField<C,T>
All Implemented Interfaces:
com.vaadin.flow.component.AttachNotifier, com.vaadin.flow.component.BlurNotifier<C>, com.vaadin.flow.component.CompositionNotifier, com.vaadin.flow.component.DetachNotifier, com.vaadin.flow.component.Focusable<C>, com.vaadin.flow.component.FocusNotifier<C>, com.vaadin.flow.component.HasAriaLabel, com.vaadin.flow.component.HasElement, com.vaadin.flow.component.HasEnabled, com.vaadin.flow.component.HasHelper, com.vaadin.flow.component.HasLabel, com.vaadin.flow.component.HasPlaceholder, com.vaadin.flow.component.HasSize, com.vaadin.flow.component.HasStyle, com.vaadin.flow.component.HasValidation, com.vaadin.flow.component.HasValue<com.vaadin.flow.component.AbstractField.ComponentValueChangeEvent<C,T>,T>, com.vaadin.flow.component.HasValueAndElement<com.vaadin.flow.component.AbstractField.ComponentValueChangeEvent<C,T>,T>, com.vaadin.flow.component.InputNotifier, com.vaadin.flow.component.KeyNotifier, HasClearButton, HasClientValidation, HasPrefix, HasSuffix, HasTooltip, HasValidationProperties, InputField<com.vaadin.flow.component.AbstractField.ComponentValueChangeEvent<C,T>,T>, HasAutocapitalize, HasAutocomplete, HasAutocorrect, HasPrefixAndSuffix, com.vaadin.flow.data.binder.HasValidator<T>, com.vaadin.flow.data.value.HasValueChangeMode, Serializable
Direct Known Subclasses:
IntegerField, NumberField
public abstract class AbstractNumberField<C extends AbstractNumberField<C,T>,T extends Number> extends TextFieldBase<C,T>
Abstract base class for components based on vaadin-number-field element and its subclasses.
Author:
Vaadin Ltd.
See Also:

  • Nested Class Summary

    Nested classes/interfaces inherited from class com.vaadin.flow.component.AbstractField

    com.vaadin.flow.component.AbstractField.ComponentValueChangeEvent<C extends com.vaadin.flow.component.Component,V extends Object>

    Nested classes/interfaces inherited from interface com.vaadin.flow.component.BlurNotifier

    com.vaadin.flow.component.BlurNotifier.BlurEvent<C extends com.vaadin.flow.component.Component>

    Nested classes/interfaces inherited from interface com.vaadin.flow.component.FocusNotifier

    com.vaadin.flow.component.FocusNotifier.FocusEvent<C extends com.vaadin.flow.component.Component>

    Nested classes/interfaces inherited from interface com.vaadin.flow.component.shared.HasClientValidation

    HasClientValidation.ClientValidatedEvent

    Nested classes/interfaces inherited from interface com.vaadin.flow.component.HasValue

    com.vaadin.flow.component.HasValue.ValueChangeEvent<V extends Object>, com.vaadin.flow.component.HasValue.ValueChangeListener<E extends com.vaadin.flow.component.HasValue.ValueChangeEvent<?>>

  • Field Summary

    Fields inherited from interface com.vaadin.flow.component.textfield.HasAutocapitalize

    AUTOCAPITALIZE_ATTRIBUTE

    Fields inherited from interface com.vaadin.flow.component.textfield.HasAutocomplete

    AUTOCOMPLETE_ATTRIBUTE

    Fields inherited from interface com.vaadin.flow.component.textfield.HasAutocorrect

    AUTOCORRECT_ATTRIBUTE

    Fields inherited from interface com.vaadin.flow.data.value.HasValueChangeMode

    DEFAULT_CHANGE_TIMEOUT

  • Constructor Summary

    Constructors
    Constructor
    Description
    AbstractNumberField(com.vaadin.flow.function.SerializableFunction<String,T> parser, com.vaadin.flow.function.SerializableFunction<T,String> formatter, double absoluteMin, double absoluteMax)
    Sets up the common logic for number fields.

  • Method Summary

    Modifier and Type
    Method
    Description
    com.vaadin.flow.shared.Registration
    addValidationStatusChangeListener(com.vaadin.flow.data.binder.ValidationStatusChangeListener<T> listener)
     
    com.vaadin.flow.data.binder.Validator<T>
    getDefaultValidator()
     
    T
    getEmptyValue()
    Returns the value that represents an empty value.
    protected double
    getMaxDouble()
    The maximum value of the field.
    protected double
    getMinDouble()
    The minimum value of the field.
    protected double
    getStepDouble()
    The allowed number intervals of the field.
    T
    getValue()
    Returns the current value of the number field.
    boolean
    isStepButtonsVisible()
    Gets whether the buttons for increasing/decreasing the value are visible.
    protected void
    onAttach(com.vaadin.flow.component.AttachEvent attachEvent)
     
    void
    setManualValidation(boolean enabled)
     
    protected void
    setMax(double max)
    Sets the maximum value of the field.
    protected void
    setMin(double min)
    Sets the minimum value of the field.
    protected void
    setModelValue(T newModelValue, boolean fromClient)
     
    void
    setRequiredIndicatorVisible(boolean requiredIndicatorVisible)
     
    protected void
    setStep(double step)
    Sets the allowed number intervals of the field.
    void
    setStepButtonsVisible(boolean stepButtonsVisible)
    Sets the visibility of the buttons for increasing/decreasing the value accordingly to the default or specified step.
    void
    setValue(T value)
    Sets the value of this number field.
    void
    setValueChangeMode(com.vaadin.flow.data.value.ValueChangeMode valueChangeMode)
     
    protected void
    validate()
    Performs server-side validation of the current value.

    Methods inherited from class com.vaadin.flow.component.textfield.TextFieldBase

    addToInput, addToPrefix, addToSuffix, getAriaLabel, getAriaLabelledBy, getTitle, getValueChangeMode, getValueChangeTimeout, isAutofocus, isAutoselect, isRequired, setAriaLabel, setAriaLabelledBy, setAutofocus, setAutoselect, setLabel, setRequired, setTitle, setValueChangeTimeout

    Methods inherited from class com.vaadin.flow.component.AbstractSinglePropertyField

    getSynchronizationRegistration, hasValidValue, setPresentationValue, setSynchronizedEvent

    Methods inherited from class com.vaadin.flow.component.AbstractField

    addValueChangeListener, isEmpty, valueEquals

    Methods inherited from class com.vaadin.flow.component.Component

    addListener, findAncestor, fireEvent, from, get, getChildren, getElement, getEventBus, getId, getListeners, getLocale, getParent, getTranslation, getTranslation, getTranslation, getTranslation, getTranslation, getTranslation, getUI, hasListener, isAttached, isTemplateMapped, isVisible, onDetach, onEnabledStateChanged, removeFromParent, scrollIntoView, scrollIntoView, set, setElement, setId, setVisible

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    Methods inherited from interface com.vaadin.flow.component.AttachNotifier

    addAttachListener

    Methods inherited from interface com.vaadin.flow.component.BlurNotifier

    addBlurListener

    Methods inherited from interface com.vaadin.flow.component.CompositionNotifier

    addCompositionEndListener, addCompositionStartListener, addCompositionUpdateListener

    Methods inherited from interface com.vaadin.flow.component.DetachNotifier

    addDetachListener

    Methods inherited from interface com.vaadin.flow.component.Focusable

    addFocusShortcut, blur, focus, getTabIndex, setTabIndex

    Methods inherited from interface com.vaadin.flow.component.FocusNotifier

    addFocusListener

    Methods inherited from interface com.vaadin.flow.component.textfield.HasAutocapitalize

    getAutocapitalize, setAutocapitalize

    Methods inherited from interface com.vaadin.flow.component.textfield.HasAutocomplete

    getAutocomplete, setAutocomplete

    Methods inherited from interface com.vaadin.flow.component.textfield.HasAutocorrect

    isAutocorrect, setAutocorrect

    Methods inherited from interface com.vaadin.flow.component.shared.HasClearButton

    isClearButtonVisible, setClearButtonVisible

    Methods inherited from interface com.vaadin.flow.component.shared.HasClientValidation

    addClientValidatedEventListener

    Methods inherited from interface com.vaadin.flow.component.HasElement

    getElement

    Methods inherited from interface com.vaadin.flow.component.HasEnabled

    isEnabled, setEnabled

    Methods inherited from interface com.vaadin.flow.component.HasHelper

    getHelperComponent, getHelperText, setHelperComponent, setHelperText

    Methods inherited from interface com.vaadin.flow.component.HasLabel

    getLabel

    Methods inherited from interface com.vaadin.flow.component.HasPlaceholder

    getPlaceholder, setPlaceholder

    Methods inherited from interface com.vaadin.flow.component.shared.HasPrefix

    getPrefixComponent, setPrefixComponent

    Methods inherited from interface com.vaadin.flow.component.HasSize

    getHeight, getHeightUnit, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getWidth, getWidthUnit, setHeight, setHeight, setHeightFull, setMaxHeight, setMaxHeight, setMaxWidth, setMaxWidth, setMinHeight, setMinHeight, setMinWidth, setMinWidth, setSizeFull, setSizeUndefined, setWidth, setWidth, setWidthFull

    Methods inherited from interface com.vaadin.flow.component.HasStyle

    addClassName, addClassNames, getClassName, getClassNames, getStyle, hasClassName, removeClassName, removeClassNames, setClassName, setClassName

    Methods inherited from interface com.vaadin.flow.component.shared.HasSuffix

    getSuffixComponent, setSuffixComponent

    Methods inherited from interface com.vaadin.flow.component.shared.HasTooltip

    getTooltip, setTooltipText

    Methods inherited from interface com.vaadin.flow.component.shared.HasValidationProperties

    getErrorMessage, isInvalid, setErrorMessage, setInvalid

    Methods inherited from interface com.vaadin.flow.component.HasValue

    addValueChangeListener, clear, getOptionalValue, isEmpty

    Methods inherited from interface com.vaadin.flow.component.HasValueAndElement

    isReadOnly, isRequiredIndicatorVisible, setReadOnly

    Methods inherited from interface com.vaadin.flow.component.InputNotifier

    addInputListener

    Methods inherited from interface com.vaadin.flow.component.KeyNotifier

    addKeyDownListener, addKeyDownListener, addKeyPressListener, addKeyPressListener, addKeyUpListener, addKeyUpListener

  • Constructor Details

    • AbstractNumberField

      public AbstractNumberField(com.vaadin.flow.function.SerializableFunction<String,T> parser, com.vaadin.flow.function.SerializableFunction<T,String> formatter, double absoluteMin, double absoluteMax)
      Sets up the common logic for number fields.
      Parameters:
      parser - function to parse the client-side value string into server-side value
      formatter - function to format the server-side value into client-side value string
      absoluteMin - the smallest possible value of the number type of the field, will be used as the default min value at server-side
      absoluteMax - the largest possible value of the number type of the field, will be used as the default max value at server-side

  • Method Details

    • setValueChangeMode

      public void setValueChangeMode(com.vaadin.flow.data.value.ValueChangeMode valueChangeMode)
      Specified by:
      setValueChangeMode in interface com.vaadin.flow.data.value.HasValueChangeMode
      Overrides:
      setValueChangeMode in class TextFieldBase<C extends AbstractNumberField<C,T>,T extends Number>

    • setStepButtonsVisible

      public void setStepButtonsVisible(boolean stepButtonsVisible)
      Sets the visibility of the buttons for increasing/decreasing the value accordingly to the default or specified step.
      Parameters:
      stepButtonsVisible - true if control buttons should be visible; false if those should be hidden
      See Also:

    • isStepButtonsVisible

      public boolean isStepButtonsVisible()
      Gets whether the buttons for increasing/decreasing the value are visible.
      Returns:
      true if buttons are visible, false otherwise
      See Also:

    • getEmptyValue

      public T getEmptyValue()
      Returns the value that represents an empty value.
      Specified by:
      getEmptyValue in interface com.vaadin.flow.component.HasValue<C extends AbstractNumberField<C,T>,T extends Number>
      Overrides:
      getEmptyValue in class com.vaadin.flow.component.AbstractField<C extends AbstractNumberField<C,T>,T extends Number>

    • setValue

      public void setValue(T value)
      Sets the value of this number field. If the new value is not equal to getValue(), fires a value change event.
      Specified by:
      setValue in interface com.vaadin.flow.component.HasValue<C extends AbstractNumberField<C,T>,T extends Number>
      Overrides:
      setValue in class com.vaadin.flow.component.AbstractField<C extends AbstractNumberField<C,T>,T extends Number>
      Parameters:
      value - the new value

    • setModelValue

      protected void setModelValue(T newModelValue, boolean fromClient)
      Overrides:
      setModelValue in class com.vaadin.flow.component.AbstractField<C extends AbstractNumberField<C,T>,T extends Number>

    • getValue

      public T getValue()
      Returns the current value of the number field. By default, the empty number field will return null .
      Specified by:
      getValue in interface com.vaadin.flow.component.HasValue<C extends AbstractNumberField<C,T>,T extends Number>
      Overrides:
      getValue in class com.vaadin.flow.component.AbstractField<C extends AbstractNumberField<C,T>,T extends Number>
      Returns:
      the current value.

    • setMin

      protected void setMin(double min)
      Sets the minimum value of the field.
      Parameters:
      min - the double value to set

    • getMinDouble

      protected double getMinDouble()
      The minimum value of the field.

    • setMax

      protected void setMax(double max)
      Sets the maximum value of the field.
      Parameters:
      max - the double value to set

    • getMaxDouble

      protected double getMaxDouble()
      The maximum value of the field.

    • setStep

      protected void setStep(double step)
      Sets the allowed number intervals of the field.
      Parameters:
      step - the double value to set

    • getStepDouble

      protected double getStepDouble()
      The allowed number intervals of the field.

    • getDefaultValidator

      public com.vaadin.flow.data.binder.Validator<T> getDefaultValidator()

    • addValidationStatusChangeListener

      public com.vaadin.flow.shared.Registration addValidationStatusChangeListener(com.vaadin.flow.data.binder.ValidationStatusChangeListener<T> listener)

    • setManualValidation

      public void setManualValidation(boolean enabled)

    • validate

      protected void validate()
      Performs server-side validation of the current value. This is needed because it is possible to circumvent the client-side validation constraints using browser development tools.

    • setRequiredIndicatorVisible

      public void setRequiredIndicatorVisible(boolean requiredIndicatorVisible)

    • onAttach

      protected void onAttach(com.vaadin.flow.component.AttachEvent attachEvent)
      Overrides:
      onAttach in class com.vaadin.flow.component.Component