import * as React from 'react'; import type { ReactNode } from 'react'; import { useContext, useMemo } from 'react'; import classNames from 'classnames'; import type { FormInstance } from 'rc-field-form'; import { Field, FieldContext, ListContext } from 'rc-field-form'; import type { FieldProps } from 'rc-field-form/lib/Field'; import type { Meta, NamePath } from 'rc-field-form/lib/interface'; import { supportRef } from 'rc-util/lib/ref'; import useState from 'rc-util/lib/hooks/useState'; import omit from 'rc-util/lib/omit'; import CheckCircleFilled from '@ant-design/icons/CheckCircleFilled'; import ExclamationCircleFilled from '@ant-design/icons/ExclamationCircleFilled'; import CloseCircleFilled from '@ant-design/icons/CloseCircleFilled'; import LoadingOutlined from '@ant-design/icons/LoadingOutlined'; import useStyle from './style'; import Row from '../grid/row'; import { ConfigContext } from '../config-provider'; import { tuple } from '../_util/type'; import devWarning from '../_util/devWarning'; import type { FormItemLabelProps, LabelTooltipType } from './FormItemLabel'; import FormItemLabel from './FormItemLabel'; import type { FormItemInputProps } from './FormItemInput'; import FormItemInput from './FormItemInput'; import type { FormItemStatusContextProps } from './context'; import { FormContext, FormItemInputContext, NoStyleItemContext } from './context'; import { toArray, getFieldId } from './util'; import { cloneElement, isValidElement } from '../_util/reactNode'; import useFrameState from './hooks/useFrameState'; import useDebounce from './hooks/useDebounce'; import useItemRef from './hooks/useItemRef'; const NAME_SPLIT = '__SPLIT__'; interface FieldError { errors: string[]; warnings: string[]; } const ValidateStatuses = tuple('success', 'warning', 'error', 'validating', ''); export type ValidateStatus = typeof ValidateStatuses[number]; type RenderChildren = (form: FormInstance) => React.ReactNode; type RcFieldProps = Omit, 'children'>; type ChildrenType = RenderChildren | React.ReactNode; interface MemoInputProps { value: any; update: any; children: React.ReactNode; } const MemoInput = React.memo( ({ children }: MemoInputProps) => children as JSX.Element, (prev, next) => prev.value === next.value && prev.update === next.update, ); export interface FormItemProps extends FormItemLabelProps, FormItemInputProps, RcFieldProps { prefixCls?: string; noStyle?: boolean; style?: React.CSSProperties; className?: string; children?: ChildrenType; id?: string; hasFeedback?: boolean; validateStatus?: ValidateStatus; required?: boolean; hidden?: boolean; initialValue?: any; messageVariables?: Record; tooltip?: LabelTooltipType; /** @deprecated No need anymore */ fieldKey?: React.Key | React.Key[]; } function hasValidName(name?: NamePath): Boolean { if (name === null) { devWarning(false, 'Form.Item', '`null` is passed as `name` property'); } return !(name === undefined || name === null); } function genEmptyMeta(): Meta { return { errors: [], warnings: [], touched: false, validating: false, name: [], }; } const iconMap = { success: CheckCircleFilled, warning: ExclamationCircleFilled, error: CloseCircleFilled, validating: LoadingOutlined, }; function FormItem(props: FormItemProps): React.ReactElement { const { name, noStyle, dependencies, prefixCls: customizePrefixCls, style, className, shouldUpdate, hasFeedback, help, rules, validateStatus, children, required, label, messageVariables, trigger = 'onChange', validateTrigger, hidden, ...restProps } = props; const { getPrefixCls } = useContext(ConfigContext); const { name: formName, requiredMark } = useContext(FormContext); const isRenderProps = typeof children === 'function'; const notifyParentMetaChange = useContext(NoStyleItemContext); const { validateTrigger: contextValidateTrigger } = useContext(FieldContext); const mergedValidateTrigger = validateTrigger !== undefined ? validateTrigger : contextValidateTrigger; const hasName = hasValidName(name); const prefixCls = getPrefixCls('form', customizePrefixCls); // Style const [wrapSSR, hashId] = useStyle(prefixCls); // ========================= MISC ========================= // Get `noStyle` required info const listContext = React.useContext(ListContext); const fieldKeyPathRef = React.useRef(); // ======================== Errors ======================== // >>>>> Collect sub field errors const [subFieldErrors, setSubFieldErrors] = useFrameState>({}); // >>>>> Current field errors const [meta, setMeta] = useState(() => genEmptyMeta()); const onMetaChange = (nextMeta: Meta & { destroy?: boolean }) => { // This keyInfo is not correct when field is removed // Since origin keyManager no longer keep the origin key anymore // Which means we need cache origin one and reuse when removed const keyInfo = listContext?.getKey(nextMeta.name); // Destroy will reset all the meta setMeta(nextMeta.destroy ? genEmptyMeta() : nextMeta, true); // Bump to parent since noStyle if (noStyle && notifyParentMetaChange) { let namePath = nextMeta.name; if (!nextMeta.destroy) { if (keyInfo !== undefined) { const [fieldKey, restPath] = keyInfo; namePath = [fieldKey, ...restPath]; fieldKeyPathRef.current = namePath; } } else { // Use origin cache data namePath = fieldKeyPathRef.current || namePath; } notifyParentMetaChange(nextMeta, namePath); } }; // >>>>> Collect noStyle Field error to the top FormItem const onSubItemMetaChange = (subMeta: Meta & { destroy: boolean }, uniqueKeys: React.Key[]) => { // Only `noStyle` sub item will trigger setSubFieldErrors(prevSubFieldErrors => { const clone = { ...prevSubFieldErrors, }; // name: ['user', 1] + key: [4] = ['user', 4] const mergedNamePath = [...subMeta.name.slice(0, -1), ...uniqueKeys]; const mergedNameKey = mergedNamePath.join(NAME_SPLIT); if (subMeta.destroy) { // Remove delete clone[mergedNameKey]; } else { // Update clone[mergedNameKey] = subMeta; } return clone; }); }; // >>>>> Get merged errors const [mergedErrors, mergedWarnings] = React.useMemo(() => { const errorList: string[] = [...meta.errors]; const warningList: string[] = [...meta.warnings]; Object.values(subFieldErrors).forEach(subFieldError => { errorList.push(...(subFieldError.errors || [])); warningList.push(...(subFieldError.warnings || [])); }); return [errorList, warningList]; }, [subFieldErrors, meta.errors, meta.warnings]); const debounceErrors = useDebounce(mergedErrors); const debounceWarnings = useDebounce(mergedWarnings); // ===================== Children Ref ===================== const getItemRef = useItemRef(); // ======================== Status ======================== let mergedValidateStatus: ValidateStatus = ''; if (validateStatus !== undefined) { mergedValidateStatus = validateStatus; } else if (meta?.validating) { mergedValidateStatus = 'validating'; } else if (debounceErrors.length) { mergedValidateStatus = 'error'; } else if (debounceWarnings.length) { mergedValidateStatus = 'warning'; } else if (meta?.touched) { mergedValidateStatus = 'success'; } const formItemStatusContext = useMemo(() => { let feedbackIcon: ReactNode; if (hasFeedback) { const IconNode = mergedValidateStatus && iconMap[mergedValidateStatus]; feedbackIcon = IconNode ? ( ) : null; } return { status: mergedValidateStatus, hasFeedback, feedbackIcon, isFormItemInput: true, }; }, [mergedValidateStatus, hasFeedback]); // ======================== Render ======================== function renderLayout( baseChildren: React.ReactNode, fieldId?: string, isRequired?: boolean, ): React.ReactNode { if (noStyle && !hidden) { return baseChildren; } const itemClassName = { [`${prefixCls}-item`]: true, [`${prefixCls}-item-with-help`]: (help !== undefined && help !== null) || debounceErrors.length || debounceWarnings.length, [`${className}`]: !!className, // Status [`${prefixCls}-item-has-feedback`]: mergedValidateStatus && hasFeedback, [`${prefixCls}-item-has-success`]: mergedValidateStatus === 'success', [`${prefixCls}-item-has-warning`]: mergedValidateStatus === 'warning', [`${prefixCls}-item-has-error`]: mergedValidateStatus === 'error', [`${prefixCls}-item-is-validating`]: mergedValidateStatus === 'validating', [`${prefixCls}-item-hidden`]: hidden, }; // ======================= Children ======================= return ( {/* Label */} {/* Input Group */} {baseChildren} ); } if (!hasName && !isRenderProps && !dependencies) { return wrapSSR(renderLayout(children) as JSX.Element); } let variables: Record = {}; if (typeof label === 'string') { variables.label = label; } else if (name) { variables.label = String(name); } if (messageVariables) { variables = { ...variables, ...messageVariables }; } // >>>>> With Field return wrapSSR( {(control, renderMeta, context) => { const mergedName = toArray(name).length && renderMeta ? renderMeta.name : []; const fieldId = getFieldId(mergedName, formName); const isRequired = required !== undefined ? required : !!( rules && rules.some(rule => { if (rule && typeof rule === 'object' && rule.required && !rule.warningOnly) { return true; } if (typeof rule === 'function') { const ruleEntity = rule(context); return ruleEntity && ruleEntity.required && !ruleEntity.warningOnly; } return false; }) ); // ======================= Children ======================= const mergedControl: typeof control = { ...control, }; let childNode: React.ReactNode = null; devWarning( !(shouldUpdate && dependencies), 'Form.Item', "`shouldUpdate` and `dependencies` shouldn't be used together. See https://ant.design/components/form/#dependencies.", ); if (Array.isArray(children) && hasName) { devWarning(false, 'Form.Item', '`children` is array of render props cannot have `name`.'); childNode = children; } else if (isRenderProps && (!(shouldUpdate || dependencies) || hasName)) { devWarning( !!(shouldUpdate || dependencies), 'Form.Item', '`children` of render props only work with `shouldUpdate` or `dependencies`.', ); devWarning( !hasName, 'Form.Item', "Do not use `name` with `children` of render props since it's not a field.", ); } else if (dependencies && !isRenderProps && !hasName) { devWarning( false, 'Form.Item', 'Must set `name` or use render props when `dependencies` is set.', ); } else if (isValidElement(children)) { devWarning( children.props.defaultValue === undefined, 'Form.Item', '`defaultValue` will not work on controlled Field. You should use `initialValues` of Form instead.', ); const childProps = { ...children.props, ...mergedControl }; if (!childProps.id) { childProps.id = fieldId; } if (supportRef(children)) { childProps.ref = getItemRef(mergedName, children); } // We should keep user origin event handler const triggers = new Set([ ...toArray(trigger), ...toArray(mergedValidateTrigger), ]); triggers.forEach(eventName => { childProps[eventName] = (...args: any[]) => { mergedControl[eventName]?.(...args); children.props[eventName]?.(...args); }; }); childNode = ( {cloneElement(children, childProps)} ); } else if (isRenderProps && (shouldUpdate || dependencies) && !hasName) { childNode = (children as RenderChildren)(context); } else { devWarning( !mergedName.length, 'Form.Item', '`name` is only used for validate React element. If you are using Form.Item as layout display, please remove `name` instead.', ); childNode = children as React.ReactNode; } return renderLayout(childNode, fieldId, isRequired); }} , ); } export default FormItem;