2016-05-25 18:21:27 +08:00
|
|
|
|
---
|
|
|
|
|
category: Components
|
2016-09-21 11:28:38 +08:00
|
|
|
|
subtitle: 输入框
|
2022-11-09 12:28:04 +08:00
|
|
|
|
group: 数据录入
|
2016-09-21 11:28:38 +08:00
|
|
|
|
title: Input
|
2022-11-30 20:14:41 +08:00
|
|
|
|
cover: https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*Y3R0RowXHlAAAAAAAAAAAAAADrJ8AQ/original
|
2023-02-09 22:17:31 +08:00
|
|
|
|
coverDark: https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*sBqqTatJ-AkAAAAAAAAAAAAADrJ8AQ/original
|
2022-11-09 12:28:04 +08:00
|
|
|
|
demo:
|
|
|
|
|
cols: 2
|
2016-05-25 18:21:27 +08:00
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
通过鼠标或键盘输入内容,是最基础的表单域的包装。
|
|
|
|
|
|
|
|
|
|
## 何时使用
|
|
|
|
|
|
|
|
|
|
- 需要用户输入表单域内容时。
|
|
|
|
|
- 提供组合型输入框,带搜索的输入框,还可以进行大小选择。
|
|
|
|
|
|
2022-11-09 12:28:04 +08:00
|
|
|
|
## 代码演示
|
|
|
|
|
|
2022-11-17 17:31:26 +08:00
|
|
|
|
<!-- prettier-ignore -->
|
2022-11-09 12:28:04 +08:00
|
|
|
|
<code src="./demo/basic.tsx">基本使用</code>
|
|
|
|
|
<code src="./demo/size.tsx">三种大小</code>
|
|
|
|
|
<code src="./demo/addon.tsx">前置/后置标签</code>
|
2023-03-09 21:26:56 +08:00
|
|
|
|
<code src="./demo/compact-style.tsx">紧凑模式</code>
|
|
|
|
|
<code src="./demo/group.tsx" debug>输入框组合</code>
|
2022-11-09 12:28:04 +08:00
|
|
|
|
<code src="./demo/search-input.tsx">搜索框</code>
|
|
|
|
|
<code src="./demo/search-input-loading.tsx">搜索框 loading</code>
|
|
|
|
|
<code src="./demo/textarea.tsx">文本域</code>
|
|
|
|
|
<code src="./demo/autosize-textarea.tsx">适应文本高度的文本域</code>
|
|
|
|
|
<code src="./demo/tooltip.tsx">输入时格式化展示</code>
|
|
|
|
|
<code src="./demo/presuffix.tsx">前缀和后缀</code>
|
|
|
|
|
<code src="./demo/password-input.tsx">密码框</code>
|
|
|
|
|
<code src="./demo/allowClear.tsx">带移除图标</code>
|
|
|
|
|
<code src="./demo/show-count.tsx">带字数提示</code>
|
|
|
|
|
<code src="./demo/textarea-show-count.tsx">带字数提示的文本域</code>
|
|
|
|
|
<code src="./demo/status.tsx">自定义状态</code>
|
|
|
|
|
<code src="./demo/borderless.tsx">无边框</code>
|
|
|
|
|
<code src="./demo/focus.tsx">聚焦</code>
|
|
|
|
|
<code src="./demo/borderless-debug.tsx" debug>Style Debug</code>
|
|
|
|
|
<code src="./demo/align.tsx" debug>文本对齐</code>
|
|
|
|
|
<code src="./demo/textarea-resize.tsx" debug>文本域</code>
|
|
|
|
|
<code src="./demo/debug-addon.tsx" debug>debug 前置/后置标签</code>
|
|
|
|
|
|
2016-05-25 18:21:27 +08:00
|
|
|
|
## API
|
|
|
|
|
|
|
|
|
|
### Input
|
|
|
|
|
|
2022-11-17 17:31:26 +08:00
|
|
|
|
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|
|
|
|
|
| --- | --- | --- | --- | --- |
|
|
|
|
|
| addonAfter | 带标签的 input,设置后置标签 | ReactNode | - | |
|
|
|
|
|
| addonBefore | 带标签的 input,设置前置标签 | ReactNode | - | |
|
|
|
|
|
| allowClear | 可以点击清除图标删除内容 | boolean \| { clearIcon: ReactNode } | - | |
|
|
|
|
|
| bordered | 是否有边框 | boolean | true | 4.5.0 |
|
|
|
|
|
| defaultValue | 输入框默认内容 | string | - | |
|
|
|
|
|
| disabled | 是否禁用状态,默认为 false | boolean | false | |
|
|
|
|
|
| id | 输入框的 id | string | - | |
|
|
|
|
|
| maxLength | 最大长度 | number | - | |
|
|
|
|
|
| showCount | 是否展示字数 | boolean \| { formatter: (info: { value: string, count: number, maxLength?: number }) => ReactNode } | false | 4.18.0 info.value: 4.23.0 |
|
|
|
|
|
| status | 设置校验状态 | 'error' \| 'warning' | - | 4.19.0 |
|
|
|
|
|
| prefix | 带有前缀图标的 input | ReactNode | - | |
|
|
|
|
|
| size | 控件大小。注:标准表单内的输入框大小限制为 `middle` | `large` \| `middle` \| `small` | - | |
|
|
|
|
|
| suffix | 带有后缀图标的 input | ReactNode | - | |
|
|
|
|
|
| type | 声明 input 类型,同原生 input 标签的 type 属性,见:[MDN](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/input#属性)(请直接使用 `Input.TextArea` 代替 `type="textarea"`) | string | `text` | |
|
|
|
|
|
| value | 输入框内容 | string | - | |
|
|
|
|
|
| onChange | 输入框内容变化时的回调 | function(e) | - | |
|
|
|
|
|
| onPressEnter | 按下回车的回调 | function(e) | - | |
|
2016-05-25 18:21:27 +08:00
|
|
|
|
|
|
|
|
|
> 如果 `Input` 在 `Form.Item` 内,并且 `Form.Item` 设置了 `id` 和 `options` 属性,则 `value` `defaultValue` 和 `id` 属性会被自动设置。
|
|
|
|
|
|
2021-01-01 21:40:00 +08:00
|
|
|
|
Input 的其他属性和 React 自带的 [input](https://reactjs.org/docs/dom-elements.html#all-supported-html-attributes) 一致。
|
2017-01-09 22:03:10 +08:00
|
|
|
|
|
2017-05-22 14:44:58 +08:00
|
|
|
|
### Input.TextArea
|
|
|
|
|
|
2022-11-17 17:31:26 +08:00
|
|
|
|
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|
|
|
|
|
| --- | --- | --- | --- | --- |
|
|
|
|
|
| allowClear | 可以点击清除图标删除内容 | boolean | false | |
|
|
|
|
|
| autoSize | 自适应内容高度,可设置为 true \| false 或对象:{ minRows: 2, maxRows: 6 } | boolean \| object | false | |
|
|
|
|
|
| bordered | 是否有边框 | boolean | true | 4.5.0 |
|
|
|
|
|
| defaultValue | 输入框默认内容 | string | - | |
|
|
|
|
|
| maxLength | 内容最大长度 | number | - | 4.7.0 |
|
|
|
|
|
| showCount | 是否展示字数 | boolean \| { formatter: (info: { value: string, count: number, maxLength?: number }) => string } | false | 4.7.0 formatter: 4.10.0 info.value: 4.23.0 |
|
|
|
|
|
| value | 输入框内容 | string | - | |
|
|
|
|
|
| onPressEnter | 按下回车的回调 | function(e) | - | |
|
|
|
|
|
| onResize | resize 回调 | function({ width, height }) | - | |
|
2017-05-22 14:44:58 +08:00
|
|
|
|
|
|
|
|
|
`Input.TextArea` 的其他属性和浏览器自带的 [textarea](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/textarea) 一致。
|
|
|
|
|
|
2016-11-24 14:03:57 +08:00
|
|
|
|
#### Input.Search
|
|
|
|
|
|
2022-11-17 17:31:26 +08:00
|
|
|
|
| 参数 | 说明 | 类型 | 默认值 |
|
|
|
|
|
| --- | --- | --- | --- |
|
|
|
|
|
| enterButton | 是否有确认按钮,可设为按钮文字。该属性会与 `addonAfter` 冲突。 | boolean \| ReactNode | false |
|
|
|
|
|
| loading | 搜索 loading | boolean | false |
|
|
|
|
|
| onSearch | 点击搜索图标、清除图标,或按下回车键时的回调 | function(value, event) | - |
|
2016-11-24 14:56:08 +08:00
|
|
|
|
|
|
|
|
|
其余属性和 Input 一致。
|
2016-11-24 14:03:57 +08:00
|
|
|
|
|
2019-11-22 14:37:39 +08:00
|
|
|
|
#### Input.Password
|
2018-11-29 10:03:16 +08:00
|
|
|
|
|
2022-11-17 17:31:26 +08:00
|
|
|
|
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|
|
|
|
|
| --- | --- | --- | --- | --- |
|
|
|
|
|
| iconRender | 自定义切换按钮 | (visible) => ReactNode | (visible) => (visible ? <EyeOutlined /> : <EyeInvisibleOutlined />) | 4.3.0 |
|
2022-12-22 14:12:26 +08:00
|
|
|
|
| visibilityToggle | 是否显示切换按钮或者控制密码显隐 | boolean \| [VisibilityToggle](#visibilitytoggle) | true | |
|
2022-10-31 21:15:59 +08:00
|
|
|
|
|
|
|
|
|
#### VisibilityToggle
|
|
|
|
|
|
|
|
|
|
| Property | Description | Type | Default | Version |
|
|
|
|
|
| --------------- | -------------------- | ------- | ------- | ------- |
|
|
|
|
|
| visible | 用于手动控制密码显隐 | boolean | false | 4.24 |
|
|
|
|
|
| onVisibleChange | 显隐密码的回调 | boolean | - | 4.24 |
|
2019-02-20 15:12:29 +08:00
|
|
|
|
|
2020-12-29 22:42:04 +08:00
|
|
|
|
#### Input Methods
|
|
|
|
|
|
2022-11-17 17:31:26 +08:00
|
|
|
|
| 名称 | 说明 | 参数 | 版本 |
|
|
|
|
|
| --- | --- | --- | --- |
|
|
|
|
|
| blur | 取消焦点 | - | |
|
2020-12-29 22:42:04 +08:00
|
|
|
|
| focus | 获取焦点 | (option?: { preventScroll?: boolean, cursor?: 'start' \| 'end' \| 'all' }) | option - 4.10.0 |
|
|
|
|
|
|
2019-02-20 15:12:29 +08:00
|
|
|
|
## FAQ
|
|
|
|
|
|
2022-04-20 10:33:42 +08:00
|
|
|
|
### 为什么我动态改变 `prefix/suffix/showCount` 时,Input 会失去焦点?
|
2019-02-20 15:12:29 +08:00
|
|
|
|
|
2022-04-20 10:33:42 +08:00
|
|
|
|
当 Input 动态添加或者删除 `prefix/suffix/showCount` 时,React 会重新创建 DOM 结构而新的 input 是没有焦点的。你可以预设一个空的 `<span />` 来保持 DOM 结构不变:
|
2019-02-20 15:12:29 +08:00
|
|
|
|
|
|
|
|
|
```jsx
|
|
|
|
|
const suffix = condition ? <Icon type="smile" /> : <span />;
|
|
|
|
|
|
2019-05-07 14:57:32 +08:00
|
|
|
|
<Input suffix={suffix} />;
|
2019-02-20 15:12:29 +08:00
|
|
|
|
```
|
2021-03-23 15:03:47 +08:00
|
|
|
|
|
|
|
|
|
### 为何 TextArea 受控时,`value` 可以超过 `maxLength`?
|
|
|
|
|
|
|
|
|
|
受控时,组件应该按照受控内容展示。以防止在表单组件内使用时显示值和提交值不同的问题。
|