ant-design/components/input/index.en-US.md

category	type	title
Components	Data Entry	Input

A basic widget for getting the user input is a text field. Keyboard and mouse can be used for providing or changing data.

When To Use

• A user input in a form field is needed.
• A search input is required.

API

Input

Property	Description	Type	Default	Version
addonAfter	The label text displayed after (on the right side of) the input field.	string|ReactNode
addonBefore	The label text displayed before (on the left side of) the input field.	string|ReactNode
defaultValue	The initial input content	string
disabled	Whether the input is disabled.	boolean	false
id	The ID for input	string
maxLength	max length	number
prefix	The prefix icon for the Input.	string|ReactNode
size	The size of the input box. Note: in the context of a form, the large size is used. Available: large default small	string	default
suffix	The suffix icon for the Input.	string|ReactNode
type	The type of input, see: MDN(use Input.TextArea instead of type="textarea")	string	text
value	The input content value	string
onChange	callback when user input	function(e)		3.9.3
onPressEnter	The callback function that is triggered when Enter key is pressed.	function(e)
allowClear	allow to remove input content with clear icon	boolean		3.12.0

When Input is used in a Form.Item context, if the Form.Item has the id and options props defined then value, defaultValue, and id props of Input are automatically set.

The rest of the props of Input are exactly the same as the original input.

Input.TextArea

If you are using antd@<2.12, please use Input[type=textarea].

Property	Description	Type	Default	Version
autoSize	Height autosize feature, can be set to `true	falseor an object{ minRows: 2, maxRows: 6 }. autosizeis deprecated after3.24.0, please use autoSize`.	boolean|object	false
defaultValue	The initial input content	string
value	The input content value	string
onPressEnter	The callback function that is triggered when Enter key is pressed.	function(e)
allowClear	allow to remove input content with clear icon	boolean

The rest of the props of Input.TextArea are the same as the original textarea.

Input.Search

Added in 2.5.0

Property	Description	Type	Default	Version
enterButton	to show an enter button after input. This prop is conflict with addon.	boolean|ReactNode	false
onSearch	The callback function triggered when you click on the search-icon, the clear-icon or press the Enter key.	function(value, event)
loading	Search box with loading.	boolean

Supports all props of Input.

Input.Group

Property	Description	Type	Default	Version
compact	Whether use compact style	boolean	false
size	The size of Input.Group specifies the size of the included Input fields. Available: large default small	string	default

<Input.Group>
  <input />
  <input />
</Input.Group>

Input.Password (Added in 3.12.0)

Property	Description	Type	Default	Version
visibilityToggle	Whether show toggle button	boolean	true	3.12.2

FAQ

Why Input lose focus when change prefix/suffix

When Input dynamic add or remove prefix/suffix will make React recreate the dom structure and new input will be not focused. You can set an empty <span /> element to keep the dom structure:

const suffix = condition ? <Icon type="smile" /> : <span />;

<Input suffix={suffix} />;