Input 输入框

用于接收用户的文本输入。

变体

提供边框和填充两种视觉风格。

禁用状态

尺寸

提供三种尺寸选项。

块级

充满父容器宽度的输入框。

前后缀

复合

预设

Search

Password

Number

OTP

API

Input Props

继承自 Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'value' | 'defaultValue' | 'onChange'>

属性名	描述	类型	默认值
variant	视觉样式。	'outlined' | 'filled'	-
size	尺寸。	'small' | 'medium' | 'large'	-
block	撑满父容器。	boolean	-
disabled	禁用状态。	boolean	-
value	受控值。	string | number	-
defaultValue	默认值。	string | number	-
onChange	值变化回调。	(value: string | number, evt: ChangeEvent<HTMLInputElement>) => void	-

Input.Append Props

等价于 HTMLAttributes<HTMLDivElement>

Input.Composite Props

继承自 HTMLAttributes<HTMLDivElement>

属性名	描述	类型	默认值
variant	视觉样式。	'outlined' | 'filled'	-
size	尺寸。	'small' | 'medium' | 'large'	-
disabled	禁用状态。	boolean	-
block	撑满父容器。	boolean	-
children	组合内容。	ReactElement<InputProps | HTMLAttributes<HTMLDivElement> | HTMLAttributes<HTMLDivElement>, string | JSXElementConstructor<any>> | Array<ReactElement<InputProps | HTMLAttributes<HTMLDivElement> | HTMLAttributes<HTMLDivElement>, string | JSXElementConstructor<any>>>	-

Input.Number Props

继承自 Omit<InputProps, 'value' | 'defaultValue' | 'onChange'>

属性名	描述	类型	默认值
min	最小值。	number	-
max	最大值。	number	-
step	步进值。	number	-
value	受控数值。	number	-
defaultValue	默认数值。	number	-
onChange	数值变化回调；无法解析时为 undefined。	(value: undefined | number, evt?: ChangeEvent<HTMLInputElement>) => void	-

Input.OTP Props

继承自 Omit<HTMLAttributes<HTMLSpanElement>, 'placeholder' | 'onFocus' | 'onChange'>, Pick<InputProps, 'variant' | 'type' | 'block' | 'size' | 'disabled'>

属性名	描述	类型	默认值
placeholder	占位文本。	string[]	-
length	位数。	number	-
separator	分隔内容。	ReactNode | (index: number) => ReactNode	-
value	受控字符数组。	string[]	-
defaultValue	默认字符数组。	string[]	-
onFocus	单格聚焦回调。	(index: number, evt: FocusEvent<HTMLInputElement>) => void	-
onBlur	整体失焦回调。	(evt: FocusEvent<HTMLSpanElement>) => void	-
onChange	字符变化回调。	(value: string[], evt: SyntheticEvent) => void	-
onComplete	填满回调。	(value: string[], evt: SyntheticEvent) => void	-

Input.Password Props

继承自 Omit<InputProps, 'value' | 'defaultValue' | 'onChange'>

属性名	描述	类型	默认值
value	受控值。	string	-
defaultValue	默认值。	string	-
onChange	值变化回调。	(value: string, evt: ChangeEvent<HTMLInputElement>) => void	-
visible	受控明文状态。	boolean	-
defaultVisible	默认明文状态。	boolean	-
onVisibleChange	明文状态变化回调。	(visible: boolean) => void	-

Input.Prefix Props

等价于 HTMLAttributes<HTMLSpanElement>

Input.Prepend Props

等价于 HTMLAttributes<HTMLDivElement>

Input.Search Props

继承自 Omit<InputProps, 'value' | 'defaultValue' | 'onChange'>

属性名	描述	类型	默认值
value	受控值。	string	-
defaultValue	默认值。	string	-
keyword	受控关键字，优先于 value。	string	-
defaultKeyword	默认关键字，优先于 defaultValue。	string	-
onChange	关键字变化回调。	(value: string, evt: ChangeEvent<HTMLInputElement>) => void	-
onSearch	搜索回调。	(value: string) => void	-

Input.Suffix Props

等价于 HTMLAttributes<HTMLSpanElement>