com.vaadin.flow.component.customfield

Class CustomField<T>

java.lang.Object

com.vaadin.flow.component.Component

com.vaadin.flow.component.AbstractField<CustomField<T>,T>

com.vaadin.flow.component.customfield.CustomField<T>

Type Parameters:

T - field value type

All Implemented Interfaces:

com.vaadin.flow.component.AttachNotifier, com.vaadin.flow.component.BlurNotifier<CustomField>, com.vaadin.flow.component.DetachNotifier, com.vaadin.flow.component.Focusable<CustomField>, com.vaadin.flow.component.FocusNotifier<CustomField>, com.vaadin.flow.component.HasComponents, com.vaadin.flow.component.HasElement, com.vaadin.flow.component.HasEnabled, com.vaadin.flow.component.HasSize, com.vaadin.flow.component.HasValidation, com.vaadin.flow.component.HasValue<com.vaadin.flow.component.AbstractField.ComponentValueChangeEvent<CustomField<T>,T>,T>, com.vaadin.flow.component.HasValueAndElement<com.vaadin.flow.component.AbstractField.ComponentValueChangeEvent<CustomField<T>,T>,T>, Serializable

@Tag(value="vaadin-custom-field")
 @HtmlImport(value="frontend://bower_components/vaadin-custom-field/src/vaadin-custom-field.html")
public abstract class CustomField<T>
extends com.vaadin.flow.component.AbstractField<CustomField<T>,T>
implements com.vaadin.flow.component.HasComponents, com.vaadin.flow.component.HasSize, com.vaadin.flow.component.HasValidation, com.vaadin.flow.component.Focusable<CustomField>

A HasValue whose UI content can be constructed by the user, enabling the creation of e.g. form fields by composing Vaadin components. Customization of both the visual presentation and the logic of the field is possible.

Subclasses must implement generateModelValue() and AbstractFieldsetPresentationValue(Object).

See Also:

Serialized Form

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>

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.HasValue

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

Constructor Summary

Constructors

Constructor and Description
CustomField() Default constructor.
CustomField(T defaultValue) Constructs a new custom field.

Method Summary

Modifier and Type	Method and Description
protected abstract T	generateModelValue() This method should return the value of the field, based on value of the internal fields.
String	getErrorMessage()
String	getLabel() Gets the label for the field.
boolean	isInvalid() This property is set to true when the control value is invalid.
void	setErrorMessage(String errorMessage)
void	setInvalid(boolean invalid) This property is set to true when the control value is invalid.
void	setLabel(String label) Sets the label for the field.
protected abstract void	setPresentationValue(T newPresentationValue) This method should be implemented to set the value of the fields contained in this custom field according to the value of the parameter.
protected void	updateValue() Regenerates the value and updates the model.

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

addValueChangeListener, getEmptyValue, getValue, isEmpty, setModelValue, setValue, valueEquals

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

addListener, fireEvent, from, get, getChildren, getElement, getEventBus, getId, getLocale, getParent, getTranslation, getTranslation, getUI, hasListener, isTemplateMapped, isVisible, onAttach, onDetach, onEnabledStateChanged, 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.HasComponents

add, add, addComponentAsFirst, addComponentAtIndex, remove, removeAll

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

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

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

addFocusShortcut, blur, focus, getTabIndex, setTabIndex

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

addBlurListener

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

addFocusListener

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

isEnabled, setEnabled

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

isReadOnly, isRequiredIndicatorVisible, setReadOnly, setRequiredIndicatorVisible

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

clear, getOptionalValue

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

addAttachListener

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

addDetachListener

Constructor Detail

CustomField

public CustomField()

Default constructor.

CustomField

public CustomField(T defaultValue)

Constructs a new custom field.

Parameters:

defaultValue - The initial value for the field. Will also be used by AbstractField.getEmptyValue().

See Also:

AbstractField.AbstractField(Object)

Method Detail

generateModelValue

protected abstract T generateModelValue()

This method should return the value of the field, based on value of the internal fields.

Returns:

new value of the field.

setPresentationValue

protected abstract void setPresentationValue(T newPresentationValue)

This method should be implemented to set the value of the fields contained in this custom field according to the value of the parameter. It can also be use to show the value to the user in some way, like placing it in an element contained on the field.

Specified by:

setPresentationValue in class com.vaadin.flow.component.AbstractField<CustomField<T>,T>

Parameters:

newPresentationValue - The new presentation value.

updateValue

protected void updateValue()

Regenerates the value and updates the model. Subclasses of CustomField can call it when the model value needs to be regenerated and updated.

isInvalid

@Synchronize(property="invalid",
             value="invalid-changed")
public boolean isInvalid()

This property is set to true when the control value is invalid.

This property is synchronized automatically from client side when a 'invalid-changed' event happens.

Specified by:

isInvalid in interface com.vaadin.flow.component.HasValidation

Returns:

the invalid property from the webcomponent

setInvalid

public void setInvalid(boolean invalid)

This property is set to true when the control value is invalid.

Specified by:

setInvalid in interface com.vaadin.flow.component.HasValidation

Parameters:

invalid - the boolean value to set

setErrorMessage

public void setErrorMessage(String errorMessage)

Specified by:

setErrorMessage in interface com.vaadin.flow.component.HasValidation

getErrorMessage

public String getErrorMessage()

Specified by:

getErrorMessage in interface com.vaadin.flow.component.HasValidation

getLabel

public String getLabel()

Gets the label for the field.

Returns:

the label property from the webcomponent

setLabel

public void setLabel(String label)

Sets the label for the field.

Parameters:

label - value for the label property in the webcomponent