com.smartgwt.mobile.client.widgets.form.fields

Class FormItem

java.lang.Object

com.google.gwt.user.client.ui.UIObject

com.google.gwt.user.client.ui.Widget

com.google.gwt.user.client.ui.Panel

com.google.gwt.user.client.ui.ComplexPanel

com.smartgwt.mobile.client.widgets.Canvas

com.smartgwt.mobile.client.widgets.form.fields.AbstractHasDataValue

com.smartgwt.mobile.client.widgets.form.fields.FormItem

All Implemented Interfaces:

com.google.gwt.event.dom.client.HasKeyPressHandlers, com.google.gwt.event.logical.shared.HasAttachHandlers, com.google.gwt.event.shared.EventHandler, com.google.gwt.event.shared.HasHandlers, com.google.gwt.user.client.EventListener, com.google.gwt.user.client.ui.HasVisibility, com.google.gwt.user.client.ui.HasWidgets, com.google.gwt.user.client.ui.HasWidgets.ForIsWidget, com.google.gwt.user.client.ui.IndexedPanel, com.google.gwt.user.client.ui.IndexedPanel.ForIsWidget, com.google.gwt.user.client.ui.IsWidget, com.smartgwt.mobile.client.internal.test.AutoTestLocatable, com.smartgwt.mobile.client.internal.widgets.events.HasValuesSelectedHandlers, com.smartgwt.mobile.client.internal.widgets.events.ValuesSelectedHandler, com.smartgwt.mobile.client.internal.widgets.form.fields.CanCopyFieldConfiguration, HasClickHandlers, HasShowContextMenuHandlers, HasBlurHandlers, HasChangedHandlers, HasDataValue, java.lang.Iterable<com.google.gwt.user.client.ui.Widget>

Direct Known Subclasses:

ButtonItem, CheckboxItem, DateItem, DateTimeItem, HiddenItem, SliderItem, SpacerItem, StaticTextItem, SubmitItem, SwitchItem, TextAreaItem, TextItem, TimeItem, UploadItem

public class FormItem
extends AbstractHasDataValue
implements com.smartgwt.mobile.client.internal.widgets.events.ValuesSelectedHandler, HasBlurHandlers, HasChangedHandlers, com.google.gwt.event.dom.client.HasKeyPressHandlers, com.smartgwt.mobile.client.internal.widgets.events.HasValuesSelectedHandlers

Nested Class Summary

Nested classes/interfaces inherited from class com.google.gwt.user.client.ui.UIObject

com.google.gwt.user.client.ui.UIObject.DebugIdImpl, com.google.gwt.user.client.ui.UIObject.DebugIdImplEnabled

Nested classes/interfaces inherited from interface com.google.gwt.user.client.ui.IndexedPanel

com.google.gwt.user.client.ui.IndexedPanel.ForIsWidget

Nested classes/interfaces inherited from interface com.google.gwt.user.client.ui.HasWidgets

com.google.gwt.user.client.ui.HasWidgets.ForIsWidget

Field Summary

Fields inherited from class com.smartgwt.mobile.client.widgets.Canvas

_CONTENT_CHANGED_EVENT_TYPE, _CSS, _HISTORY_ENABLED, _REQUEST_SCROLL_TO_EVENT_TYPE, id, touched

Fields inherited from class com.google.gwt.user.client.ui.UIObject

DEBUG_ID_PREFIX

Constructor Summary

Constructors

Modifier	Constructor and Description
	FormItem(java.lang.String name)
protected	FormItem(java.lang.String name, com.google.gwt.dom.client.Element elem)
	FormItem(java.lang.String name, java.lang.String title)

Method Summary

Modifier and Type	Method and Description
com.google.gwt.event.shared.HandlerRegistration	_addValuesSelectedHandler(com.smartgwt.mobile.client.internal.widgets.events.ValuesSelectedHandler handler)
void	_checkForEditorExit()
void	_copyFieldConfiguration(DataSourceField field)
protected com.smartgwt.mobile.client.internal.widgets.Picker2	_createPicker()
boolean	_elementBlur()
java.lang.Object	_formatDataType(java.lang.Object value)
com.smartgwt.mobile.client.internal.test.AutoTestLocatable	_getChildFromLocatorSubstring(java.lang.String substring, int index, java.util.List<java.lang.String> locatorArray, com.smartgwt.mobile.client.internal.test.GetAttributeConfiguration configuration)
DateDisplayFormat	_getDateFormatter()
DateDisplayFormat	_getDatetimeFormatter()
java.lang.Object	_getDefaultValue()
java.lang.Object	_getDisplayValue(java.lang.Object value)
java.lang.String	_getEmptyDisplayValue()
java.lang.Object	_getInnerAttributeFromSplitLocator(java.util.List<java.lang.String> locatorArray, com.smartgwt.mobile.client.internal.test.GetAttributeConfiguration configuration)
com.google.gwt.dom.client.Element	_getInputElement()
java.lang.String	_getMultipleValueSeparator()
com.smartgwt.mobile.client.internal.widgets.Picker2	_getPicker()
boolean	_getRequired()
boolean	_getShowHint()
boolean	_getShowHintInField()
TimeDisplayFormat	_getTimeFormatter()
protected java.util.LinkedHashMap<?,java.lang.String>	_getValueMap()
void	_handleEditorExit()
void	_handleInput()
boolean	_isPickerEnabled()
boolean	_isReadOnly()
java.lang.Boolean	_isSetToDefaultValue()
java.lang.Object	_mapDisplayToValue(java.lang.String displayValue)
java.lang.Object	_mapKey(java.lang.Object key, boolean dontReturnKey)
java.lang.Object	_mapValueToDisplay(java.lang.Object value)
boolean	_nativeElementBlur()
protected void	_onEnd(com.google.gwt.user.client.Event event)
protected void	_onStart(com.google.gwt.user.client.Event event, com.google.gwt.dom.client.Touch touch)
void	_onValuesSelected(com.smartgwt.mobile.client.internal.widgets.events.ValuesSelectedEvent event)
java.lang.Object	_parseDisplayValue(java.lang.String displayValue)
void	_refreshDisplayValue()
void	_setElementReadOnly(boolean readOnly)
void	_setElementValue(java.lang.Object displayValue, java.lang.Object newValue)
boolean	_shouldApplyStaticTypeFormat()
boolean	_storeValue(java.lang.Object newValue)
java.lang.Object	_unmapKey(java.lang.Object value)
void	_updateDateFormatter()
void	_updateValue()
void	_updateValue(java.lang.Object newValue)
com.google.gwt.event.shared.HandlerRegistration	addBlurHandler(BlurHandler handler)
com.google.gwt.event.shared.HandlerRegistration	addChangedHandler(ChangedHandler handler)
com.google.gwt.event.shared.HandlerRegistration	addKeyPressHandler(com.google.gwt.event.dom.client.KeyPressHandler handler)
Criterion	getCriterion()
DateDisplayFormat	getDateFormatter() The format in which dates are displayed for this item.
DateDisplayFormat	getDatetimeFormatter() The format in which datetimes are displayed for this item.
java.lang.String	getDisplayField()
java.lang.String	getDisplayFieldName()
FormItemValueFormatter	getEditorValueFormatter()
FormItemValueParser	getEditorValueParser()
java.lang.String	getEmptyDisplayValue()
DynamicForm	getForm()
java.lang.String	getHint()
java.lang.String	getName() Alias for AbstractHasDataValue.getFieldName().
DataSource	getOptionDataSource()
java.lang.Boolean	getRequired()
java.lang.Boolean	getShowHint()
Alignment	getTextAlign()
TimeDisplayFormat	getTimeFormatter() The format in which times are displayed for this item.
java.lang.Object	getValue()
java.lang.String	getValueField()
java.lang.String	getValueFieldName()
FormItemValueFormatter	getValueFormatter()
void	onBrowserEvent(com.google.gwt.user.client.Event event)
protected void	onChanged(com.google.gwt.user.client.Event event)
protected void	onUnload()
void	setDataManager(DataManager dataManager) Sets the associated DataManager instance.
void	setDateFormatter(DateDisplayFormat dateFormatter)
void	setDatetimeFormatter(DateDisplayFormat datetimeFormatter)
void	setDefaultValue(java.lang.Object defaultValue)
void	setDisplayField(java.lang.String displayField)
void	setEditorValueFormatter(FormItemValueFormatter editorValueFormatter)
void	setEditorValueParser(FormItemValueParser editorValueParser)
protected void	setElement(com.google.gwt.user.client.Element elem)
void	setEmptyDisplayValue(java.lang.String emptyDisplayValue)
protected void	setFieldName(java.lang.String fieldName)
void	setHint(java.lang.String hint)
void	setName(java.lang.String name)
void	setOptionDataSource(DataSource ds)
void	setRequired(java.lang.Boolean required)
void	setShowHint(java.lang.Boolean showHint)
void	setTextAlign(Alignment textAlign)
void	setTimeFormatter(TimeDisplayFormat timeFormatter)
void	setValue(java.lang.Object newValue)
protected java.lang.Object	setValue(java.lang.Object newValue, boolean allowNullValue, boolean timeCritical)
void	setValueField(java.lang.String valueField)
void	setValueFormatter(FormItemValueFormatter valueFormatter)
void	setValueMap(java.util.LinkedHashMap<?,java.lang.String> valueMap) Set the valueMap for this item.
void	setValueMap(java.lang.String... values)
void	showPicker()
void	showValue(java.lang.Object value) Called by the DataManager to notify this HasDataValue that the DataManager's value for this HasDataValue was changed and that this HasDataValue needs to update its display field to the given value.
void	updateCanEdit() Default implementation of HasDataValue.updateCanEdit().
boolean	validate()

Methods inherited from class com.smartgwt.mobile.client.widgets.form.fields.AbstractHasDataValue

compareValues, getCanEdit, getDataManager, getFieldName, getRealShowTitle, getShowTitle, getStopOnError, getTitle, getValidators, setCanEdit, setShowTitle, setStopOnError, setTitle, setValidators

Methods inherited from class com.smartgwt.mobile.client.widgets.Canvas

_add, _booleanValue, _fireContentChangedEvent, _fireContentChangedEvent, _fireRequestScrollToEvent, _getAndroidWindowSoftInputMode, _getAttributeFromSplitLocator, _getFixNavigationBarPositionDuringKeyboardFocus, _getHideTabBarDuringKeyboardFocus, _getInnerElement, _hideAddressBar, _hideAddressBarNow, _insert, _isDifferent, _isHDPIDisplay, _isIOS4OrOlder, _isIOS5, _isIOSMin6_0, _isStandaloneMode, _nativeParseFloat, _removeClassName, _setClassName, _setHandleDisabled, _sinkAnimationEndEvent, _sinkContentChangedEvent, _sinkFocusInEvent, _sinkFocusOutEvent, _sinkInputEvent, _sinkRequestScrollToEvent, _sinkTransitionEndEvent, _triggerDebugger, addChild, addChild, addChild, addClickHandler, addShowContextMenuHandler, destroy, disable, enable, getContextMenu, getID, getInnerHTML, getMargin, hasChild, hasChild, isAndroid, isDisabled, isEnabled, isIPad, isIPhone, isSafari, isStandAlone, isUIWebView, parseDimension, removeChild, removeChild, setContents, setContextMenu, setDisabled, setID, setMargin, setStyleName, split, useIOSNativeScrolling

Methods inherited from class com.google.gwt.user.client.ui.ComplexPanel

add, add, adjustIndex, checkIndexBoundsForAccess, checkIndexBoundsForInsertion, getChildren, getWidget, getWidgetCount, getWidgetIndex, getWidgetIndex, insert, insert, iterator, remove, remove

Methods inherited from class com.google.gwt.user.client.ui.Panel

add, add, adopt, clear, doAttachChildren, doDetachChildren, orphan, remove

Methods inherited from class com.google.gwt.user.client.ui.Widget

addAttachHandler, addBitlessDomHandler, addDomHandler, addHandler, asWidget, asWidgetOrNull, createHandlerManager, delegateEvent, fireEvent, getHandlerCount, getLayoutData, getParent, isAttached, isOrWasAttached, onAttach, onDetach, onLoad, removeFromParent, setLayoutData, sinkEvents, unsinkEvents

Methods inherited from class com.google.gwt.user.client.ui.UIObject

addStyleDependentName, addStyleName, ensureDebugId, ensureDebugId, ensureDebugId, getAbsoluteLeft, getAbsoluteTop, getElement, getOffsetHeight, getOffsetWidth, getStyleElement, getStyleName, getStyleName, getStylePrimaryName, getStylePrimaryName, isVisible, isVisible, onEnsureDebugId, removeStyleDependentName, removeStyleName, resolvePotentialElement, setElement, setHeight, setPixelSize, setSize, setStyleDependentName, setStyleName, setStyleName, setStyleName, setStylePrimaryName, setStylePrimaryName, setVisible, setVisible, setWidth, sinkBitlessEvent, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.google.gwt.event.shared.HasHandlers

fireEvent

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

FormItem

public FormItem(java.lang.String name)

FormItem

public FormItem(java.lang.String name,
                java.lang.String title)

FormItem

@SGWTInternal
protected FormItem(java.lang.String name,
                                 com.google.gwt.dom.client.Element elem)

Method Detail

onUnload

protected void onUnload()

Overrides:

onUnload in class com.google.gwt.user.client.ui.Widget

_getChildFromLocatorSubstring

public com.smartgwt.mobile.client.internal.test.AutoTestLocatable _getChildFromLocatorSubstring(java.lang.String substring,
                                                                                                int index,
                                                                                                java.util.List<java.lang.String> locatorArray,
                                                                                                com.smartgwt.mobile.client.internal.test.GetAttributeConfiguration configuration)

Specified by:

_getChildFromLocatorSubstring in interface com.smartgwt.mobile.client.internal.test.AutoTestLocatable

Overrides:

_getChildFromLocatorSubstring in class Canvas

_getInnerAttributeFromSplitLocator

public java.lang.Object _getInnerAttributeFromSplitLocator(java.util.List<java.lang.String> locatorArray,
                                                           com.smartgwt.mobile.client.internal.test.GetAttributeConfiguration configuration)

Specified by:

_getInnerAttributeFromSplitLocator in interface com.smartgwt.mobile.client.internal.test.AutoTestLocatable

Overrides:

_getInnerAttributeFromSplitLocator in class Canvas

_copyFieldConfiguration

public void _copyFieldConfiguration(DataSourceField field)

Specified by:

_copyFieldConfiguration in interface com.smartgwt.mobile.client.internal.widgets.form.fields.CanCopyFieldConfiguration

Overrides:

_copyFieldConfiguration in class AbstractHasDataValue

_handleInput

@SGWTInternal
public void _handleInput()

getForm

public final DynamicForm getForm()

getCriterion

public Criterion getCriterion()

setDataManager

public void setDataManager(DataManager dataManager)

Description copied from interface: HasDataValue

Sets the associated DataManager instance.

This HasDataValue instance uses the DataManager to post notifications of changes to its value caused by user action.

Specified by:

setDataManager in interface HasDataValue

Overrides:

setDataManager in class AbstractHasDataValue

Parameters:

dataManager - the associated DataManager.

See Also:

DataManager.storeValue(String, Object)

getDateFormatter

public final DateDisplayFormat getDateFormatter()

The format in which dates are displayed for this item.

NOTE: In the case of a DateItem, this setting does not have an effect if using a native HTML5 date input.

_getDateFormatter

@SGWTInternal
public final DateDisplayFormat _getDateFormatter()

setDateFormatter

public void setDateFormatter(DateDisplayFormat dateFormatter)

getDatetimeFormatter

public final DateDisplayFormat getDatetimeFormatter()

The format in which datetimes are displayed for this item.

NOTE: In the case of a DateTimeItem, this setting does not have an effect if using a native HTML5 datetime input.

_getDatetimeFormatter

@SGWTInternal
public final DateDisplayFormat _getDatetimeFormatter()

setDatetimeFormatter

public void setDatetimeFormatter(DateDisplayFormat datetimeFormatter)

_getDefaultValue

@SGWTInternal
public final java.lang.Object _getDefaultValue()

setDefaultValue

public void setDefaultValue(java.lang.Object defaultValue)

getDisplayField

public final java.lang.String getDisplayField()

setDisplayField

public void setDisplayField(java.lang.String displayField)

getDisplayFieldName

public final java.lang.String getDisplayFieldName()

_getDisplayValue

@SGWTInternal
public java.lang.Object _getDisplayValue(java.lang.Object value)

getEditorValueFormatter

public final FormItemValueFormatter getEditorValueFormatter()

setEditorValueFormatter

public void setEditorValueFormatter(FormItemValueFormatter editorValueFormatter)

getEditorValueParser

public final FormItemValueParser getEditorValueParser()

setEditorValueParser

public void setEditorValueParser(FormItemValueParser editorValueParser)

setElement

protected void setElement(com.google.gwt.user.client.Element elem)

Overrides:

setElement in class Canvas

getEmptyDisplayValue

public final java.lang.String getEmptyDisplayValue()

_getEmptyDisplayValue

@SGWTInternal
public final java.lang.String _getEmptyDisplayValue()

setEmptyDisplayValue

public void setEmptyDisplayValue(java.lang.String emptyDisplayValue)

setFieldName

protected void setFieldName(java.lang.String fieldName)

Overrides:

setFieldName in class AbstractHasDataValue

getHint

public final java.lang.String getHint()

setHint

public void setHint(java.lang.String hint)

_getInputElement

@SGWTInternal
public com.google.gwt.dom.client.Element _getInputElement()

_getMultipleValueSeparator

@SGWTInternal
public final java.lang.String _getMultipleValueSeparator()

getName

public final java.lang.String getName()

Alias for AbstractHasDataValue.getFieldName().

Returns:

the field's name.

setName

public final void setName(java.lang.String name)

getOptionDataSource

public final DataSource getOptionDataSource()

setOptionDataSource

public void setOptionDataSource(DataSource ds)

_getPicker

@SGWTInternal
public final com.smartgwt.mobile.client.internal.widgets.Picker2 _getPicker()

_isReadOnly

@SGWTInternal
public final boolean _isReadOnly()

updateCanEdit

public void updateCanEdit()

Description copied from class: AbstractHasDataValue

Default implementation of HasDataValue.updateCanEdit(). If overridden, be sure to call super.updateCanEdit().

Specified by:

updateCanEdit in interface HasDataValue

Overrides:

updateCanEdit in class AbstractHasDataValue

_setElementReadOnly

@SGWTInternal
public void _setElementReadOnly(boolean readOnly)

getRequired

public final java.lang.Boolean getRequired()

_getRequired

@SGWTInternal
public final boolean _getRequired()

setRequired

public void setRequired(java.lang.Boolean required)

_isSetToDefaultValue

@SGWTInternal
public final java.lang.Boolean _isSetToDefaultValue()

getShowHint

public final java.lang.Boolean getShowHint()

_getShowHint

@SGWTInternal
public final boolean _getShowHint()

setShowHint

public void setShowHint(java.lang.Boolean showHint)

_getShowHintInField

@SGWTInternal
public boolean _getShowHintInField()

getTextAlign

public final Alignment getTextAlign()

setTextAlign

public void setTextAlign(Alignment textAlign)

getTimeFormatter

public final TimeDisplayFormat getTimeFormatter()

The format in which times are displayed for this item.

NOTE: In the case of a TimeItem, this setting does not have an effect if using a native HTML5 time input.

_getTimeFormatter

@SGWTInternal
public final TimeDisplayFormat _getTimeFormatter()

setTimeFormatter

public void setTimeFormatter(TimeDisplayFormat timeFormatter)

getValue

public java.lang.Object getValue()

setValue

public void setValue(java.lang.Object newValue)

setValue

protected java.lang.Object setValue(java.lang.Object newValue,
                                    boolean allowNullValue,
                                    boolean timeCritical)

getValueField

public final java.lang.String getValueField()

setValueField

public void setValueField(java.lang.String valueField)

getValueFieldName

public final java.lang.String getValueFieldName()

_checkForEditorExit

@SGWTInternal
public void _checkForEditorExit()

_elementBlur

@SGWTInternal
public boolean _elementBlur()

_formatDataType

@SGWTInternal
public java.lang.Object _formatDataType(java.lang.Object value)

_handleEditorExit

@SGWTInternal
public void _handleEditorExit()

_mapDisplayToValue

@SGWTInternal
public java.lang.Object _mapDisplayToValue(java.lang.String displayValue)

_mapKey

@SGWTInternal
public java.lang.Object _mapKey(java.lang.Object key,
                                              boolean dontReturnKey)

_mapValueToDisplay

@SGWTInternal
public java.lang.Object _mapValueToDisplay(java.lang.Object value)

_nativeElementBlur

@SGWTInternal
public boolean _nativeElementBlur()

_parseDisplayValue

@SGWTInternal
public java.lang.Object _parseDisplayValue(java.lang.String displayValue)

_refreshDisplayValue

@SGWTInternal
public void _refreshDisplayValue()

_shouldApplyStaticTypeFormat

@SGWTInternal
public boolean _shouldApplyStaticTypeFormat()

showValue

public void showValue(java.lang.Object value)

Description copied from interface: HasDataValue

Called by the DataManager to notify this HasDataValue that the DataManager's value for this HasDataValue was changed and that this HasDataValue needs to update its display field to the given value.

NOTE: An implementation must not call the associated DataManager's DataManager.storeValue(String, Object) method.

Specified by:

showValue in interface HasDataValue

Specified by:

showValue in class AbstractHasDataValue

Parameters:

value - the new value.

_updateValue

@SGWTInternal
public void _updateValue()

_updateValue

@SGWTInternal
public void _updateValue(java.lang.Object newValue)

_storeValue

@SGWTInternal
public boolean _storeValue(java.lang.Object newValue)

_setElementValue

@SGWTInternal
public void _setElementValue(java.lang.Object displayValue,
                                           java.lang.Object newValue)

getValueFormatter

public final FormItemValueFormatter getValueFormatter()

setValueFormatter

public void setValueFormatter(FormItemValueFormatter valueFormatter)

_getValueMap

@SGWTInternal
protected final java.util.LinkedHashMap<?,java.lang.String> _getValueMap()

setValueMap

public final void setValueMap(java.lang.String... values)

setValueMap

public void setValueMap(java.util.LinkedHashMap<?,java.lang.String> valueMap)

Set the valueMap for this item.

Note: the keys of valueMap must be normalized according to the rules applied by ObjectUtil.normalize(Object).

Parameters:

valueMap - the value map.

onBrowserEvent

public void onBrowserEvent(com.google.gwt.user.client.Event event)

Specified by:

onBrowserEvent in interface com.google.gwt.user.client.EventListener

Overrides:

onBrowserEvent in class Canvas

_onStart

@SGWTInternal
protected void _onStart(com.google.gwt.user.client.Event event,
                                      com.google.gwt.dom.client.Touch touch)

_onEnd

@SGWTInternal
protected void _onEnd(com.google.gwt.user.client.Event event)

onChanged

protected void onChanged(com.google.gwt.user.client.Event event)

_isPickerEnabled

@SGWTInternal
public boolean _isPickerEnabled()

_createPicker

@SGWTInternal
protected com.smartgwt.mobile.client.internal.widgets.Picker2 _createPicker()

showPicker

public void showPicker()

_onValuesSelected

public void _onValuesSelected(com.smartgwt.mobile.client.internal.widgets.events.ValuesSelectedEvent event)

Specified by:

_onValuesSelected in interface com.smartgwt.mobile.client.internal.widgets.events.ValuesSelectedHandler

_unmapKey

@SGWTInternal
public java.lang.Object _unmapKey(java.lang.Object value)

_updateDateFormatter

@SGWTInternal
public void _updateDateFormatter()

validate

public boolean validate()

addBlurHandler

public com.google.gwt.event.shared.HandlerRegistration addBlurHandler(BlurHandler handler)

Specified by:

addBlurHandler in interface HasBlurHandlers

addChangedHandler

public com.google.gwt.event.shared.HandlerRegistration addChangedHandler(ChangedHandler handler)

Specified by:

addChangedHandler in interface HasChangedHandlers

addKeyPressHandler

public com.google.gwt.event.shared.HandlerRegistration addKeyPressHandler(com.google.gwt.event.dom.client.KeyPressHandler handler)

Specified by:

addKeyPressHandler in interface com.google.gwt.event.dom.client.HasKeyPressHandlers

_addValuesSelectedHandler

public com.google.gwt.event.shared.HandlerRegistration _addValuesSelectedHandler(com.smartgwt.mobile.client.internal.widgets.events.ValuesSelectedHandler handler)

Specified by:

_addValuesSelectedHandler in interface com.smartgwt.mobile.client.internal.widgets.events.HasValuesSelectedHandlers