Package org.teamapps.ux.component.field

Class AbstractField<VALUE>

java.lang.Object

org.teamapps.ux.component.AbstractComponent

org.teamapps.ux.component.field.AbstractField<VALUE>

All Implemented Interfaces:

ClientObject, Component

Direct Known Subclasses:

AbstractComboBox, AbstractDateTimeField, AbstractTimeField, Button, CheckBox, ColorPicker, ComponentField, CurrencyField, DisplayField, FileField, ImageField, Label, LocalDateField, NumberField, PictureChooser, RichTextEditor, SimpleFileField, TemplateField, TextField

public abstract class AbstractField<VALUE>
extends AbstractComponent

Field Summary

Fields

Modifier and Type	Field	Description
final Event<VALUE>	onBlur
final Event<VALUE>	onFocus
final Event<VALUE>	onValueChanged
final Event<Boolean>	onVisibilityChanged

Fields inherited from class org.teamapps.ux.component.AbstractComponent

DELETED_ATTRIBUTE, onRendered

Constructor Summary

Constructors

Constructor	Description
AbstractField()

Method Summary

Modifier and Type	Method	Description
void	addCustomFieldMessage(FieldMessage fieldMessage)
void	addCustomFieldMessage(FieldMessage.Severity severity, String text)
void	addValidator(FieldValidator<VALUE> validator)
protected void	applyValueFromUi(Object value)
void	clearCustomFieldMessages()
void	clearValidatorMessages()
VALUE	convertUiValueToUxValue(Object value)
Object	convertUxValueToUiValue(VALUE value)	Converts a server-side value to a client-side field-specific value.
void	focus()
List<FieldMessage>	getCustomFieldMessages()
FieldMessage.Position	getDefaultMessagePosition()
FieldMessage.Visibility	getDefaultMessageVisibility()
FieldEditingMode	getEditingMode()
List<FieldMessage>	getFieldMessages()
FieldMessage.Severity	getMaxFieldMessageSeverity()
Collection<FieldValidator<VALUE>>	getValidators()
VALUE	getValue()
void	handleUiEvent(UiEvent event)
boolean	isEmpty()
protected boolean	isEmptyValue(VALUE value)	Whether this value be regarded as empty / "no user input".
boolean	isRequired()
boolean	isValid()
boolean	isValueChangedByClient()
protected boolean	isValueLocked()
protected void	mapAbstractFieldAttributesToUiField(UiField uiField)
void	removeCustomFieldMessage(FieldMessage fieldMessage)
void	removeValidator(FieldValidator<VALUE> validator)
protected MultiWriteLockableValue.Lock	setAndLockValue(VALUE value)
void	setCustomFieldMessages(List<FieldMessage> fieldMessages)
void	setDefaultMessagePosition(FieldMessage.Position defaultMessagePosition)
void	setDefaultMessageVisibility(FieldMessage.Visibility defaultMessageVisibility)
void	setEditingMode(FieldEditingMode editingMode)
void	setRequired(boolean required)	field may not be null (empty)
void	setRequiredIfVisibleAndEditable(boolean required)
void	setValue(VALUE value)
void	setValueChangedByClient(boolean valueChangedByClient)
void	setVisible(boolean visible)
List<FieldMessage>	validate()

Methods inherited from class org.teamapps.ux.component.AbstractComponent

createUiComponent, createUiReference, getDebuggingId, getId, getParent, getSessionContext, isRendered, isVisible, mapAbstractUiComponentProperties, queueCommandIfRendered, render, reRenderIfRendered, setAttribute, setCssStyle, setDebuggingId, setParent, toggleCssClass, toString, unrender

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.teamapps.ux.component.ClientObject

handleUiQuery

Methods inherited from interface org.teamapps.ux.component.Component

setAriaLabel, setAttribute, setCssStyle, setHtmlTitle, setMargin, setMaxHeight, setMaxWidth, setMinHeight, setMinWidth, setShadow, toggleCssClass

Field Details

onFocus

public final Event<VALUE> onFocus

onBlur

public final Event<VALUE> onBlur

onValueChanged

public final Event<VALUE> onValueChanged

onVisibilityChanged

public final Event<Boolean> onVisibilityChanged

Constructor Details

AbstractField

public AbstractField()

Method Details

getEditingMode

public FieldEditingMode getEditingMode()

setEditingMode

public void setEditingMode(FieldEditingMode editingMode)

setVisible

public void setVisible(boolean visible)

Specified by:

setVisible in interface Component

Overrides:

setVisible in class AbstractComponent

focus

public void focus()

mapAbstractFieldAttributesToUiField

protected void mapAbstractFieldAttributesToUiField(UiField uiField)

setValue

public void setValue(VALUE value)

setAndLockValue

protected MultiWriteLockableValue.Lock setAndLockValue(VALUE value)

convertUxValueToUiValue

public Object convertUxValueToUiValue(VALUE value)

Converts a server-side value to a client-side field-specific value. Implementations must not have any side effects to the component!

Parameters:

value - the server-side value

Returns:

the object to be sent to the ui

getValue

public VALUE getValue()

handleUiEvent

public void handleUiEvent(UiEvent event)

applyValueFromUi

protected void applyValueFromUi(Object value)

isValueLocked

protected boolean isValueLocked()

convertUiValueToUxValue

public VALUE convertUiValueToUxValue(Object value)

isEmptyValue

protected boolean isEmptyValue(VALUE value)

Whether this value be regarded as empty / "no user input". Override for field-specific behaviour.

Returns:

true if the value can be regarded as "empty".

isEmpty

public boolean isEmpty()

getValidators

public Collection<FieldValidator<VALUE>> getValidators()

addValidator

public void addValidator(FieldValidator<VALUE> validator)

removeValidator

public void removeValidator(FieldValidator<VALUE> validator)

validate

public List<FieldMessage> validate()

clearValidatorMessages

public void clearValidatorMessages()

setRequired

public void setRequired(boolean required)

field may not be null (empty)

setRequiredIfVisibleAndEditable

public void setRequiredIfVisibleAndEditable(boolean required)

isRequired

public boolean isRequired()

getFieldMessages

public List<FieldMessage> getFieldMessages()

getCustomFieldMessages

public List<FieldMessage> getCustomFieldMessages()

setCustomFieldMessages

public void setCustomFieldMessages(List<FieldMessage> fieldMessages)

addCustomFieldMessage

public void addCustomFieldMessage(FieldMessage.Severity severity,
 String text)

addCustomFieldMessage

public void addCustomFieldMessage(FieldMessage fieldMessage)

removeCustomFieldMessage

public void removeCustomFieldMessage(FieldMessage fieldMessage)

clearCustomFieldMessages

public void clearCustomFieldMessages()

isValid

public boolean isValid()

getMaxFieldMessageSeverity

public FieldMessage.Severity getMaxFieldMessageSeverity()

getDefaultMessagePosition

public FieldMessage.Position getDefaultMessagePosition()

setDefaultMessagePosition

public void setDefaultMessagePosition(FieldMessage.Position defaultMessagePosition)

getDefaultMessageVisibility

public FieldMessage.Visibility getDefaultMessageVisibility()

setDefaultMessageVisibility

public void setDefaultMessageVisibility(FieldMessage.Visibility defaultMessageVisibility)

isValueChangedByClient

public boolean isValueChangedByClient()

setValueChangedByClient

public void setValueChangedByClient(boolean valueChangedByClient)