import React from 'react'; import PropTypes from 'prop-types'; import classNames from 'classnames'; import createDOMForm from 'rc-form/lib/createDOMForm'; import PureRenderMixin from 'rc-util/lib/PureRenderMixin'; import omit from 'omit.js'; import createReactClass from 'create-react-class'; import warning from '../_util/warning'; import FormItem from './FormItem'; import { FIELD_META_PROP } from './constants'; export interface FormCreateOption { onFieldsChange?: (props: T, fields: Array) => void; onValuesChange?: (props: T, values: any) => void; mapPropsToFields?: (props: T) => void; withRef?: boolean; } export interface FormProps { layout?: 'horizontal' | 'inline' | 'vertical'; horizontal?: boolean; inline?: boolean; vertical?: boolean; form?: WrappedFormUtils; onSubmit?: React.FormEventHandler; style?: React.CSSProperties; className?: string; prefixCls?: string; hideRequiredMark?: boolean; } export type ValidationRule = { /** validation error message */ message?: string; /** built-in validation type, available options: https://github.com/yiminghe/async-validator#type */ type?: string; /** indicates whether field is required */ required?: boolean; /** treat required fields that only contain whitespace as errors */ whitespace?: boolean; /** validate the exact length of a field */ len?: number; /** validate the min length of a field */ min?: number; /** validate the max length of a field */ max?: number; /** validate the value from a list of possible values */ enum?: string | string[]; /** validate from a regular expression */ pattern?: RegExp; /** transform a value before validation */ transform?: (value: any) => any; /** custom validate function (Note: callback must be called) */ validator?: (rule: any, value: any, callback: any, source?: any, options?: any) => any; }; export type ValidateCallback = (errors: any, values: any) => void; export type GetFieldDecoratorOptions = { /** 子节点的值的属性,如 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?: ValidationRule[]; /** 是否和其他控件互斥,特别用于 Radio 单选控件 */ exclusive?: boolean; /** Normalize value to form component */ normalize?: (value: any, prevValue: any, allValues: any) => any; /** Whether stop validate on first rule of error for this field. */ validateFirst?: boolean; }; // 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: ValidateCallback): any; validateFields(fieldNames: Array, callback: ValidateCallback): any; validateFields(options: Object, callback: ValidateCallback): any; validateFields(callback: ValidateCallback): any; /** 与 `validateFields` 相似,但校验完后,如果校验不通过的菜单域不在可见范围内,则自动滚动进可见范围 */ validateFieldsAndScroll(fieldNames?: Array, options?: Object, callback?: ValidateCallback): void; validateFieldsAndScroll(fieldNames?: Array, callback?: ValidateCallback): void; validateFieldsAndScroll(options?: Object, callback?: ValidateCallback): void; validateFieldsAndScroll(callback?: ValidateCallback): void; /** 获取某个输入控件的 Error */ getFieldError(name: string): Object[]; getFieldsError(names?: Array): Object; /** 判断一个输入控件是否在校验状态*/ isFieldValidating(name: string): boolean; isFieldTouched(name: string): boolean; isFieldsTouched(names?: Array): boolean; /** 重置一组输入控件的值与状态,如不传入参数,则重置所有组件 */ resetFields(names?: Array): void; getFieldDecorator(id: string, options?: GetFieldDecoratorOptions): (node: React.ReactNode) => React.ReactNode; }; export interface FormComponentProps { form: WrappedFormUtils; } export type Diff = ({ [P in T]: P } & { [P in U]: never } & { [x: string]: never })[T]; export type Omit = Pick>; export interface ComponentDecorator {

( component: React.ComponentClass

, ): React.ComponentClass & TOwnProps>; } export default class Form extends React.Component { static defaultProps = { prefixCls: 'ant-form', layout: 'horizontal', hideRequiredMark: false, onSubmit(e) { e.preventDefault(); }, }; static propTypes = { prefixCls: PropTypes.string, layout: PropTypes.oneOf(['horizontal', 'inline', 'vertical']), children: PropTypes.any, onSubmit: PropTypes.func, hideRequiredMark: PropTypes.bool, }; static childContextTypes = { vertical: PropTypes.bool, }; static Item = FormItem; static create = function(options: FormCreateOption = {}): ComponentDecorator { const formWrapper = createDOMForm({ fieldNameProp: 'id', ...options, fieldMetaProp: FIELD_META_PROP, }); /* eslint-disable react/prefer-es6-class */ return (Component) => formWrapper(createReactClass({ 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: https://u.ant.design/get-field-decorator', ); return this.__getFieldProps(name, option); }, render() { this.props.form.getFieldProps = this.deprecatedGetFieldProps; const withRef: any = {}; if (options.withRef) { withRef.ref = 'formWrappedComponent'; } else if (this.props.wrappedComponentRef) { withRef.ref = this.props.wrappedComponentRef; } 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() { const { layout, vertical } = this.props; return { vertical: layout === 'vertical' || vertical, }; } render() { const { prefixCls, hideRequiredMark, className = '', layout, // @deprecated inline, horizontal, vertical, } = this.props; warning( !inline && !horizontal && !vertical, '`Form[inline|horizontal|vertical]` is deprecated, please use `Form[layout]` instead.', ); const formClassName = classNames(prefixCls, { [`${prefixCls}-horizontal`]: (!inline && !vertical && layout === 'horizontal') || horizontal, [`${prefixCls}-vertical`]: layout === 'vertical' || vertical, [`${prefixCls}-inline`]: layout === 'inline' || inline, [`${prefixCls}-hide-required-mark`]: hideRequiredMark, }, className); const formProps = omit(this.props, [ 'prefixCls', 'className', 'layout', 'inline', 'horizontal', 'vertical', 'form', 'hideRequiredMark', ]); return

; } }