import * as React from 'react'; import { useForm as useRcForm, FormInstance as RcFormInstance } from 'rc-field-form'; import scrollIntoView from 'scroll-into-view-if-needed'; type InternalNamePath = (string | number)[]; /** * Always debounce error to avoid [error -> null -> error] blink */ export function useCacheErrors( errors: React.ReactNode[], changeTrigger: (visible: boolean) => void, ): [boolean, React.ReactNode[]] { const cacheRef = React.useRef({ errors, visible: !!errors.length, }); React.useEffect(() => { const timeout = setTimeout(() => { const prevVisible = cacheRef.current.visible; const newVisible = !!errors.length; cacheRef.current.errors = errors; cacheRef.current.visible = newVisible; if (prevVisible !== newVisible) { changeTrigger(newVisible); } }, 10); return () => clearTimeout(timeout); }, [errors]); return [cacheRef.current.visible, cacheRef.current.errors]; } export function toArray(candidate?: T | T[] | false): T[] { if (candidate === undefined || candidate === false) return []; return Array.isArray(candidate) ? candidate : [candidate]; } export function getFieldId(namePath: InternalNamePath, formName?: string): string | undefined { if (!namePath.length) return undefined; const mergedId = namePath.join('_'); return formName ? `${formName}_${mergedId}` : mergedId; } export interface FormInstance extends RcFormInstance { scrollToField: (name: string | number | InternalNamePath) => void; __INTERNAL__: { name?: string; }; } export function useForm(form?: FormInstance): [FormInstance] { const wrapForm: FormInstance = form || { ...useRcForm()[0], __INTERNAL__: {}, scrollToField: name => { const namePath = toArray(name); const fieldId = getFieldId(namePath, wrapForm.__INTERNAL__.name); const node: HTMLElement | null = fieldId ? document.getElementById(fieldId) : null; if (node) { scrollIntoView(node, { scrollMode: 'if-needed', block: 'nearest', }); } }, }; return [wrapForm]; }