import * as React from 'react'; import { useMemo } from 'react'; import classNames from 'classnames'; import FieldForm, { List, useWatch } from 'rc-field-form'; import type { FormProps as RcFormProps } from 'rc-field-form/lib/Form'; import type { FormRef, InternalNamePath, ValidateErrorEntity } from 'rc-field-form/lib/interface'; import type { Options } from 'scroll-into-view-if-needed'; import { ConfigContext } from '../config-provider'; import DisabledContext, { DisabledContextProvider } from '../config-provider/DisabledContext'; import useCSSVarCls from '../config-provider/hooks/useCSSVarCls'; import useSize from '../config-provider/hooks/useSize'; import type { SizeType } from '../config-provider/SizeContext'; import SizeContext from '../config-provider/SizeContext'; import type { ColProps } from '../grid/col'; import type { FormContextProps } from './context'; import { FormContext, FormProvider, VariantContext } from './context'; import type { FeedbackIcons } from './FormItem'; import useForm from './hooks/useForm'; import type { FormInstance } from './hooks/useForm'; import useFormWarning from './hooks/useFormWarning'; import type { Variant } from '../config-provider'; import type { FormLabelAlign } from './interface'; import useStyle from './style'; import ValidateMessagesContext from './validateMessagesContext'; export type RequiredMark = | boolean | 'optional' | ((labelNode: React.ReactNode, info: { required: boolean }) => React.ReactNode); export type FormLayout = 'horizontal' | 'inline' | 'vertical'; export type FormItemLayout = 'horizontal' | 'vertical'; export interface FormProps extends Omit, 'form'> { prefixCls?: string; colon?: boolean; name?: string; layout?: FormLayout; labelAlign?: FormLabelAlign; labelWrap?: boolean; labelCol?: ColProps; wrapperCol?: ColProps; form?: FormInstance; feedbackIcons?: FeedbackIcons; size?: SizeType; disabled?: boolean; scrollToFirstError?: Options | boolean; requiredMark?: RequiredMark; /** @deprecated Will warning in future branch. Pls use `requiredMark` instead. */ hideRequiredMark?: boolean; rootClassName?: string; variant?: Variant; } const InternalForm: React.ForwardRefRenderFunction = (props, ref) => { const contextDisabled = React.useContext(DisabledContext); const { getPrefixCls, direction, form: contextForm } = React.useContext(ConfigContext); const { prefixCls: customizePrefixCls, className, rootClassName, size, disabled = contextDisabled, form, colon, labelAlign, labelWrap, labelCol, wrapperCol, hideRequiredMark, layout = 'horizontal', scrollToFirstError, requiredMark, onFinishFailed, name, style, feedbackIcons, variant, ...restFormProps } = props; const mergedSize = useSize(size); const contextValidateMessages = React.useContext(ValidateMessagesContext); if (process.env.NODE_ENV !== 'production') { // eslint-disable-next-line react-hooks/rules-of-hooks useFormWarning(props); } const mergedRequiredMark = useMemo(() => { if (requiredMark !== undefined) { return requiredMark; } if (hideRequiredMark) { return false; } if (contextForm && contextForm.requiredMark !== undefined) { return contextForm.requiredMark; } return true; }, [hideRequiredMark, requiredMark, contextForm]); const mergedColon = colon ?? contextForm?.colon; const prefixCls = getPrefixCls('form', customizePrefixCls); // Style const rootCls = useCSSVarCls(prefixCls); const [wrapCSSVar, hashId, cssVarCls] = useStyle(prefixCls, rootCls); const formClassName = classNames( prefixCls, `${prefixCls}-${layout}`, { [`${prefixCls}-hide-required-mark`]: mergedRequiredMark === false, [`${prefixCls}-rtl`]: direction === 'rtl', [`${prefixCls}-${mergedSize}`]: mergedSize, }, cssVarCls, rootCls, hashId, contextForm?.className, className, rootClassName, ); const [wrapForm] = useForm(form); const { __INTERNAL__ } = wrapForm; __INTERNAL__.name = name; const formContextValue = useMemo( () => ({ name, labelAlign, labelCol, labelWrap, wrapperCol, vertical: layout === 'vertical', colon: mergedColon, requiredMark: mergedRequiredMark, itemRef: __INTERNAL__.itemRef, form: wrapForm, feedbackIcons, }), [ name, labelAlign, labelCol, wrapperCol, layout, mergedColon, mergedRequiredMark, wrapForm, feedbackIcons, ], ); const nativeElementRef = React.useRef(null); React.useImperativeHandle(ref, () => ({ ...wrapForm, nativeElement: nativeElementRef.current?.nativeElement, })); const scrollToField = (options: boolean | Options, fieldName: InternalNamePath) => { if (options) { let defaultScrollToFirstError: Options = { block: 'nearest' }; if (typeof options === 'object') { defaultScrollToFirstError = options; } wrapForm.scrollToField(fieldName, defaultScrollToFirstError); } }; const onInternalFinishFailed = (errorInfo: ValidateErrorEntity) => { onFinishFailed?.(errorInfo); if (errorInfo.errorFields.length) { const fieldName = errorInfo.errorFields[0].name; if (scrollToFirstError !== undefined) { scrollToField(scrollToFirstError, fieldName); return; } if (contextForm && contextForm.scrollToFirstError !== undefined) { scrollToField(contextForm.scrollToFirstError, fieldName); } } }; return wrapCSSVar( , ); }; const Form = React.forwardRef(InternalForm) as (( props: React.PropsWithChildren> & React.RefAttributes>, ) => React.ReactElement) & Pick; if (process.env.NODE_ENV !== 'production') { Form.displayName = 'Form'; } export { List, useForm, useWatch, type FormInstance }; export default Form;