import * as React from 'react'; import * as ReactDOM from 'react-dom'; import PropTypes from 'prop-types'; import classNames from 'classnames'; import Animate from 'rc-animate'; import PureRenderMixin from 'rc-util/lib/PureRenderMixin'; import Row from '../grid/row'; import Col, { ColProps } from '../grid/col'; import warning from '../_util/warning'; import { FIELD_META_PROP, FIELD_DATA_PROP } from './constants'; export interface FormItemProps { prefixCls?: string; className?: string; id?: string; label?: React.ReactNode; labelCol?: ColProps; wrapperCol?: ColProps; help?: React.ReactNode; extra?: React.ReactNode; validateStatus?: 'success' | 'warning' | 'error' | 'validating'; hasFeedback?: boolean; required?: boolean; style?: React.CSSProperties; colon?: boolean; } export interface FormItemContext { vertical: boolean; } export default class FormItem extends React.Component { static defaultProps = { hasFeedback: false, prefixCls: 'ant-form', colon: true, }; static propTypes = { prefixCls: PropTypes.string, label: PropTypes.oneOfType([PropTypes.string, PropTypes.node]), labelCol: PropTypes.object, help: PropTypes.oneOfType([PropTypes.node, PropTypes.bool]), validateStatus: PropTypes.oneOf(['', 'success', 'warning', 'error', 'validating']), hasFeedback: PropTypes.bool, wrapperCol: PropTypes.object, className: PropTypes.string, id: PropTypes.string, children: PropTypes.node, colon: PropTypes.bool, }; static contextTypes = { vertical: PropTypes.bool, }; context: FormItemContext; componentDidMount() { warning( this.getControls(this.props.children, true).length <= 1, '`Form.Item` cannot generate `validateStatus` and `help` automatically, ' + 'while there are more than one `getFieldDecorator` in it.', ); } shouldComponentUpdate(...args: any[]) { return PureRenderMixin.shouldComponentUpdate.apply(this, args); } getHelpMsg() { const props = this.props; const onlyControl = this.getOnlyControl(); if (props.help === undefined && onlyControl) { const errors = this.getField().errors; return errors ? errors.map((e: any) => e.message).join(', ') : ''; } return props.help; } getControls(children: React.ReactNode, recursively: boolean) { let controls: React.ReactElement[] = []; const childrenArray = React.Children.toArray(children); for (let i = 0; i < childrenArray.length; i++) { if (!recursively && controls.length > 0) { break; } const child = childrenArray[i] as React.ReactElement; if (child.type && (child.type as any === FormItem || (child.type as any).displayName === 'FormItem')) { continue; } if (!child.props) { continue; } if (FIELD_META_PROP in child.props) { // And means FIELD_DATA_PROP in chidl.props, too. controls.push(child); } else if (child.props.children) { controls = controls.concat(this.getControls(child.props.children, recursively)); } } return controls; } getOnlyControl() { const child = this.getControls(this.props.children, false)[0]; return child !== undefined ? child : null; } getChildProp(prop: string) { const child = this.getOnlyControl() as React.ReactElement; return child && child.props && child.props[prop]; } getId() { return this.getChildProp('id'); } getMeta() { return this.getChildProp(FIELD_META_PROP); } getField() { return this.getChildProp(FIELD_DATA_PROP); } renderHelp() { const prefixCls = this.props.prefixCls; const help = this.getHelpMsg(); const children = help ? (
{help}
) : null; return ( {children} ); } renderExtra() { const { prefixCls, extra } = this.props; return extra ? (
{extra}
) : null; } getValidateStatus() { const onlyControl = this.getOnlyControl(); if (!onlyControl) { return ''; } const field = this.getField(); if (field.validating) { return 'validating'; } if (field.errors) { return 'error'; } const fieldValue = 'value' in field ? field.value : this.getMeta().initialValue; if (fieldValue !== undefined && fieldValue !== null && fieldValue !== '') { return 'success'; } return ''; } renderValidateWrapper(c1: React.ReactNode, c2: React.ReactNode, c3: React.ReactNode) { const props = this.props; const onlyControl = this.getOnlyControl; const validateStatus = (props.validateStatus === undefined && onlyControl) ? this.getValidateStatus() : props.validateStatus; let classes = `${this.props.prefixCls}-item-control`; if (validateStatus) { classes = classNames(`${this.props.prefixCls}-item-control`, { 'has-feedback': props.hasFeedback || validateStatus === 'validating', 'has-success': validateStatus === 'success', 'has-warning': validateStatus === 'warning', 'has-error': validateStatus === 'error', 'is-validating': validateStatus === 'validating', }); } return (
{c1}{c2}{c3}
); } renderWrapper(children: React.ReactNode) { const { prefixCls, wrapperCol } = this.props; const className = classNames( `${prefixCls}-item-control-wrapper`, wrapperCol && wrapperCol.className, ); return ( {children} ); } isRequired() { const { required } = this.props; if (required !== undefined) { return required; } if (this.getOnlyControl()) { const meta = this.getMeta() || {}; const validate = meta.validate || []; return validate.filter((item: any) => !!item.rules).some((item: any) => { return item.rules.some((rule: any) => rule.required); }); } return false; } // Resolve duplicated ids bug between different forms // https://github.com/ant-design/ant-design/issues/7351 onLabelClick = () => { const id = this.props.id || this.getId(); if (!id) { return; } const controls = document.querySelectorAll(`[id="${id}"]`); if (controls.length !== 1) { const control = ReactDOM.findDOMNode(this).querySelector(`[id="${id}"]`) as HTMLElement; if (control && control.focus) { control.focus(); } } } renderLabel() { const { prefixCls, label, labelCol, colon, id } = this.props; const context = this.context; const required = this.isRequired(); const labelColClassName = classNames( `${prefixCls}-item-label`, labelCol && labelCol.className, ); const labelClassName = classNames({ [`${prefixCls}-item-required`]: required, }); let labelChildren = label; // Keep label is original where there should have no colon const haveColon = colon && !context.vertical; // Remove duplicated user input colon if (haveColon && typeof label === 'string' && (label as string).trim() !== '') { labelChildren = (label as string).replace(/[:|:]\s*$/, ''); } return label ? ( ) : null; } renderChildren() { const { children } = this.props; return [ this.renderLabel(), this.renderWrapper( this.renderValidateWrapper( children, this.renderHelp(), this.renderExtra(), ), ), ]; } renderFormItem(children: React.ReactNode) { const props = this.props; const prefixCls = props.prefixCls; const style = props.style; const itemClassName = { [`${prefixCls}-item`]: true, [`${prefixCls}-item-with-help`]: !!this.getHelpMsg(), [`${prefixCls}-item-no-colon`]: !props.colon, [`${props.className}`]: !!props.className, }; return ( {children} ); } render() { const children = this.renderChildren(); return this.renderFormItem(children); } }