Class sap.ui.commons.TextFieldModule: sap/ui/commons/TextField

extends Control
implements ToolbarItem
known direct subclasses: ComboBox, DatePicker, PasswordField, TextArea, ValueHelpField

Renders a input field for text input.

Deprecated API:Since version 1.38. Instead, use the sap.m.Input control.

Constructor Summary
new sap.ui.commons.TextField(sID?, mSettings?)Constructor for a new TextField.
Event Summary
change(oControlEvent)Event is fired when the text in the field has changed AND the focus leaves the TextField or the Enter key is pressed.
liveChange(oControlEvent)This event if fired during typing into the TextField and returns the currently entered value.
Events borrowed from class sap.ui.core.Control
validateFieldGroup
Events borrowed from class sap.ui.base.ManagedObject
formatError, modelContextChange, parseError, validationError, validationSuccess
Method Summary
sap.ui.commons.TextField.extend(sClassName, oClassInfo?, FNMetaImpl?)Creates a new subclass of class sap.ui.commons.TextField with name sClassName and enriches it with the information contained in oClassInfo.
sap.ui.commons.TextField.getMetadata()Returns a metadata object for class sap.ui.commons.TextField.
_checkChange(oEvent)Compares the previous value with the current value and fires the change event if the TextField is editable and the value has changed.
addAriaDescribedBy(vAriaDescribedBy)Adds some ariaDescribedBy into the association ariaDescribedBy.
addAriaLabelledBy(vAriaLabelledBy)Adds some ariaLabelledBy into the association ariaLabelledBy.
attachChange(oData?, fnFunction, oListener?)Attaches event handler fnFunction to the change event of this sap.ui.commons.TextField.
attachLiveChange(oData?, fnFunction, oListener?)Attaches event handler fnFunction to the liveChange event of this sap.ui.commons.TextField.
bindValue(oBindingInfo)Binds property value to model data.
detachChange(fnFunction, oListener)Detaches event handler fnFunction from the change event of this sap.ui.commons.TextField.
detachLiveChange(fnFunction, oListener)Detaches event handler fnFunction from the liveChange event of this sap.ui.commons.TextField.
fireChange(mArguments?)Fires event change to attached listeners.
fireLiveChange(mArguments?)Fires event liveChange to attached listeners.
getAccessibilityInfo()
getAccessibleRole()Gets current value of property accessibleRole.
getAriaDescribedBy()Returns array of IDs of the elements which are the current targets of the association ariaDescribedBy.
getAriaLabelledBy()Returns array of IDs of the elements which are the current targets of the association ariaLabelledBy.
getDesign()Gets current value of property design.
getEditable()Gets current value of property editable.
getEnabled()Gets current value of property enabled.
getFocusInfo()Returns an object representing the serialized focus information
getHelpId()Gets current value of property helpId.
getImeMode()Gets current value of property imeMode.
getInputDomRef()Method for accessing the DOM Ref of the input element.
getLiveValue()Returns the current value of the TextField.
getMaxLength()Gets current value of property maxLength.
getName()Gets current value of property name.
getPlaceholder()Gets current value of property placeholder.
getRequired()Gets current value of property required.
getTextAlign()Gets current value of property textAlign.
getTextDirection()Gets current value of property textDirection.
getValue()Gets current value of property value.
getValueState()Gets current value of property valueState.
getWidth()Gets current value of property width.
onfocusin(oEvent)Event handler called when control is receiving the focus
onkeyup(oEvent)Event handler for keyup.
onsapenter(oEvent)Event handler called when enter key is pressed.
onsapfocusleave(oEvent)Event handler called when control is losing the focus
onselectstart(oEvent)Event handler called when text selection starts.
removeAllAriaDescribedBy()Removes all the controls in the association named ariaDescribedBy.
removeAllAriaLabelledBy()Removes all the controls in the association named ariaLabelledBy.
removeAriaDescribedBy(vAriaDescribedBy)Removes an ariaDescribedBy from the association named ariaDescribedBy.
removeAriaLabelledBy(vAriaLabelledBy)Removes an ariaLabelledBy from the association named ariaLabelledBy.
setAccessibleRole(sAccessibleRole)Sets a new value for property accessibleRole.
setDesign(sDesign)Sets a new value for property design.
setEditable(bEditable)Sets a new value for property editable.
setEnabled(bEnabled)Sets a new value for property enabled.
setHelpId(sHelpId)Sets a new value for property helpId.
setImeMode(sImeMode)Sets a new value for property imeMode.
setMaxLength(iMaxLength)Sets a new value for property maxLength.
setName(sName)Sets a new value for property name.
setPlaceholder(sPlaceholder)Sets a new value for property placeholder.
setRequired(bRequired)Sets a new value for property required.
setTextAlign(sTextAlign)Sets a new value for property textAlign.
setTextDirection(sTextDirection)Sets a new value for property textDirection.
setValue(sValue)Sets a new value for property value.
setValueState(sValueState)Sets a new value for property valueState.
setWidth(sWidth)Sets a new value for property width.
unbindValue()Unbinds property value from model data.
Methods borrowed from class sap.ui.core.Control
addStyleClass, allowTextSelection, attachBrowserEvent, attachValidateFieldGroup, checkFieldGroupIds, clone, detachBrowserEvent, detachValidateFieldGroup, fireValidateFieldGroup, getBusy, getBusyIndicatorDelay, getControlsByFieldGroupId, getFieldGroupIds, getIdForLabel, getRenderer, getVisible, hasStyleClass, invalidate, isBusy, onAfterRendering, onBeforeRendering, placeAt, removeStyleClass, rerender, setBusy, setBusyIndicatorDelay, setFieldGroupIds, setVisible, toggleStyleClass, triggerValidateFieldGroup
Methods borrowed from class sap.ui.core.Element
$, addCustomData, addDependent, addEventDelegate, applyFocusInfo, bindElement, data, destroy, destroyCustomData, destroyDependents, destroyLayoutData, destroyTooltip, enhanceAccessibilityState, exit, findElements, fireEvent, focus, getCustomData, getDependents, getDomRef, getElementBinding, getFocusDomRef, getInterface, getLayoutData, getMetadata, getTooltip, getTooltip_AsString, getTooltip_Text, indexOfCustomData, indexOfDependent, init, insertCustomData, insertDependent, prop, removeAllCustomData, removeAllDependents, removeCustomData, removeDependent, removeEventDelegate, setLayoutData, setTooltip, toString, unbindElement
Methods borrowed from class sap.ui.base.ManagedObject
addAggregation, addAssociation, applySettings, attachFormatError, attachModelContextChange, attachParseError, attachValidationError, attachValidationSuccess, bindAggregation, bindContext, bindObject, bindProperty, destroyAggregation, detachFormatError, detachModelContextChange, detachParseError, detachValidationError, detachValidationSuccess, findAggregatedObjects, fireFormatError, fireModelContextChange, fireParseError, fireValidationError, fireValidationSuccess, getAggregation, getAssociation, getBinding, getBindingContext, getBindingInfo, getBindingPath, getEventingParent, getId, getModel, getObjectBinding, getOriginInfo, getParent, getProperty, hasModel, indexOfAggregation, insertAggregation, isBound, isInvalidateSuppressed, isTreeBinding, propagateMessages, removeAggregation, removeAllAggregation, removeAllAssociation, removeAssociation, setAggregation, setAssociation, setBindingContext, setModel, setProperty, unbindAggregation, unbindContext, unbindObject, unbindProperty, validateAggregation, validateProperty
Methods borrowed from class sap.ui.base.EventProvider
attachEvent, attachEventOnce, detachEvent, hasListeners
Constructor Detail
new sap.ui.commons.TextField(sID?, mSettings?)
Constructor for a new TextField.

Accepts an object literal mSettings that defines initial property values, aggregated and associated objects as well as event handlers. See sap.ui.base.ManagedObject for a general description of the syntax of the settings object.

The supported settings are:

  • Properties
  • Events
    • change : fnListenerFunction or [fnListenerFunction, oListenerObject] or [oData, fnListenerFunction, oListenerObject]
    • liveChange : fnListenerFunction or [fnListenerFunction, oListenerObject] or [oData, fnListenerFunction, oListenerObject]

In addition, all settings applicable to the base type sap.ui.core.Control can be used as well.

Parameters:
{string}sID? id for the new control, generated automatically if no ID is given
{object}mSettings? Initial settings for the new control
Deprecated:
Since version 1.38. Instead, use the sap.m.Input control.
Event Detail
change(oControlEvent)
Event is fired when the text in the field has changed AND the focus leaves the TextField or the Enter key is pressed.
Parameters:
{sap.ui.base.Event}oControlEvent
{sap.ui.base.EventProvider}oControlEvent.getSource
{object}oControlEvent.getParameters
{string}oControlEvent.getParameters.newValue The new / changed value of the TextField.
liveChange(oControlEvent)
This event if fired during typing into the TextField and returns the currently entered value. Note: This is not the content of the value property. The value property is only updated by ENTER and by leaving the control.
Parameters:
{sap.ui.base.Event}oControlEvent
{sap.ui.base.EventProvider}oControlEvent.getSource
{object}oControlEvent.getParameters
{string}oControlEvent.getParameters.liveValue Current visible value of the TextField.
Method Detail
sap.ui.commons.TextField.extend(sClassName, oClassInfo?, FNMetaImpl?): function
Creates a new subclass of class sap.ui.commons.TextField with name sClassName and enriches it with the information contained in oClassInfo.

oClassInfo might contain the same kind of information as described in sap.ui.core.Control.extend.

Parameters:
{string}sClassName Name of the class being created
{object}oClassInfo? Object literal with information about the class
{function}FNMetaImpl? Constructor function for the metadata object; if not given, it defaults to sap.ui.core.ElementMetadata
Returns:
{function} Created class / constructor function
sap.ui.commons.TextField.getMetadata(): sap.ui.base.Metadata
Returns a metadata object for class sap.ui.commons.TextField.
Returns:
{sap.ui.base.Metadata} Metadata object describing this class
_checkChange(oEvent)
Compares the previous value with the current value and fires the change event if the TextField is editable and the value has changed.
Parameters:
{jQuery.Event}oEvent The event object.
addAriaDescribedBy(vAriaDescribedBy): sap.ui.commons.TextField
Adds some ariaDescribedBy into the association ariaDescribedBy.
Parameters:
{string|sap.ui.core.Control}vAriaDescribedBy the ariaDescribedBy to add; if empty, nothing is inserted
Returns:
{sap.ui.commons.TextField} Reference to this in order to allow method chaining
addAriaLabelledBy(vAriaLabelledBy): sap.ui.commons.TextField
Adds some ariaLabelledBy into the association ariaLabelledBy.
Parameters:
{string|sap.ui.core.Control}vAriaLabelledBy the ariaLabelledBy to add; if empty, nothing is inserted
Returns:
{sap.ui.commons.TextField} Reference to this in order to allow method chaining
attachChange(oData?, fnFunction, oListener?): sap.ui.commons.TextField
Attaches event handler fnFunction to the change event of this sap.ui.commons.TextField.

When called, the context of the event handler (its this) will be bound to oListener if specified, otherwise it will be bound to this sap.ui.commons.TextField itself.

Event is fired when the text in the field has changed AND the focus leaves the TextField or the Enter key is pressed.

Parameters:
{object}oData? An application-specific payload object that will be passed to the event handler along with the event object when firing the event
{function}fnFunction The function to be called when the event occurs
{object}oListener? Context object to call the event handler with. Defaults to this sap.ui.commons.TextField itself
Returns:
{sap.ui.commons.TextField} Reference to this in order to allow method chaining
attachLiveChange(oData?, fnFunction, oListener?): sap.ui.commons.TextField
Attaches event handler fnFunction to the liveChange event of this sap.ui.commons.TextField.

When called, the context of the event handler (its this) will be bound to oListener if specified, otherwise it will be bound to this sap.ui.commons.TextField itself.

This event if fired during typing into the TextField and returns the currently entered value. Note: This is not the content of the value property. The value property is only updated by ENTER and by leaving the control.

Parameters:
{object}oData? An application-specific payload object that will be passed to the event handler along with the event object when firing the event
{function}fnFunction The function to be called when the event occurs
{object}oListener? Context object to call the event handler with. Defaults to this sap.ui.commons.TextField itself
Returns:
{sap.ui.commons.TextField} Reference to this in order to allow method chaining
bindValue(oBindingInfo): sap.ui.commons.TextField
Binds property value to model data.

See ManagedObject.bindProperty for a detailed description of the possible properties of oBindingInfo

Parameters:
{object}oBindingInfo The binding information
Returns:
{sap.ui.commons.TextField} Reference to this in order to allow method chaining
detachChange(fnFunction, oListener): sap.ui.commons.TextField
Detaches event handler fnFunction from the change event of this sap.ui.commons.TextField.

The passed function and listener object must match the ones used for event registration.

Parameters:
{function}fnFunction The function to be called, when the event occurs
{object}oListener Context object on which the given function had to be called
Returns:
{sap.ui.commons.TextField} Reference to this in order to allow method chaining
detachLiveChange(fnFunction, oListener): sap.ui.commons.TextField
Detaches event handler fnFunction from the liveChange event of this sap.ui.commons.TextField.

The passed function and listener object must match the ones used for event registration.

Parameters:
{function}fnFunction The function to be called, when the event occurs
{object}oListener Context object on which the given function had to be called
Returns:
{sap.ui.commons.TextField} Reference to this in order to allow method chaining
fireChange(mArguments?): sap.ui.commons.TextField
Fires event change to attached listeners.

Expects the following event parameters:

  • newValue of type stringThe new / changed value of the TextField.
Parameters:
{Map}mArguments? The arguments to pass along with the event
Returns:
{sap.ui.commons.TextField} Reference to this in order to allow method chaining
fireLiveChange(mArguments?): sap.ui.commons.TextField
Fires event liveChange to attached listeners.

Expects the following event parameters:

  • liveValue of type stringCurrent visible value of the TextField.
Parameters:
{Map}mArguments? The arguments to pass along with the event
Returns:
{sap.ui.commons.TextField} Reference to this in order to allow method chaining
getAccessibilityInfo()
See:
{sap.ui.core.Control#getAccessibilityInfo}
getAccessibleRole(): sap.ui.core.AccessibleRole
Gets current value of property accessibleRole.

Accessibility role for the text field.

Default value is Textbox.

Returns:
{sap.ui.core.AccessibleRole} Value of property accessibleRole
getAriaDescribedBy(): sap.ui.core.Control[]
Returns array of IDs of the elements which are the current targets of the association ariaDescribedBy.
Returns:
{sap.ui.core.Control[]}
getAriaLabelledBy(): sap.ui.core.Control[]
Returns array of IDs of the elements which are the current targets of the association ariaLabelledBy.
Returns:
{sap.ui.core.Control[]}
getDesign(): sap.ui.core.Design
Gets current value of property design.

Font type. valid values are Standard and Monospace.

Default value is Standard.

Returns:
{sap.ui.core.Design} Value of property design
getEditable(): boolean
Gets current value of property editable.

Switches edit state of the control. Read-only fields have different colors, depending on theme setting.

Default value is true.

Returns:
{boolean} Value of property editable
getEnabled(): boolean
Gets current value of property enabled.

Switches enabled state of the control. Disabled fields have different colors, and can not be focused.

Default value is true.

Returns:
{boolean} Value of property enabled
getFocusInfo(): object
Returns an object representing the serialized focus information
Returns:
{object} an object representing the serialized focus information
getHelpId(): string
Gets current value of property helpId.

Unique identifier used for help service.

Default value is .

Returns:
{string} Value of property helpId
getImeMode(): sap.ui.core.ImeMode
Gets current value of property imeMode.

State of the Input Method Editor (IME).

Default value is Auto.

Returns:
{sap.ui.core.ImeMode} Value of property imeMode
getInputDomRef(): object
Method for accessing the DOM Ref of the input element.
Returns:
{object} DOM reference or null
getLiveValue(): string
Returns the current value of the TextField. In case of editing the TextField you can access the current value via this method. The validated value is accessible via the property value.
Returns:
{string} live value
getMaxLength(): int
Gets current value of property maxLength.

Maximum number of characters. Value '0' means the feature is switched off.

Default value is 0.

Returns:
{int} Value of property maxLength
getName(): string
Gets current value of property name.

The name property to be used in the HTML code (e.g. for HTML forms that send data to the server via 'submit').

Returns:
{string} Value of property name
getPlaceholder(): string
Gets current value of property placeholder.

Placeholder for the text field.

Since:
1.14.0
Returns:
{string} Value of property placeholder
getRequired(): boolean
Gets current value of property required.

Depending on theme the TextField is shown as required. If a Label is assigned to the TextField it will visualize the requires state too.

Default value is false.

Returns:
{boolean} Value of property required
getTextAlign(): sap.ui.core.TextAlign
Gets current value of property textAlign.

Sets the horizontal alignment of the text.

Default value is Begin.

Returns:
{sap.ui.core.TextAlign} Value of property textAlign
getTextDirection(): sap.ui.core.TextDirection
Gets current value of property textDirection.

Direction of the text. Possible values: "rtl", "ltr".

Default value is Inherit.

Returns:
{sap.ui.core.TextDirection} Value of property textDirection
getValue(): string
Gets current value of property value.

Text inside the TextField

Default value is .

Returns:
{string} Value of property value
getValueState(): sap.ui.core.ValueState
Gets current value of property valueState.

Visualizes warnings or errors related to the text field. Possible values: Warning, Error, Success.

Default value is None.

Returns:
{sap.ui.core.ValueState} Value of property valueState
getWidth(): sap.ui.core.CSSSize
Gets current value of property width.

Width of text field. When it is set (CSS-size such as % or px), this is the exact size. When left blank, the text field length defines the width.

Returns:
{sap.ui.core.CSSSize} Value of property width
onfocusin(oEvent)
Event handler called when control is receiving the focus
Parameters:
{jQuery.Event}oEvent The event object.
onkeyup(oEvent)
Event handler for keyup. fire the liveChange event
Parameters:
{jQuery.Event}oEvent The event object.
onsapenter(oEvent)
Event handler called when enter key is pressed.
Parameters:
{jQuery.Event}oEvent The event object.
See:
sap.ui.commons.TextField#onfocusout
onsapfocusleave(oEvent)
Event handler called when control is losing the focus
Parameters:
{jQuery.Event}oEvent The event object.
onselectstart(oEvent)
Event handler called when text selection starts. When the text field is disabled, the text should not be selectable, so cancel the event.
Parameters:
{jQuery.Event}oEvent The event object.
removeAllAriaDescribedBy(): sap.ui.core.Control[]
Removes all the controls in the association named ariaDescribedBy.
Returns:
{sap.ui.core.Control[]} An array of the removed elements (might be empty)
removeAllAriaLabelledBy(): sap.ui.core.Control[]
Removes all the controls in the association named ariaLabelledBy.
Returns:
{sap.ui.core.Control[]} An array of the removed elements (might be empty)
removeAriaDescribedBy(vAriaDescribedBy): sap.ui.core.Control
Removes an ariaDescribedBy from the association named ariaDescribedBy.
Parameters:
{int|string|sap.ui.core.Control}vAriaDescribedBy The ariaDescribedByto be removed or its index or ID
Returns:
{sap.ui.core.Control} the removed ariaDescribedBy or null
removeAriaLabelledBy(vAriaLabelledBy): sap.ui.core.Control
Removes an ariaLabelledBy from the association named ariaLabelledBy.
Parameters:
{int|string|sap.ui.core.Control}vAriaLabelledBy The ariaLabelledByto be removed or its index or ID
Returns:
{sap.ui.core.Control} the removed ariaLabelledBy or null
setAccessibleRole(sAccessibleRole): sap.ui.commons.TextField
Sets a new value for property accessibleRole.

Accessibility role for the text field.

When called with a value of null or undefined, the default value of the property will be restored.

Default value is Textbox.

Parameters:
{sap.ui.core.AccessibleRole}sAccessibleRole New value for property accessibleRole
Returns:
{sap.ui.commons.TextField} Reference to this in order to allow method chaining
setDesign(sDesign): sap.ui.commons.TextField
Sets a new value for property design.

Font type. valid values are Standard and Monospace.

When called with a value of null or undefined, the default value of the property will be restored.

Default value is Standard.

Parameters:
{sap.ui.core.Design}sDesign New value for property design
Returns:
{sap.ui.commons.TextField} Reference to this in order to allow method chaining
setEditable(bEditable): sap.ui.commons.TextField
Sets a new value for property editable.

Switches edit state of the control. Read-only fields have different colors, depending on theme setting.

When called with a value of null or undefined, the default value of the property will be restored.

Default value is true.

Parameters:
{boolean}bEditable New value for property editable
Returns:
{sap.ui.commons.TextField} Reference to this in order to allow method chaining
setEnabled(bEnabled): sap.ui.commons.TextField
Sets a new value for property enabled.

Switches enabled state of the control. Disabled fields have different colors, and can not be focused.

When called with a value of null or undefined, the default value of the property will be restored.

Default value is true.

Parameters:
{boolean}bEnabled New value for property enabled
Returns:
{sap.ui.commons.TextField} Reference to this in order to allow method chaining
setHelpId(sHelpId): sap.ui.commons.TextField
Sets a new value for property helpId.

Unique identifier used for help service.

When called with a value of null or undefined, the default value of the property will be restored.

Default value is .

Parameters:
{string}sHelpId New value for property helpId
Returns:
{sap.ui.commons.TextField} Reference to this in order to allow method chaining
setImeMode(sImeMode): sap.ui.commons.TextField
Sets a new value for property imeMode.

State of the Input Method Editor (IME).

When called with a value of null or undefined, the default value of the property will be restored.

Default value is Auto.

Parameters:
{sap.ui.core.ImeMode}sImeMode New value for property imeMode
Returns:
{sap.ui.commons.TextField} Reference to this in order to allow method chaining
setMaxLength(iMaxLength): sap.ui.commons.TextField
Sets a new value for property maxLength.

Maximum number of characters. Value '0' means the feature is switched off.

When called with a value of null or undefined, the default value of the property will be restored.

Default value is 0.

Parameters:
{int}iMaxLength New value for property maxLength
Returns:
{sap.ui.commons.TextField} Reference to this in order to allow method chaining
setName(sName): sap.ui.commons.TextField
Sets a new value for property name.

The name property to be used in the HTML code (e.g. for HTML forms that send data to the server via 'submit').

When called with a value of null or undefined, the default value of the property will be restored.

Parameters:
{string}sName New value for property name
Returns:
{sap.ui.commons.TextField} Reference to this in order to allow method chaining
setPlaceholder(sPlaceholder): sap.ui.commons.TextField
Sets a new value for property placeholder.

Placeholder for the text field.

When called with a value of null or undefined, the default value of the property will be restored.

Parameters:
{string}sPlaceholder New value for property placeholder
Since:
1.14.0
Returns:
{sap.ui.commons.TextField} Reference to this in order to allow method chaining
setRequired(bRequired): sap.ui.commons.TextField
Sets a new value for property required.

Depending on theme the TextField is shown as required. If a Label is assigned to the TextField it will visualize the requires state too.

When called with a value of null or undefined, the default value of the property will be restored.

Default value is false.

Parameters:
{boolean}bRequired New value for property required
Returns:
{sap.ui.commons.TextField} Reference to this in order to allow method chaining
setTextAlign(sTextAlign): sap.ui.commons.TextField
Sets a new value for property textAlign.

Sets the horizontal alignment of the text.

When called with a value of null or undefined, the default value of the property will be restored.

Default value is Begin.

Parameters:
{sap.ui.core.TextAlign}sTextAlign New value for property textAlign
Returns:
{sap.ui.commons.TextField} Reference to this in order to allow method chaining
setTextDirection(sTextDirection): sap.ui.commons.TextField
Sets a new value for property textDirection.

Direction of the text. Possible values: "rtl", "ltr".

When called with a value of null or undefined, the default value of the property will be restored.

Default value is Inherit.

Parameters:
{sap.ui.core.TextDirection}sTextDirection New value for property textDirection
Returns:
{sap.ui.commons.TextField} Reference to this in order to allow method chaining
setValue(sValue): sap.ui.commons.TextField
Sets a new value for property value.

Text inside the TextField

When called with a value of null or undefined, the default value of the property will be restored.

Default value is .

Parameters:
{string}sValue New value for property value
Returns:
{sap.ui.commons.TextField} Reference to this in order to allow method chaining
setValueState(sValueState): sap.ui.commons.TextField
Sets a new value for property valueState.

Visualizes warnings or errors related to the text field. Possible values: Warning, Error, Success.

When called with a value of null or undefined, the default value of the property will be restored.

Default value is None.

Parameters:
{sap.ui.core.ValueState}sValueState New value for property valueState
Returns:
{sap.ui.commons.TextField} Reference to this in order to allow method chaining
setWidth(sWidth): sap.ui.commons.TextField
Sets a new value for property width.

Width of text field. When it is set (CSS-size such as % or px), this is the exact size. When left blank, the text field length defines the width.

When called with a value of null or undefined, the default value of the property will be restored.

Parameters:
{sap.ui.core.CSSSize}sWidth New value for property width
Returns:
{sap.ui.commons.TextField} Reference to this in order to allow method chaining
unbindValue(): sap.ui.commons.TextField
Unbinds property value from model data.
Returns:
{sap.ui.commons.TextField} Reference to this in order to allow method chaining