import React from 'react'; import { PropTypes } from 'react'; import classNames from 'classnames'; import createDOMForm from 'rc-form/lib/createDOMForm'; import PureRenderMixin from 'rc-util/lib/PureRenderMixin'; import omit from 'omit.js'; import assign from 'object-assign'; import warning from '../_util/warning'; import FormItem from './FormItem'; import { FIELD_META_PROP } from './constants'; export interface FormCreateOption { onFieldsChange?: (props: any, fields: Array) => void; mapPropsToFields?: (props: any) => void; withRef?: boolean; } export interface FormProps { horizontal?: boolean; inline?: boolean; vertical?: boolean; form?: WrappedFormUtils; onSubmit?: React.FormEventHandler; style?: React.CSSProperties; className?: string; prefixCls?: string; } // function create export type WrappedFormUtils = { /** 获取一组输入控件的值,如不传入参数,则获取全部组件的值 */ getFieldsValue(fieldNames?: Array): Object; /** 获取一个输入控件的值*/ getFieldValue(fieldName: string): any; /** 设置一组输入控件的值*/ setFieldsValue(obj: Object): void; /** 设置一组输入控件的值*/ setFields(obj: Object): void; /** 校验并获取一组输入域的值与 Error */ validateFields(fieldNames: Array, options: Object, callback: (erros: any, values: any) => void): any; validateFields(fieldNames: Array, callback: (erros: any, values: any) => void): any; validateFields(options: Object, callback: (erros: any, values: any) => void): any; validateFields(callback: (erros: any, values: any) => void): any; /** 与 `validateFields` 相似,但校验完后,如果校验不通过的菜单域不在可见范围内,则自动滚动进可见范围 */ validateFieldsAndScroll(fieldNames?: Array, options?: Object, callback?: (erros: any, values: any) => void): void; /** 获取某个输入控件的 Error */ getFieldError(name: string): Object[]; /** 判断一个输入控件是否在校验状态*/ isFieldValidating(name: string): boolean; /** 重置一组输入控件的值与状态,如不传入参数,则重置所有组件 */ resetFields(names?: Array): void; getFieldDecorator(id: string, options: { /** 子节点的值的属性,如 Checkbox 的是 'checked' */ valuePropName?: string; /** 子节点的初始值,类型、可选值均由子节点决定 */ initialValue?: any; /** 收集子节点的值的时机 */ trigger?: string; /** 可以把 onChange 的参数转化为控件的值,例如 DatePicker 可设为:(date, dateString) => dateString */ getValueFromEvent?: (...args: any[]) => any; /** 校验子节点值的时机 */ validateTrigger?: string | string[]; /** 校验规则,参见 [async-validator](https://github.com/yiminghe/async-validator) */ rules?: Array; /** 是否和其他控件互斥,特别用于 Radio 单选控件 */ exclusive?: boolean; }): (node: React.ReactNode) => React.ReactNode; } export interface FormComponentProps { form?: WrappedFormUtils; } export class FormComponent extends React.Component { } export interface ComponentDecorator { (component: T): T; } export default class Form extends React.Component { static defaultProps = { prefixCls: 'ant-form', onSubmit(e) { e.preventDefault(); }, }; static propTypes = { prefixCls: React.PropTypes.string, vertical: React.PropTypes.bool, horizontal: React.PropTypes.bool, inline: React.PropTypes.bool, children: React.PropTypes.any, onSubmit: React.PropTypes.func, }; static childContextTypes = { vertical: PropTypes.bool, }; static Item = FormItem; static create = (options?: FormCreateOption): ComponentDecorator => { const formWrapper = createDOMForm(assign({ fieldNameProp: 'id', }, options, { fieldMetaProp: FIELD_META_PROP, })); /* eslint-disable react/prefer-es6-class */ return (Component) => formWrapper(React.createClass({ propTypes: { form: PropTypes.object.isRequired, }, childContextTypes: { form: PropTypes.object.isRequired, }, getChildContext() { return { form: this.props.form, }; }, componentWillMount() { this.__getFieldProps = this.props.form.getFieldProps; }, deprecatedGetFieldProps(name, option) { warning( false, '`getFieldProps` is not recommended, please use `getFieldDecorator` instead, ' + 'see: http://u.ant.design/get-field-decorator' ); return this.__getFieldProps(name, option); }, render() { this.props.form.getFieldProps = this.deprecatedGetFieldProps; const withRef: any = {}; if (options && options.withRef) { withRef.ref = 'formWrappedComponent'; } return ; }, })); }; constructor(props) { super(props); warning(!props.form, 'It is unnecessary to pass `form` to `Form` after antd@1.7.0.'); } shouldComponentUpdate(...args) { return PureRenderMixin.shouldComponentUpdate.apply(this, args); } getChildContext() { return { vertical: this.props.vertical, }; } render() { const { prefixCls, className = '', inline, horizontal, vertical } = this.props; const formClassName = classNames(prefixCls, { [`${prefixCls}-horizontal`]: horizontal, [`${prefixCls}-vertical`]: vertical, [`${prefixCls}-inline`]: inline, }, className); const formProps = omit(this.props, [ 'prefixCls', 'className', 'inline', 'horizontal', 'vertical', 'form', ]); return
; } }