mirror of
https://gitee.com/ant-design/ant-design.git
synced 2024-12-01 03:29:39 +08:00
:clipper: Add complex form control demo for Form
https://github.com/ant-design/ant-design/issues/20481#issuecomment-569184410
This commit is contained in:
afc163
parent
fa31150bc1
commit
08ab82d17f
129
components/form/demo/complex-form-control.md
Normal file
129
components/form/demo/complex-form-control.md
Normal file
@ -0,0 +1,129 @@
|
||||
---
|
||||
order: 6
|
||||
title:
|
||||
zh-CN: 复杂一点的控件
|
||||
en-US: complex form control
|
||||
---
|
||||
|
||||
## zh-CN
|
||||
|
||||
这里演示 `Form.Item` 内有多个元素的使用方式。`<Form.Item name="field" />` 只会对它的直接子元素绑定表单功能，例如直接包裹了 Input/Select。如果控件前后还有一些文案或样式装点，或者一个表单项内有多个控件，你可以使用内嵌的 `Form.Item` 完成。你可以给 `Form.Item` 自定义 `style` 进行内联布局，或者添加 `noStyle` 作为纯粹的无样式绑定组件（类似 3.x 中的 `getFieldDecorator`）。
|
||||
|
||||
```diff
|
||||
- <Form.Item label="Field" name="field">
|
||||
- <Input />
|
||||
- </Form.Item/>
|
||||
+ <Form.Item label="Field">
|
||||
+ <Form.Item name="field" onStyle><Input /><Form.Item> // 直接包裹才会绑定表单
|
||||
+ <span>description</span>
|
||||
+ </Form.Item/>
|
||||
```
|
||||
|
||||
这里展示了三种典型场景：
|
||||
|
||||
- `Username`：输入框后面有描述文案或其他组件，在 `Form.Item` 内使用 `<Form.Item name="field" noStyle />` 去绑定对应子控件。
|
||||
- `Address`：有两个控件，在 `Form.Item` 内使用两个 `<Form.Item name="field" noStyle />` 分别绑定对应控件。
|
||||
- `BirthDate`：有两个内联控件，错误信息展示各自控件下，使用两个 `<Form.Item name="field" />` 分别绑定对应控件，并修改 `style` 使其内联布局。
|
||||
|
||||
> 注意，在 label 对应的 Form.Item 上不要在指定 `name` 属性，这个 Item 只作为布局作用。
|
||||
|
||||
更复杂的封装复用方式可以参考下面的 `自定义表单控件` 演示。
|
||||
|
||||
## en-US
|
||||
|
||||
This demo show how to use `Form.Item` with multiple controls. `<Form.Item name="field" />` will only bind control(Input/Select) which is the only children of it. Image this case, you add some text description after Input, then you have to wrap Input by a extra `<Form.item name="field">`. `style` property of `Form.Item` could be useful to modify the nested form item layout, or `<Form.Item noStyle />` turn it into a pure form bind component(like `getFieldDecorator` in 3.x).
|
||||
|
||||
```diff
|
||||
- <Form.Item label="Field" name="field">
|
||||
- <Input />
|
||||
- </Form.Item/>
|
||||
+ <Form.Item label="Field">
|
||||
+ <Form.Item name="field" onStyle><Input /><Form.Item> // that will bind input
|
||||
+ <span>description</span>
|
||||
+ </Form.Item/>
|
||||
```
|
||||
|
||||
This demo show three typical usages:
|
||||
|
||||
- `Username`: extra elements after control, using `<Form.Item name="field" noStyle />` inside `Form.Item` to bind Input.
|
||||
- `Address`: two controls in one line, using two `<Form.Item name="field" noStyle />` to bind each control.
|
||||
- `BirthDate`：two controls in one line with indeptent error message, using two `<Form.Item name="field" noStyle />` to bind each control, make layout inline by customizing `style` property.
|
||||
|
||||
> Note, in this case, no more `name` property should be left in Form.Item with label.
|
||||
|
||||
See `Customized Form Controls` demo below for further advanced usage.
|
||||
|
||||
```jsx
|
||||
import { Form, Input, Select, Tooltip, Button } from 'antd';
|
||||
|
||||
const { Option } = Select;
|
||||
|
||||
const Demo = () => {
|
||||
const onFinish = values => {
|
||||
console.log('Received values of form: ', values);
|
||||
};
|
||||
|
||||
return (
|
||||
<Form name="complex-form" onFinish={onFinish} labelCol={{ span: 8 }} wrapperCol={{ span: 16 }}>
|
||||
<Form.Item label="Username">
|
||||
<Form.Item
|
||||
name="username"
|
||||
noStyle
|
||||
rules={[{ required: true, message: 'Username is required' }]}
|
||||
>
|
||||
<Input style={{ width: 160 }} placeholder="Please input" />
|
||||
</Form.Item>
|
||||
<Tooltip title="Useful information">
|
||||
<a href="#API" style={{ marginLeft: 8 }}>
|
||||
Need Help?
|
||||
</a>
|
||||
</Tooltip>
|
||||
</Form.Item>
|
||||
<Form.Item label="Address">
|
||||
<Input.Group compact>
|
||||
<Form.Item
|
||||
name={['address', 'province']}
|
||||
noStyle
|
||||
rules={[{ required: true, message: 'Province is required' }]}
|
||||
>
|
||||
<Select placeholder="Select province">
|
||||
<Option value="Zhejiang">Zhejiang</Option>
|
||||
<Option value="Jiangsu">Jiangsu</Option>
|
||||
</Select>
|
||||
</Form.Item>
|
||||
<Form.Item
|
||||
name={['address', 'street']}
|
||||
noStyle
|
||||
rules={[{ required: true, message: 'Street is required' }]}
|
||||
>
|
||||
<Input style={{ width: '50%' }} placeholder="Input street" />
|
||||
</Form.Item>
|
||||
</Input.Group>
|
||||
</Form.Item>
|
||||
<Form.Item label="BirthDate" style={{ marginBottom: 0 }}>
|
||||
<Form.Item
|
||||
name="year"
|
||||
rules={[{ required: true }]}
|
||||
style={{ display: 'inline-block', width: 'calc(50% - 5px)', marginRight: 8 }}
|
||||
>
|
||||
<Input placeholder="Input birth year" />
|
||||
</Form.Item>
|
||||
<Form.Item
|
||||
name="month"
|
||||
rules={[{ required: true }]}
|
||||
style={{ display: 'inline-block', width: 'calc(50% - 5px)' }}
|
||||
>
|
||||
<Input placeholder="Input birth month" />
|
||||
</Form.Item>
|
||||
</Form.Item>
|
||||
<Form.Item label=" " colon={false}>
|
||||
<Button type="primary" htmlType="submit">
|
||||
Submit
|
||||
</Button>
|
||||
</Form.Item>
|
||||
</Form>
|
||||
);
|
||||
};
|
||||
|
||||
ReactDOM.render(<Demo />, mountNode);
|
||||
```
|
||||
@ -1,5 +1,5 @@
|
||||
---
|
||||
order: 6
|
||||
order: 6.1
|
||||
title:
|
||||
zh-CN: 自定义表单控件
|
||||
en-US: Customized Form Controls
|
||||
|
||||
Loading…
Reference in New Issue
Block a user