2016-10-31 15:03:48 +08:00
---
2016-10-31 15:42:57 +08:00
order: 7
2016-10-31 15:03:48 +08:00
title:
zh-CN: 自定义表单控件
en-US: Customized Form Controls
---
## zh-CN
自定义或第三方的表单控件,也可以与 Form 组件一起使用。只要该组件遵循以下的约定:
> * 提供受控属性 `value` 或其它与 [`valuePropName`](http://ant.design/components/form/#getFieldDecorator-参数) 的值同名的属性。
> * 提供 `onChange` 事件或 [`trigger`](http://ant.design/components/form/#getFieldDecorator-参数) 的值同名的事件。
2017-04-10 22:42:56 +08:00
> * 不能是函数式组件。
2016-10-31 15:03:48 +08:00
## en-US
Customized or third-party form controls can be used in Form, too. Controls must follow these conventions:
> * It has a controlled property `value` or other name which is equal to the value of [`valuePropName`](http://ant.design/components/form/?locale=en-US#getFieldDecorator's-parameters).
> * It has event `onChange` or an event which name is equal to the value of [`trigger`](http://ant.design/components/form/?locale=en-US#getFieldDecorator's-parameters).
2017-04-10 22:42:56 +08:00
> * It must be a class component.
2016-10-31 15:03:48 +08:00
2017-02-13 10:55:53 +08:00
````jsx
2018-11-28 15:00:03 +08:00
import {
Form, Input, Select, Button,
} from 'antd';
2018-06-27 15:55:04 +08:00
2016-10-31 15:03:48 +08:00
const FormItem = Form.Item;
2016-11-21 18:29:36 +08:00
const Option = Select.Option;
2016-10-31 15:03:48 +08:00
2017-02-20 11:50:57 +08:00
class PriceInput extends React.Component {
2018-10-15 03:06:09 +08:00
static getDerivedStateFromProps(nextProps) {
// Should be a controlled component.
if ('value' in nextProps) {
return {
2018-10-21 13:29:43 +08:00
...(nextProps.value || {}),
2018-10-15 03:06:09 +08:00
};
}
return null;
}
2017-02-20 11:50:57 +08:00
constructor(props) {
super(props);
2018-04-18 14:08:06 +08:00
const value = props.value || {};
2017-02-20 11:50:57 +08:00
this.state = {
2016-11-21 18:29:36 +08:00
number: value.number || 0,
currency: value.currency || 'rmb',
2016-10-31 15:03:48 +08:00
};
2017-02-20 11:50:57 +08:00
}
2018-06-27 15:55:04 +08:00
2017-02-20 11:50:57 +08:00
handleNumberChange = (e) => {
2016-11-21 18:29:36 +08:00
const number = parseInt(e.target.value || 0, 10);
2018-12-06 16:44:56 +08:00
if (Number.isNaN(number)) {
2016-10-31 15:03:48 +08:00
return;
}
if (!('value' in this.props)) {
2016-11-21 18:29:36 +08:00
this.setState({ number });
2016-10-31 15:03:48 +08:00
}
2016-11-21 18:29:36 +08:00
this.triggerChange({ number });
2017-02-20 11:50:57 +08:00
}
2018-06-27 15:55:04 +08:00
2017-02-20 11:50:57 +08:00
handleCurrencyChange = (currency) => {
2016-11-21 18:29:36 +08:00
if (!('value' in this.props)) {
this.setState({ currency });
}
this.triggerChange({ currency });
2017-02-20 11:50:57 +08:00
}
2018-06-27 15:55:04 +08:00
2017-02-20 11:50:57 +08:00
triggerChange = (changedValue) => {
2016-10-31 15:03:48 +08:00
// Should provide an event to pass value to Form.
const onChange = this.props.onChange;
if (onChange) {
2016-11-21 18:29:36 +08:00
onChange(Object.assign({}, this.state, changedValue));
2016-10-31 15:03:48 +08:00
}
2017-02-20 11:50:57 +08:00
}
2018-06-27 15:55:04 +08:00
2016-10-31 15:03:48 +08:00
render() {
2016-11-21 18:29:36 +08:00
const { size } = this.props;
const state = this.state;
2016-10-31 15:03:48 +08:00
return (
2016-11-21 18:29:36 +08:00
< span >
< Input
type="text"
size={size}
value={state.number}
onChange={this.handleNumberChange}
style={{ width: '65%', marginRight: '3%' }}
/>
< Select
value={state.currency}
size={size}
style={{ width: '32%' }}
onChange={this.handleCurrencyChange}
>
< Option value = "rmb" > RMB< / Option >
< Option value = "dollar" > Dollar< / Option >
< / Select >
< / span >
2016-10-31 15:03:48 +08:00
);
2017-02-20 11:50:57 +08:00
}
}
2016-10-31 15:03:48 +08:00
2017-02-20 11:50:57 +08:00
class Demo extends React.Component {
handleSubmit = (e) => {
2016-10-31 15:03:48 +08:00
e.preventDefault();
this.props.form.validateFields((err, values) => {
2016-11-02 18:08:48 +08:00
if (!err) {
console.log('Received values of form: ', values);
2016-10-31 15:03:48 +08:00
}
});
2017-02-20 11:50:57 +08:00
}
2018-06-27 15:55:04 +08:00
2017-02-20 11:50:57 +08:00
checkPrice = (rule, value, callback) => {
2016-11-21 18:29:36 +08:00
if (value.number > 0) {
callback();
return;
}
callback('Price must greater than zero!');
2017-02-20 11:50:57 +08:00
}
2018-06-27 15:55:04 +08:00
2016-10-31 15:03:48 +08:00
render() {
const { getFieldDecorator } = this.props.form;
return (
2017-03-02 10:49:06 +08:00
< Form layout = "inline" onSubmit = {this.handleSubmit} >
2016-11-21 18:29:36 +08:00
< FormItem label = "Price" >
{getFieldDecorator('price', {
initialValue: { number: 0, currency: 'rmb' },
rules: [{ validator: this.checkPrice }],
})(< PriceInput / > )}
2016-10-31 15:03:48 +08:00
< / FormItem >
< FormItem >
< Button type = "primary" htmlType = "submit" > Submit< / Button >
< / FormItem >
< / Form >
);
2017-02-20 11:50:57 +08:00
}
}
const WrappedDemo = Form.create()(Demo);
2016-10-31 15:03:48 +08:00
2017-02-20 11:50:57 +08:00
ReactDOM.render(< WrappedDemo / > , mountNode);
2016-10-31 15:03:48 +08:00
````