Input Text (Deprecated)

ui:inputText

Deprecated as of API version 47.0. We recommend migrating to Lightning Web Components and using the lightning-input component.

For Use In

Lightning Experience, Experience Builder Sites, Salesforce Mobile App, Lightning Out (Beta), Standalone Lightning App

Deprecation Guidelines

We recommend using Lightning Web Components whenever possible. When migrating to Lightning Web Components, use lightning-input.

For more information, see Aura Components in the ui Namespace Are Deprecated.

Usage Overview (Deprecated)

A ui:inputText component represents a text input field, which is rendered as an HTML input tag of type text. To apply Lightning Design System styling, we recommend that you use lightning:input instead of ui:inputText.

This is a basic set up of a text field.

1<ui:inputText label="Expense Name" value="My Expense" required="true" />

This example results in the following HTML.

1<div class="uiInput uiInputTextuiInput--default uiInput--input">
2  <label class="uiLabel-left form-element__label uiLabel">
3    <span>Expense Name</span>
4
5    <span class="required">*</span>
6  </label>
7
8  <input required="required" class="input" type="text" />
9</div>

To create forms for Salesforce objects without using Apex controllers, use lightning:inputField with lightning:recordEditForm, or use lightning:recordForm. To create an input field for different data types, use lightning:input.

Note

Attributes

Name	Description	Type	Default
body	The body of the component. In markup, this is everything in the body of the tag.	Aura.Component[]
class	A CSS style to be attached to the component. This style is added in addition to base styles output by the component.	String
disabled	Specifies whether the component should be displayed in a disabled state. Default value is "false".	Boolean	false
errors	The list of errors to be displayed.	Object[]
label	The text of the label component	String
labelClass	The CSS class of the label component	String
maxlength	The maximum number of characters that can be typed into the input field. Corresponds to the maxlength attribute of the rendered HTML input element.	Integer
placeholder	Text that is displayed when the field is empty, to prompt the user for a valid entry.	String
required	Specifies whether the input is required. Default value is "false".	Boolean	false
requiredIndicatorClass	The CSS class of the required indicator component	String
size	The width of the input field, in characters. Corresponds to the size attribute of the rendered HTML input element.	Integer
updateOn	Updates the component's value binding if the updateOn attribute is set to the handled event. Default value is "change".	String	change
value	The value currently in the input field.	String

Input Text (Deprecated)

Deprecation Guidelines

Usage Overview (Deprecated)

Attributes

Lightning Component Reference

Contents