public class TextAreaItem extends FormItem
<TEXTAREA> object)FormItem.CustomStateGetter, FormItem.StateCustomizerconfigOnly, scClassName, warnOnEditorTypeConversion, warnOnEditorTypeConversionDefaultidfactoryCreated, factoryProperties| Constructor and Description |
|---|
TextAreaItem() |
TextAreaItem(com.google.gwt.core.client.JavaScriptObject jsObj) |
TextAreaItem(java.lang.String name) |
TextAreaItem(java.lang.String name,
java.lang.String title) |
| Modifier and Type | Method and Description |
|---|---|
static void |
changeAutoChildDefaults(java.lang.String autoChildName,
Canvas defaults)
Changes the defaults for Canvas AutoChildren named
autoChildName. |
static void |
changeAutoChildDefaults(java.lang.String autoChildName,
FormItem defaults)
Changes the defaults for FormItem AutoChildren named
autoChildName. |
static void |
changePickerIconDefaults(FormItemIcon defaults) |
void |
deselectValue()
If this item currently has focus, clear the current selection.
|
void |
deselectValue(java.lang.Boolean start)
If this item currently has focus, clear the current selection.
|
java.lang.Boolean |
getBrowserAutoCapitalize() |
java.lang.Boolean |
getBrowserAutoCorrect()
In Mobile Safari, should automatic correction be offered for text in the item's text box? If
null, then
Mobile Safari determines automatically whether to enable autocorrect. |
java.lang.Boolean |
getChangeOnKeypress()
Should this form item fire its
change handler
(and store its value in the form) on every keypress? Set to false to suppress the 'change' handler firing
(and the value stored) on every keypress. |
java.lang.String |
getEditProxyConstructor()
Default class used to construct the
EditProxy for this component when the component is
first placed into edit mode. |
boolean |
getEnforceLength()
If a
length is specified for this item, should
user input be limited to the specified length? If set to true, user input and values passed to setValue() will be trimmed to the specified length. |
java.lang.String |
getEnteredValue()
Returns the raw text value that currently appears in the text field, which can differ from
FormItem.getValue() in various cases - for example:
for items that constrain the value range, such as a DateItem with
enforceDate:true, or a ComboBoxItem with addUnknownValues:false for items with
a defined valueMap or edit value formatter and parser functions which converts display value to data value
while the item has focus if changeOnKeypress is false |
java.lang.Boolean |
getEscapeHTML()
By default HTML characters will be escaped when
canEdit is false and readOnlyDisplay is
"static", so that the raw value of the field (for example "<b>AAA</b>") is displayed to the
user rather than the interpreted HTML (for example "AAA"). |
java.lang.Boolean |
getFormatOnBlur()
With
formatOnBlur enabled, this textAreaItem will format its value according to the rules described in
FormItem.mapValueToDisplay() as long as the
item does not have focus. |
int |
getHeight()
Default height of this item
|
VerticalAlignment |
getIconVAlign()
Align icons with the top edge of text area icons by default.
|
java.lang.Integer |
getLength()
If set, maximum number of characters for this field.
|
int |
getMinHeight()
Minimum valid height for this TextAreaItem in px.
|
static TextAreaItem |
getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj) |
java.lang.Integer |
getPickerIconHeight()
TextAreaItem has an explicit pickerIconHeight as we don't want the picker icon, if shown, to size itself to match the
height of the item.
|
java.lang.Boolean |
getPrintFullText()
When generating a print-view of the component containing this TextArea, should the form item expand to accommodate its
value? If set to false the text box not expand to fit its content in the print view, instead showing exactly as it does
in the live form, possibly with scrollbars.
|
int[] |
getSelectionRange()
For text-based items, this method returns the indices of the start/end of the current selection if the item currently
has the focus.
|
java.lang.Boolean |
getSelectOnClick()
Allows the
selectOnClick behavior to be configured
on a per-FormItem basis. |
java.lang.Boolean |
getSelectOnFocus()
Allows the
selectOnFocus behavior to be configured
on a per-FormItem basis. |
java.lang.Boolean |
getShowHintInField()
If
showing a hint for this form item, should the
hint be shown
within the field? |
boolean |
getShowInputElement()
When set to false, prevents this item's input element from being written into the DOM.
|
java.lang.Integer |
getStaticHeight()
Height of the FormItem when
canEdit is false and readOnlyDisplay is "static". |
boolean |
getSupportsCutPasteEvents()
Does the current formItem support native cut and paste events?
|
java.lang.String |
getTextBoxStyle()
Base CSS class to apply to this item's input element.
|
boolean |
getUsePlaceholderForHint()
If
showing the hint in field and if
supported by the browser, should the HTML5
placeholder attribute
be used to display the hint within the field? If set to false, then use of
the placeholder attribute is disabled and an alternative technique to display
the hint in-field is used instead. |
java.lang.String |
getValueAsString()
Return the value tracked by this form item.
|
int |
getWidth()
default width of this item
|
TextAreaWrap |
getWrap()
Text wrapping style.
|
void |
selectValue()
Put focus in this item and select the entire value.
|
TextAreaItem |
setBrowserAutoCapitalize(java.lang.Boolean browserAutoCapitalize)
Note : This is an advanced setting
|
TextAreaItem |
setBrowserAutoCorrect(java.lang.Boolean browserAutoCorrect)
In Mobile Safari, should automatic correction be offered for text in the item's text box? If
null, then
Mobile Safari determines automatically whether to enable autocorrect. |
TextAreaItem |
setChangeOnKeypress(java.lang.Boolean changeOnKeypress)
Should this form item fire its
change handler
(and store its value in the form) on every keypress? Set to false to suppress the 'change' handler firing
(and the value stored) on every keypress. |
static void |
setDefaultProperties(TextAreaItem textAreaItemProperties)
Class level method to set the default properties of this class.
|
TextAreaItem |
setEditProxyConstructor(java.lang.String editProxyConstructor)
Default class used to construct the
EditProxy for this component when the component is
first placed into edit mode. |
TextAreaItem |
setEnforceLength(boolean enforceLength)
If a
length is specified for this item, should
user input be limited to the specified length? If set to true, user input and values passed to setValue() will be trimmed to the specified length. |
TextAreaItem |
setEscapeHTML(java.lang.Boolean escapeHTML)
By default HTML characters will be escaped when
canEdit is false and readOnlyDisplay is
"static", so that the raw value of the field (for example "<b>AAA</b>") is displayed to the
user rather than the interpreted HTML (for example "AAA"). |
TextAreaItem |
setFormatOnBlur(java.lang.Boolean formatOnBlur)
With
formatOnBlur enabled, this textAreaItem will format its value according to the rules described in
FormItem.mapValueToDisplay() as long as the
item does not have focus. |
TextAreaItem |
setHeight(int height)
Default height of this item
|
TextAreaItem |
setIconVAlign(VerticalAlignment iconVAlign)
Align icons with the top edge of text area icons by default.
|
TextAreaItem |
setLength(java.lang.Integer length)
If set, maximum number of characters for this field.
|
TextAreaItem |
setMinHeight(int minHeight)
Minimum valid height for this TextAreaItem in px.
|
TextAreaItem |
setPickerIconHeight(java.lang.Integer pickerIconHeight)
TextAreaItem has an explicit pickerIconHeight as we don't want the picker icon, if shown, to size itself to match the
height of the item.
|
TextAreaItem |
setPrintFullText(java.lang.Boolean printFullText)
When generating a print-view of the component containing this TextArea, should the form item expand to accommodate its
value? If set to false the text box not expand to fit its content in the print view, instead showing exactly as it does
in the live form, possibly with scrollbars.
|
void |
setSelectionRange(int start,
int end)
Puts focus into this form item and selects characters between the given indices.
|
TextAreaItem |
setSelectOnClick(java.lang.Boolean selectOnClick)
Allows the
selectOnClick behavior to be configured
on a per-FormItem basis. |
TextAreaItem |
setSelectOnFocus(java.lang.Boolean selectOnFocus)
Allows the
selectOnFocus behavior to be configured
on a per-FormItem basis. |
TextAreaItem |
setShowHintInField(java.lang.Boolean showHintInField)
If
showing a hint for this form item, should the
hint be shown
within the field? |
TextAreaItem |
setShowInputElement(boolean showInputElement)
When set to false, prevents this item's input element from being written into the DOM.
|
TextAreaItem |
setStaticHeight(java.lang.Integer staticHeight)
Height of the FormItem when
canEdit is false and readOnlyDisplay is "static". |
TextAreaItem |
setSupportsCutPasteEvents(boolean supportsCutPasteEvents)
Does the current formItem support native cut and paste events?
|
TextAreaItem |
setTextBoxStyle(java.lang.String textBoxStyle)
Base CSS class to apply to this item's input element.
|
TextAreaItem |
setUsePlaceholderForHint(boolean usePlaceholderForHint)
If
showing the hint in field and if
supported by the browser, should the HTML5
placeholder attribute
be used to display the hint within the field? If set to false, then use of
the placeholder attribute is disabled and an alternative technique to display
the hint in-field is used instead. |
TextAreaItem |
setWidth(int width)
default width of this item
|
void |
setWrap(TextAreaWrap wrap)
Text wrapping style.
|
java.lang.String |
transformPastedValue(FormItem item,
DynamicForm form,
java.lang.String pastedValue)
Notification fired in response to a clipboard "paste" event on freeform text items, giving developers an opportunity to
reformat the pasted text.
|
_getValue, addBlurHandler, addChangedHandler, addChangeHandler, addClickHandler, addDoubleClickHandler, addEditorEnterHandler, addEditorExitHandler, addFocusHandler, addIcon, addIcon, addIconClickHandler, addIconKeyPressHandler, addItemHoverHandler, addKeyDownHandler, addKeyPressHandler, addKeyUpHandler, addPendingStatusChangedHandler, addPickerIconClickHandler, addShowContextMenuHandler, addTitleClickHandler, addTitleDoubleClickHandler, addTitleHoverHandler, addValueHoverHandler, addValueIconClickHandler, applyFormula, asSGWTComponent, blurItem, canEditCriterion, clearErrors, clearValue, disable, disableIcon, enable, enableIcon, error, error, errorIfNotCreated, focusAfterItem, focusInItem, getAccessKey, getAlign, getAllowExpressions, getAlwaysFetchMissingValues, getAlwaysShowControlBox, getApplyAlignToText, getApplyHeightToTextBox, getAriaRole, getAttribute, getAttributeAsBoolean, getAttributeAsBoolean, getAttributeAsDate, getAttributeAsDouble, getAttributeAsFloat, getAttributeAsInt, getAttributeAsJavaScriptObject, getAttributeAsObject, getAttributeAsString, getAutoComplete, getAutoCompleteKeywords, getBrowserInputType, getBrowserSpellCheck, getCanEdit, getCanEditOpaqueValues, getCanFocus, getCanSelectText, getCanTabToIcons, getCanvasAutoChild, getCellHeight, getCellStyle, getClassName, getClipStaticValue, getClipTitle, getConfig, getContainerWidget, getControlStyle, getCriteriaField, getCriterion, getCriterion, getCursorPosition, getCustomState, getDataPath, getDateFormatter, getDecimalPad, getDecimalPrecision, getDefaultIconSrc, getDefaultOperator, getDestroyed, getDisabled, getDisabledHover, getDisableIconsOnReadOnly, getDisplayField, getDisplayFieldName, getDisplayValue, getDisplayValue, getEditorTypeConfig, getEditPendingCSSText, getEmptyDisplayValue, getEmptyValueIcon, getEndRow, getErrorIconHeight, getErrorIconSrc, getErrorIconWidth, getErrorMessageWidth, getErrors, getExportFormat, getFetchMissingValues, getFieldName, getFilterLocally, getForeignDisplayField, getForm, getFormat, getFormItemAutoChild, getFormula, getFullDataPath, getGlobalTabIndex, getGridColNum, getGridRowNum, getHeightAsString, getHidden, getHint, getHintStyle, getHoverAlign, getHoverDelay, getHoverFocusKey, getHoverHeight, getHoverHeightAsString, getHoverOpacity, getHoverPersist, getHoverStyle, getHoverVAlign, getHoverWidth, getHoverWidthAsString, getIcon, getIconHeight, getIconHSpace, getIconPageRect, getIconPrompt, getIconRect, getIcons, getIconTabPosition, getIconWidth, getID, getImageURLPrefix, getImageURLSuffix, getImplicitSave, getImplicitSaveOnBlur, getInputFormat, getLeft, getLinearColSpan, getLinearColSpanAsString, getLinearEndRow, getLinearEndRowAsString, getLinearStartRow, getLinearStartRowAsString, getLinearWidth, getLinearWidthAsString, getListGrid, getLoadingDisplayValue, getLocateItemBy, getMinHintWidth, getMultiple, getMultipleValueSeparator, getName, getNullOriginalValueText, getOperator, getOptionCriteria, getOptionDataSource, getOptionDataSourceAsString, getOptionFilterContext, getOptionOperationId, getOptionTextMatchStyle, getOriginalValueMessage, getPageLeft, getPageRect, getPageTop, getPaletteDefaults, getPicker, getPickerIcon, getPickerIcon, getPickerIconName, getPickerIconPrompt, getPickerIconProperties, getPickerIconSrc, getPickerIconStyle, getPickerIconTabPosition, getPickerIconWidth, getPixelHeight, getPixelWidth, getPrintReadOnlyTextBoxStyle, getPrintTextBoxStyle, getPrintTitleStyle, getPrompt, getReadOnlyCanSelectText, getReadOnlyControlStyle, getReadOnlyDisplay, getReadOnlyHover, getReadOnlyTextBoxStyle, getReadOnlyWhen, getRect, getRedrawOnChange, getRejectInvalidValueOnChange, getRequired, getRequiredMessage, getRequiredWhen, getRowSpan, getSaveOnEnter, getScClassName, getSelectedRecord, getShouldSaveValue, getShowClippedTitleOnHover, getShowClippedValueOnHover, getShowDeletions, getShowDisabled, getShowDisabledIconsOnFocus, getShowDisabledPickerIconOnFocus, getShowErrorIcon, getShowErrorStyle, getShowErrorText, getShowFocused, getShowFocusedErrorState, getShowFocusedIcons, getShowFocusedPickerIcon, getShowHint, getShowIcons, getShowIconsOnFocus, getShowImageAsURL, getShowOldValueInHover, getShowOver, getShowOverIcons, getShowPending, getShowPickerIcon, getShowPickerIconOnFocus, getShowRTL, getShowTitle, getShowValueIconOnly, getStartRow, getStopOnError, getStoreDisplayValues, getSuppressValueIcon, getSynchronousValidation, getTabIndex, getTextAlign, getTextFormula, getTimeFormatter, getTitle, getTitleAlign, getTitleColSpan, getTitleOrientation, getTitleStyle, getTitleVAlign, getTooltip, getTop, getType, getUpdateControlOnOver, getUpdatePickerIconOnOver, getUpdateTextBoxOnOver, getUseAdvancedCriteria, getUseDisabledHintStyleForReadOnly, getUseLocalDisplayFieldValue, getValidateOnChange, getValidateOnExit, getValidOperators, getVAlign, getValue, getValueAsFloat, getValueAsInteger, getValueAsLong, getValueAsRecordList, getValueDeselectedCSSText, getValueField, getValueFieldName, getValueIconHeight, getValueIconLeftPadding, getValueIconRightPadding, getValueIconSize, getValueIconWidth, getValueMap, getValueMapAsArray, getVisible, getVisibleHeight, getVisibleTitleWidth, getVisibleWhen, getVisibleWidth, getWarnOnEditorTypeConversion, getWarnOnEditorTypeConversionDefault, getWidthAsString, getWrapHintText, getWrapStaticValue, getWrapTitle, handleWarnOnEditorTypeConversion, hasAdvancedCriteria, hasErrors, hide, hideIcon, invalidateDisplayValueCache, isConfigOnly, isCreated, isCutEvent, isDisabled, isDrawn, isFocused, isInGrid, isPasteEvent, isVisible, linkToInstanceUponCreate, mapDisplayToValue, mapValueToDisplay, mapValueToDisplay, mapValueToDisplay, redraw, redraw, removeIcon, selectedRecordChanged, setAccessKey, setAlign, setAllowExpressions, setAlwaysFetchMissingValues, setAlwaysShowControlBox, setApplyAlignToText, setApplyHeightToTextBox, setAriaRole, setAriaState, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAutoChildConstructor, setAutoChildProperties, setAutoChildProperties, setAutoChildProperties, setAutoChildVisibility, setAutoComplete, setAutoCompleteKeywords, setBrowserInputType, setBrowserSpellCheck, setCanEdit, setCanEditCriterionPredicate, setCanEditOpaqueValues, setCanFocus, setCanSelectText, setCanTabToIcons, setCellHeight, setCellStyle, setClipStaticValue, setClipTitle, setColSpan, setColSpan, setConfigOnly, setControlStyle, setCriteriaField, setCriterion, setCriterionGetter, setCriterionSetter, setCustomStateGetter, setDataPath, setDateFormatter, setDecimalPad, setDecimalPrecision, setDefaultIconSrc, setDefaultOperator, setDefaultProperties, setDefaultValue, setDefaultValue, setDefaultValue, setDefaultValue, setDefaultValue, setDefaultValue, setDefaultValue, setDisabled, setDisabledHover, setDisableIconsOnReadOnly, setDisplayField, setDisplayFormat, setDisplayFormat, setEditorProperties, setEditorType, setEditorType, setEditorType, setEditorValueFormatter, setEditorValueParser, setEditPendingCSSText, setEmptyDisplayValue, setEmptyValueIcon, setEndRow, setErrorFormatter, setErrorIconHeight, setErrorIconSrc, setErrorIconWidth, setErrorMessageWidth, setErrorOrientation, setErrors, setErrors, setExportFormat, setFetchMissingValues, setFilterLocally, setForeignDisplayField, setFormat, setFormula, setGlobalTabIndex, setHeight, setHidden, setHint, setHintStyle, setHoverAlign, setHoverDelay, setHoverFocusKey, setHoverHeight, setHoverHeight, setHoverOpacity, setHoverPersist, setHoverStyle, setHoverVAlign, setHoverWidth, setHoverWidth, setIconDisabled, setIconHeight, setIconHSpace, setIconPrompt, setIcons, setIconShowOnFocus, setIconWidth, setID, setImageURLPrefix, setImageURLSuffix, setImplicitSave, setImplicitSaveOnBlur, setInitHandler, setInputFormat, setInputTransformer, setItemHoverFormatter, setItemTitleHoverFormatter, setItemValueHoverFormatter, setJavaScriptObject, setLeft, setLinearColSpan, setLinearColSpan, setLinearEndRow, setLinearEndRow, setLinearStartRow, setLinearStartRow, setLinearWidth, setLinearWidth, setLoadingDisplayValue, setLocateItemBy, setMinHintWidth, setMultiple, setMultipleValueSeparator, setName, setNullOriginalValueText, setNullProperty, setOperator, setOptionCriteria, setOptionDataSource, setOptionDataSource, setOptionFilterContext, setOptionOperationId, setOptionTextMatchStyle, setOriginalValueMessage, setPickerIconName, setPickerIconPrompt, setPickerIconProperties, setPickerIconSrc, setPickerIconStyle, setPickerIconWidth, setPrintReadOnlyTextBoxStyle, setPrintTextBoxStyle, setPrintTitleStyle, setPrompt, setProperty, setProperty, setProperty, setProperty, setProperty, setReadOnlyCanSelectText, setReadOnlyControlStyle, setReadOnlyDisplay, setReadOnlyHover, setReadOnlyTextBoxStyle, setReadOnlyWhen, setRedrawOnChange, setRejectInvalidValueOnChange, setRequired, setRequiredMessage, setRequiredWhen, setRowSpan, setSaveOnEnter, setScClassName, setShouldSaveValue, setShowClippedTitleOnHover, setShowClippedValueOnHover, setShowDeletions, setShowDisabled, setShowDisabledIconsOnFocus, setShowDisabledPickerIconOnFocus, setShowErrorIcon, setShowErrorStyle, setShowErrorText, setShowFocused, setShowFocusedErrorState, setShowFocusedIcons, setShowFocusedPickerIcon, setShowHint, setShowIcons, setShowIconsOnFocus, setShowIfCondition, setShowImageAsURL, setShowOldValueInHover, setShowOver, setShowOverIcons, setShowPending, setShowPickerIcon, setShowPickerIconOnFocus, setShowRTL, setShowTitle, setShowValueIconOnly, setStartRow, setStateCustomizer, setStopOnError, setStoreDisplayValues, setSuppressValueIcon, setSynchronousValidation, setTabIndex, setTextAlign, setTextFormula, setTimeFormatter, setTitle, setTitleAlign, setTitleColSpan, setTitleHoverFormatter, setTitleOrientation, setTitleStyle, setTitleVAlign, setTooltip, setTop, setType, setUpdateControlOnOver, setUpdatePickerIconOnOver, setUpdateTextBoxOnOver, setUseAdvancedCriteria, setUseDisabledHintStyleForReadOnly, setUseLocalDisplayFieldValue, setValidateOnChange, setValidateOnExit, setValidators, setValidOperators, setVAlign, setValue, setValue, setValue, setValue, setValue, setValue, setValueDeselectedCSSText, setValueField, setValueFormatter, setValueHoverFormatter, setValueIconHeight, setValueIconLeftPadding, setValueIconMapper, setValueIconRightPadding, setValueIcons, setValueIconSize, setValueIconWidth, setValueMap, setValueMap, setVisible, setVisibleWhen, setWarnOnEditorTypeConversion, setWarnOnEditorTypeConversionDefault, setWidth, setWrapHintText, setWrapStaticValue, setWrapTitle, shouldApplyHeightToTextBox, shouldFetchMissingValue, shouldSaveOnEnter, shouldStopKeyPressBubbling, show, showIcon, showPicker, stopHover, storeValue, storeValue, updateState, validate, valueClippedgetRef, getRef, internalSetIDapplyFactoryProperties, doAddHandler, fireEvent, getAttributeAsDoubleArray, getAttributeAsElement, getAttributeAsIntArray, getAttributeAsLong, getAttributeAsMap, getAttributeAsObject, getAttributeAsRecord, getAttributeAsStringArray, getAttributes, getHandlerCount, isFactoryCreated, setAttribute, setAttribute, setAttribute, setAttributeAsJavaObject, setFactoryCreatedpublic TextAreaItem()
public TextAreaItem(com.google.gwt.core.client.JavaScriptObject jsObj)
public TextAreaItem(java.lang.String name)
public TextAreaItem(java.lang.String name,
java.lang.String title)
public static TextAreaItem getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj)
public static void changeAutoChildDefaults(java.lang.String autoChildName,
Canvas defaults)
autoChildName.autoChildName - name of an AutoChild to customize the defaults for.defaults - Canvas defaults to apply. These defaults override any existing properties
without destroying or wiping out non-overridden properties. For usage tips on this
param, see SGWTProperties.AutoChildUsagepublic static void changeAutoChildDefaults(java.lang.String autoChildName,
FormItem defaults)
autoChildName.autoChildName - name of an AutoChild to customize the defaults for.defaults - FormItem defaults to apply. These defaults override any existing properties
without destroying or wiping out non-overridden properties. For usage tips on this
param, see SGWTProperties.AutoChildUsagepublic static void changePickerIconDefaults(FormItemIcon defaults)
public TextAreaItem setBrowserAutoCapitalize(java.lang.Boolean browserAutoCapitalize)
Note : This is an advanced setting
browserAutoCapitalize - New browserAutoCapitalize value. Default value is nullTextAreaItem instance, for chaining setter callspublic java.lang.Boolean getBrowserAutoCapitalize()
public TextAreaItem setBrowserAutoCorrect(java.lang.Boolean browserAutoCorrect)
null, then
Mobile Safari determines automatically whether to enable autocorrect. When enabled, Mobile Safari displays
"autocorrect bubbles" to suggest automatic corrections:
Note : This is an advanced setting
browserAutoCorrect - New browserAutoCorrect value. Default value is nullTextAreaItem instance, for chaining setter callspublic java.lang.Boolean getBrowserAutoCorrect()
null, then
Mobile Safari determines automatically whether to enable autocorrect. When enabled, Mobile Safari displays
"autocorrect bubbles" to suggest automatic corrections:
public TextAreaItem setChangeOnKeypress(java.lang.Boolean changeOnKeypress)
change handler
(and store its value in the form) on every keypress? Set to false to suppress the 'change' handler firing
(and the value stored) on every keypress. Note: If false, the value returned by getValue will not reflect the value displayed in the form
item element as long as focus is in the form item element.
setChangeOnKeypress in class FormItemchangeOnKeypress - New changeOnKeypress value. Default value is trueTextAreaItem instance, for chaining setter callspublic java.lang.Boolean getChangeOnKeypress()
change handler
(and store its value in the form) on every keypress? Set to false to suppress the 'change' handler firing
(and the value stored) on every keypress. Note: If false, the value returned by getValue will not reflect the value displayed in the form
item element as long as focus is in the form item element.
getChangeOnKeypress in class FormItempublic TextAreaItem setEditProxyConstructor(java.lang.String editProxyConstructor)
EditProxy for this component when the component is
first placed into edit mode.setEditProxyConstructor in class FormItemeditProxyConstructor - New editProxyConstructor value. Default value is "TextAreaItemEditProxy"TextAreaItem instance, for chaining setter callsSCClassNamepublic java.lang.String getEditProxyConstructor()
EditProxy for this component when the component is
first placed into edit mode.getEditProxyConstructor in class FormItemSCClassNamepublic TextAreaItem setEnforceLength(boolean enforceLength)
length is specified for this item, should
user input be limited to the specified length? If set to true, user input and values passed to setValue() will be trimmed to the specified length. Otherwise
values exceeding the specified length will raise an error on validation. Note that having this value set to true
limits user interactivity in some ways. For example users would be unable to paste a longer string into the field for
editing without seeing it be truncated. Given how text areas are typically used to edit longer values than non-wrapping
TextItems, this value is false by default for textAreaItems.
enforceLength - New enforceLength value. Default value is falseTextAreaItem instance, for chaining setter callspublic boolean getEnforceLength()
length is specified for this item, should
user input be limited to the specified length? If set to true, user input and values passed to setValue() will be trimmed to the specified length. Otherwise
values exceeding the specified length will raise an error on validation. Note that having this value set to true
limits user interactivity in some ways. For example users would be unable to paste a longer string into the field for
editing without seeing it be truncated. Given how text areas are typically used to edit longer values than non-wrapping
TextItems, this value is false by default for textAreaItems.
public TextAreaItem setEscapeHTML(java.lang.Boolean escapeHTML)
canEdit is false and readOnlyDisplay is
"static", so that the raw value of the field (for example "<b>AAA</b>") is displayed to the
user rather than the interpreted HTML (for example "AAA"). Setting escapeHTML false
will instead force HTML values in a textAreaItem to be interpreted by the browser in that situation.setEscapeHTML in class FormItemescapeHTML - New escapeHTML value. Default value is trueTextAreaItem instance, for chaining setter callsAppearance overview and related methodspublic java.lang.Boolean getEscapeHTML()
canEdit is false and readOnlyDisplay is
"static", so that the raw value of the field (for example "<b>AAA</b>") is displayed to the
user rather than the interpreted HTML (for example "AAA"). Setting escapeHTML false
will instead force HTML values in a textAreaItem to be interpreted by the browser in that situation.getEscapeHTML in class FormItemAppearance overview and related methodspublic TextAreaItem setFormatOnBlur(java.lang.Boolean formatOnBlur)
formatOnBlur enabled, this textAreaItem will format its value according to the rules described in
FormItem.mapValueToDisplay() as long as the
item does not have focus. Once the user puts focus into the item the formatter will be removed. This provides a simple
way for developers to show a nicely formatted display value in a freeform text field, without the need for an explicit
FormItem.formatEditorValue() and FormItem.parseEditorValue() pair.formatOnBlur - New formatOnBlur value. Default value is falseTextAreaItem instance, for chaining setter callspublic java.lang.Boolean getFormatOnBlur()
formatOnBlur enabled, this textAreaItem will format its value according to the rules described in
FormItem.mapValueToDisplay() as long as the
item does not have focus. Once the user puts focus into the item the formatter will be removed. This provides a simple
way for developers to show a nicely formatted display value in a freeform text field, without the need for an explicit
FormItem.formatEditorValue() and FormItem.parseEditorValue() pair.public TextAreaItem setHeight(int height)
Note that when item is rendered as read-only with readOnlyDisplay as
"static" the property FormItem.staticHeight is
used instead.
setHeight in class FormItemheight - New height value. Default value is 100TextAreaItem instance, for chaining setter callsAppearance overview and related methodspublic int getHeight()
Note that when item is rendered as read-only with readOnlyDisplay as
"static" the property FormItem.staticHeight is
used instead.
getHeight in class FormItemAppearance overview and related methodspublic TextAreaItem setIconVAlign(VerticalAlignment iconVAlign)
setIconVAlign in class FormItemiconVAlign - New iconVAlign value. Default value is Canvas.TOPTextAreaItem instance, for chaining setter callspublic VerticalAlignment getIconVAlign()
getIconVAlign in class FormItempublic TextAreaItem setLength(java.lang.Integer length)
enforceLength is set to true, user input will be
limited to this value, and values exceeding this length passed to setValue() will be trimmed. Otherwise values exceeding the
specified length will raise an error on validation. See also DataSourceField.length.
length - New length value. Default value is nullTextAreaItem instance, for chaining setter callsValidation overview and related methodspublic java.lang.Integer getLength()
enforceLength is set to true, user input will be
limited to this value, and values exceeding this length passed to setValue() will be trimmed. Otherwise values exceeding the
specified length will raise an error on validation. See also DataSourceField.length.
Validation overview and related methodspublic TextAreaItem setMinHeight(int minHeight)
height is less than this value, the text area will still
render at this height.minHeight - New minHeight value. Default value is 16TextAreaItem instance, for chaining setter callspublic int getMinHeight()
height is less than this value, the text area will still
render at this height.public TextAreaItem setPickerIconHeight(java.lang.Integer pickerIconHeight)
setPickerIconHeight in class FormItempickerIconHeight - New pickerIconHeight value. Default value is 20TextAreaItem instance, for chaining setter callspublic java.lang.Integer getPickerIconHeight()
getPickerIconHeight in class FormItempublic TextAreaItem setPrintFullText(java.lang.Boolean printFullText)
printFullText - New printFullText value. Default value is trueTextAreaItem instance, for chaining setter callsPrinting overview and related methodspublic java.lang.Boolean getPrintFullText()
Printing overview and related methodspublic TextAreaItem setSelectOnClick(java.lang.Boolean selectOnClick)
selectOnClick behavior to be configured
on a per-FormItem basis. Normally all items in a form default to the value of DynamicForm.selectOnClick.setSelectOnClick in class FormItemselectOnClick - New selectOnClick value. Default value is nullTextAreaItem instance, for chaining setter callsFocus overview and related methodspublic java.lang.Boolean getSelectOnClick()
selectOnClick behavior to be configured
on a per-FormItem basis. Normally all items in a form default to the value of DynamicForm.selectOnClick.getSelectOnClick in class FormItemFocus overview and related methodspublic TextAreaItem setSelectOnFocus(java.lang.Boolean selectOnFocus)
selectOnFocus behavior to be configured
on a per-FormItem basis. Normally all items in a form default to the value of DynamicForm.selectOnFocus.setSelectOnFocus in class FormItemselectOnFocus - New selectOnFocus value. Default value is nullTextAreaItem instance, for chaining setter callsFocus overview and related methodspublic java.lang.Boolean getSelectOnFocus()
selectOnFocus behavior to be configured
on a per-FormItem basis. Normally all items in a form default to the value of DynamicForm.selectOnFocus.getSelectOnFocus in class FormItemFocus overview and related methodspublic TextAreaItem setShowHintInField(java.lang.Boolean showHintInField)
showing a hint for this form item, should the
hint be shown
within the field?
Unless the HTML5 placeholder attribute is used to display the hint
(see usePlaceholderForHint),
the value of the <input> element for this item will be set to the hint
whenever this item is not focused. Also, when displaying the hint, the CSS style of the
data element will be set to the textBoxStyle
with the suffix
"Hint" appended to it; or, if the item is disabled, the suffix "DisabledHint" will be used.
In RTL mode when showRTL is true,
an additional "RTL" suffix will be appended; i.e. the CSS style of the data element when
the hint is displayed will be the textBoxStyle plus "HintRTL" or
"DisabledHintRTL".
To change this attribute after being drawn, it is necessary to call FormItem.redraw()
or redraw the form.
textBoxStyle + "Hint" /
"HintRTL" / "DisabledHint" / "DisabledHintRTL" styles. For example, if this item's
textBoxStyle is set to "mySpecialItem", then changing the hint color to
blue can be accomplished with the following CSS:
.mySpecialItemHint,
.mySpecialItemHintRTL,
.mySpecialItemDisabledHint,
.mySpecialItemDisabledHintRTL {
color: blue;
}
In DynamicForm.linearMode, this property will be
defaulted true if left unset.
showHintInField - New showHintInField value. Default value is nullTextAreaItem instance, for chaining setter callsFormItem.setHint(java.lang.String),
setUsePlaceholderForHint(boolean),
Appearance overview and related methodspublic java.lang.Boolean getShowHintInField()
showing a hint for this form item, should the
hint be shown
within the field?
Unless the HTML5 placeholder attribute is used to display the hint
(see usePlaceholderForHint),
the value of the <input> element for this item will be set to the hint
whenever this item is not focused. Also, when displaying the hint, the CSS style of the
data element will be set to the textBoxStyle
with the suffix
"Hint" appended to it; or, if the item is disabled, the suffix "DisabledHint" will be used.
In RTL mode when showRTL is true,
an additional "RTL" suffix will be appended; i.e. the CSS style of the data element when
the hint is displayed will be the textBoxStyle plus "HintRTL" or
"DisabledHintRTL".
To change this attribute after being drawn, it is necessary to call FormItem.redraw()
or redraw the form.
textBoxStyle + "Hint" /
"HintRTL" / "DisabledHint" / "DisabledHintRTL" styles. For example, if this item's
textBoxStyle is set to "mySpecialItem", then changing the hint color to
blue can be accomplished with the following CSS:
.mySpecialItemHint,
.mySpecialItemHintRTL,
.mySpecialItemDisabledHint,
.mySpecialItemDisabledHintRTL {
color: blue;
}
In DynamicForm.linearMode, this property will be
defaulted true if left unset.
FormItem.getHint(),
getUsePlaceholderForHint(),
Appearance overview and related methodspublic TextAreaItem setShowInputElement(boolean showInputElement)
valueIcons or a picker icon, these are displayed as normal, and the
item will auto-sizing to that content if its width is
set to null.
Note : This is an advanced setting
showInputElement - New showInputElement value. Default value is trueTextAreaItem instance, for chaining setter callspublic boolean getShowInputElement()
valueIcons or a picker icon, these are displayed as normal, and the
item will auto-sizing to that content if its width is
set to null.public TextAreaItem setStaticHeight(java.lang.Integer staticHeight)
canEdit is false and readOnlyDisplay is "static". The normal
height is used if this property is not set.setStaticHeight in class FormItemstaticHeight - New staticHeight value. Default value is 1TextAreaItem instance, for chaining setter callssetHeight(int),
FormLayout overview and related methodspublic java.lang.Integer getStaticHeight()
canEdit is false and readOnlyDisplay is "static". The normal
height is used if this property is not set.getStaticHeight in class FormItemgetHeight(),
FormLayout overview and related methodspublic TextAreaItem setSupportsCutPasteEvents(boolean supportsCutPasteEvents)
This attribute only applies to freeform text entry
fields such as TextItem and TextAreaItem, and only if changeOnKeypress is true. If true, developers
can detect the user editing the value via cut or paste interactions (triggered from keyboard shortcuts or the native
browser menu options) using the FormItem.isCutEvent() and FormItem.isPasteEvent()
methods. This allows custom cut/paste handling to be added to the various change notification flow methods including
FormItem.change(), and FormItem.transformInput().
setSupportsCutPasteEvents in class FormItemsupportsCutPasteEvents - New supportsCutPasteEvents value. Default value is trueTextAreaItem instance, for chaining setter callspublic boolean getSupportsCutPasteEvents()
This attribute only applies to freeform text entry
fields such as TextItem and TextAreaItem, and only if changeOnKeypress is true. If true, developers
can detect the user editing the value via cut or paste interactions (triggered from keyboard shortcuts or the native
browser menu options) using the FormItem.isCutEvent() and FormItem.isPasteEvent()
methods. This allows custom cut/paste handling to be added to the various change notification flow methods including
FormItem.change(), and FormItem.transformInput().
getSupportsCutPasteEvents in class FormItempublic TextAreaItem setTextBoxStyle(java.lang.String textBoxStyle)
CompoundFormItem_skinning discussion for special skinning considerations.setTextBoxStyle in class FormItemtextBoxStyle - New textBoxStyle value. Default value is "textItem"TextAreaItem instance, for chaining setter callsFormItemBaseStyle,
Appearance overview and related methodspublic java.lang.String getTextBoxStyle()
CompoundFormItem_skinning discussion for special skinning considerations.getTextBoxStyle in class FormItemFormItemBaseStyle,
Appearance overview and related methodspublic TextAreaItem setUsePlaceholderForHint(boolean usePlaceholderForHint)
showing the hint in field and if
supported by the browser, should the HTML5
placeholder attribute
be used to display the hint within the field? If set to false, then use of
the placeholder attribute is disabled and an alternative technique to display
the hint in-field is used instead.
The HTML5 placeholder attribute is supported in the following major browsers:
WebView (used by the stock Browser app and when
packaging with PhoneGap)In browsers other than the above, in-field hints are implemented via a different technique.
Note that placeholder behavior is known to differ in Internet Explorer and certain old
versions of the above browsers due to a recent change in the HTML5 specification regarding
the placeholder attribute. Under the old rules, the placeholder is cleared
when the element is focused. In the latest HTML5 spec as published by WHATWG, the placeholder
is still displayed when the element is focused as long as the value is an empty string.
| Browser | Pseudo-class or pseudo-element |
|---|---|
| Chrome, Safari | ::-webkit-input-placeholder |
| Firefox 4 - 18 | :-moz-placeholder |
| Firefox 19+ | ::-moz-placeholder |
| Internet Explorer | :-ms-input-placeholder |
Note that unlike other browsers, Firefox 19+ applies opacity:0.4 to the placeholder text. See Bug 556145 - Placeholder text default style should use opacity instead of GrayText
Because browsers are required to ignore the entire rule if a selector is invalid, separate rules are needed for each browser. For example:
::-webkit-input-placeholder {
color: blue;
opacity: 1;
}
:-moz-placeholder {
color: blue;
opacity: 1;
}
::-moz-placeholder {
color: blue;
opacity: 1;
}
:-ms-input-placeholder {
color: blue;
opacity: 1;
}
If using Sass, it may be useful to utilize Sass' parent selector feature. For example:
.myCustomItem,
.myCustomItemRTL,
.myCustomItemDisabled,
.myCustomItemDisabledRTL,
.myCustomItemError,
.myCustomItemErrorRTL,
.myCustomItemFocused,
.myCustomItemFocusedRTL,
.myCustomItemHint,
.myCustomItemHintRTL,
.myCustomItemDisabledHint,
.myCustomItemDisabledHintRTL {
// ...
&::-webkit-input-placeholder {
color: blue;
opacity: 1;
}
&:-moz-placeholder {
color: blue;
opacity: 1;
}
&::-moz-placeholder {
color: blue;
opacity: 1;
}
&:-ms-input-placeholder {
color: blue;
opacity: 1;
}
}
If using Compass, the
input-placeholder mixin
that was added in version 1.0 can further simplify the code to style the placeholder text
For example:
.myCustomItem,
.myCustomItemRTL,
.myCustomItemDisabled,
.myCustomItemDisabledRTL,
.myCustomItemError,
.myCustomItemErrorRTL,
.myCustomItemFocused,
.myCustomItemFocusedRTL,
.myCustomItemHint,
.myCustomItemHintRTL,
.myCustomItemDisabledHint,
.myCustomItemDisabledHintRTL {
// ...
@include input-placeholder {
color: blue;
opacity: 1;
}
}
Note : This is an advanced setting
usePlaceholderForHint - New usePlaceholderForHint value. Default value is trueTextAreaItem instance, for chaining setter callsFormItem.setHint(java.lang.String),
Appearance overview and related methodspublic boolean getUsePlaceholderForHint()
showing the hint in field and if
supported by the browser, should the HTML5
placeholder attribute
be used to display the hint within the field? If set to false, then use of
the placeholder attribute is disabled and an alternative technique to display
the hint in-field is used instead.
The HTML5 placeholder attribute is supported in the following major browsers:
WebView (used by the stock Browser app and when
packaging with PhoneGap)In browsers other than the above, in-field hints are implemented via a different technique.
Note that placeholder behavior is known to differ in Internet Explorer and certain old
versions of the above browsers due to a recent change in the HTML5 specification regarding
the placeholder attribute. Under the old rules, the placeholder is cleared
when the element is focused. In the latest HTML5 spec as published by WHATWG, the placeholder
is still displayed when the element is focused as long as the value is an empty string.
| Browser | Pseudo-class or pseudo-element |
|---|---|
| Chrome, Safari | ::-webkit-input-placeholder |
| Firefox 4 - 18 | :-moz-placeholder |
| Firefox 19+ | ::-moz-placeholder |
| Internet Explorer | :-ms-input-placeholder |
Note that unlike other browsers, Firefox 19+ applies opacity:0.4 to the placeholder text. See Bug 556145 - Placeholder text default style should use opacity instead of GrayText
Because browsers are required to ignore the entire rule if a selector is invalid, separate rules are needed for each browser. For example:
::-webkit-input-placeholder {
color: blue;
opacity: 1;
}
:-moz-placeholder {
color: blue;
opacity: 1;
}
::-moz-placeholder {
color: blue;
opacity: 1;
}
:-ms-input-placeholder {
color: blue;
opacity: 1;
}
If using Sass, it may be useful to utilize Sass' parent selector feature. For example:
.myCustomItem,
.myCustomItemRTL,
.myCustomItemDisabled,
.myCustomItemDisabledRTL,
.myCustomItemError,
.myCustomItemErrorRTL,
.myCustomItemFocused,
.myCustomItemFocusedRTL,
.myCustomItemHint,
.myCustomItemHintRTL,
.myCustomItemDisabledHint,
.myCustomItemDisabledHintRTL {
// ...
&::-webkit-input-placeholder {
color: blue;
opacity: 1;
}
&:-moz-placeholder {
color: blue;
opacity: 1;
}
&::-moz-placeholder {
color: blue;
opacity: 1;
}
&:-ms-input-placeholder {
color: blue;
opacity: 1;
}
}
If using Compass, the
input-placeholder mixin
that was added in version 1.0 can further simplify the code to style the placeholder text
For example:
.myCustomItem,
.myCustomItemRTL,
.myCustomItemDisabled,
.myCustomItemDisabledRTL,
.myCustomItemError,
.myCustomItemErrorRTL,
.myCustomItemFocused,
.myCustomItemFocusedRTL,
.myCustomItemHint,
.myCustomItemHintRTL,
.myCustomItemDisabledHint,
.myCustomItemDisabledHintRTL {
// ...
@include input-placeholder {
color: blue;
opacity: 1;
}
}
FormItem.getHint(),
Appearance overview and related methodspublic TextAreaItem setWidth(int width)
setWidth in class FormItemwidth - New width value. Default value is 150TextAreaItem instance, for chaining setter callsAppearance overview and related methodspublic int getWidth()
getWidth in class FormItemAppearance overview and related methodspublic void deselectValue()
public void deselectValue(java.lang.Boolean start)
start - By default the text insertion cursor will be moved to the end of the current value - pass in this parameter to move to
the start insteadpublic java.lang.String getEnteredValue()
FormItem.getValue() in various cases - for example: DateItem with
enforceDate:true, or a ComboBoxItem with addUnknownValues:falsechangeOnKeypress is false public int[] getSelectionRange()
In all browsers, clicking anywhere outside of the item causes the item to lose focus;
hence, in IE 6-9, this method will not work in other components' event handlers for certain events. For example, within
the click() handler of a button, this item will have already
lost focus, so in IE 6-9, this method will return null if called within the button's click() handler. One cross-browser
solution to this issue is to save the selection range for later in a mouseDown() or mouseOver() handler.
Notes:
setValue() or otherwise changing
the entered value invalidates the past
selection range.getValue(). The distinction is
particularly important for TextAreaItems because browsers normalize the
line endings in the <textarea> element's value. Internet Explorer 6, 7, and 8 convert line endings to
"\r\n" while other browsers convert line endings to "\n" as specified by the HTML5
standard.entered value. In IE 6-9, returns null if the
item does not have focus.public void selectValue()
public void setSelectionRange(int start,
int end)
start - selection starting character indexend - end of selection character indexpublic java.lang.String transformPastedValue(FormItem item, DynamicForm form, java.lang.String pastedValue)
pastedValue argument contains the text pasted from the clipboard. This
method should return the text value to actually insert into the input element.item - Item into which the user pasted a valueform - Pointer to the item's formpastedValue - Pasted text valuepublic static void setDefaultProperties(TextAreaItem textAreaItemProperties)
Note: This method is intended for setting default attributes only and will affect all instances of the underlying class (including those automatically generated in JavaScript). This method should not be used to apply standard EventHandlers or override methods for a class - use a custom subclass instead. Calling this method after instances have been created can result in undefined behavior, since it bypasses any setters and a class instance may have already examined a particular property and not be expecting any changes through this route.
textAreaItemProperties - properties that should be used as new defaults when instances of this class are createdSGWTPropertiespublic void setWrap(TextAreaWrap wrap)
wrap - wrap Default value is TextAreaWrap.SOFTpublic TextAreaWrap getWrap()
public java.lang.String getValueAsString()