ant-design/components/input/index.zh-CN.md
2017-11-30 09:53:32 +08:00

2.7 KiB
Raw Blame History

category subtitle type title
Components 输入框 Data Entry Input

通过鼠标或键盘输入内容,是最基础的表单域的包装。

何时使用

  • 需要用户输入表单域内容时。
  • 提供组合型输入框,带搜索的输入框,还可以进行大小选择。

API

Input

参数 说明 类型 默认值
addonAfter 带标签的 input设置后置标签 string|ReactNode
addonBefore 带标签的 input设置前置标签 string|ReactNode
defaultValue 输入框默认内容 string
disabled 是否禁用状态,默认为 false boolean false
id 输入框的 id string
prefix 带有前缀图标的 input string|ReactNode
size 控件大小。注:标准表单内的输入框大小限制为 large。可选 large default small string default
suffix 带有后缀图标的 input string|ReactNode
type 声明 input 类型,同原生 input 标签的 type 属性,见:MDN(请直接使用 Input.TextArea 代替 type="textarea")。 string text
value 输入框内容 string
onPressEnter 按下回车的回调 function(e)

如果 InputForm.Item 内,并且 Form.Item 设置了 idoptions 属性,则 value defaultValueid 属性会被自动设置。

Input 的其他属性和 React 自带的 input 一致。

Input.TextArea

2.12 后新增的组件,旧版请使用 Input[type=textarea]

参数 说明 类型 默认值
autosize 自适应内容高度,可设置为 `true false 或对象:{ minRows: 2, maxRows: 6 }` boolean|object
defaultValue 输入框默认内容 string
value 输入框内容 string
onPressEnter 按下回车的回调 function(e)

Input.TextArea 的其他属性和浏览器自带的 textarea 一致。

Input.Search

参数 说明 类型 默认值
enterButton 是否有确认按钮,可设为按钮文字 boolean|ReactNode false
onSearch 点击搜索或按下回车键时的回调 function(value)

其余属性和 Input 一致。

Input.Group

参数 说明 类型 默认值
compact 是否用紧凑模式 boolean false
size Input.Group 中所有的 Input 的大小,可选 large default small string default
<Input.Group>
  <Input />
  <Input />
</Input.Group>