@hw-component/form 0.0.5 → 0.0.6-beta-v1

package/src/components/Form/Context/index.tsx

@@ -0,0 +1,14 @@
+import React, { useContext } from "react";
+import type {
+  IFormConfigContextProps,
+  FormContextProps,
+} from "@/components/Form/modal";
+
+export const FormContext = React.createContext<Partial<FormContextProps>>({});
+export const useFormContext = (): FormContextProps => {
+  return useContext(FormContext) as FormContextProps;
+};
+
+export const FormConfigContext = React.createContext<IFormConfigContextProps>(
+  {}
+);

package/src/components/Form/FormItem/BasicItem.tsx

@@ -0,0 +1,76 @@
+import Label from "../Label";
+import { Form, Space } from "antd";
+import React from "react";
+import Helper from "./Helper";
+import { useClassName } from "../../hooks";
+import { useHide } from "./hooks";
+import { useFormContext } from "../Context";
+import type { HItemProps } from "../modal";
+import { useDefaultRender } from "../hooks/useDefaultRender";
+import type { HFormItemProps } from "../modal";
+import { useDefaultComponents } from "../hooks";
+
+interface ContentProps extends Omit<HItemProps, "name"> {
+  value?: any;
+  onChange?: (val: any) => void;
+}
+const Content: React.FC<ContentProps> = ({
+  children,
+  helper,
+  value,
+  onChange,
+}) => {
+  const className = useClassName("hw-form-base-item");
+  const relChild =
+    children && React.cloneElement(children as any, { value, onChange });
+  return (
+    <Space direction={"vertical"} size={4} style={{ width: "100%" }}>
+      <div className={className}>{relChild}</div>
+      <Helper helper={helper} />
+    </Space>
+  );
+};
+
+const Index: React.FC<HFormItemProps> = (props) => {
+  const {
+    hover,
+    labelWidth,
+    required,
+    colon = true,
+    label,
+    itemProps,
+    children,
+    helper,
+    hide,
+    render,
+    ...oProps
+  } = props;
+  const { form } = useFormContext();
+  const defaultComponent = useDefaultComponents();
+  const defaultRender = useDefaultRender(props, defaultComponent);
+  const hideItem = useHide({ hide, form });
+  if (hideItem) {
+    return null;
+  }
+  return (
+    <Form.Item
+      label={
+        <Label
+          hover={hover}
+          labelWidth={labelWidth}
+          required={required}
+          colon={colon}
+        >
+          {label}
+        </Label>
+      }
+      {...oProps}
+      colon={false}
+      required={false}
+    >
+      <Content helper={helper}>{defaultRender(form)}</Content>
+    </Form.Item>
+  );
+};
+
+export default Index;

package/src/components/Form/FormItem/Helper.tsx

@@ -0,0 +1,25 @@
+import React from "react";
+import type { HItemProps, HFormInstance } from "@/components/Form/modal";
+import { Typography } from "antd";
+import { useFormContext } from "../Context";
+
+interface HelperProps {
+  helper?: HItemProps["helper"];
+}
+
+const Index: React.FC<HelperProps> = ({ helper }) => {
+  const { form } = useFormContext();
+  if (!helper) {
+    return null;
+  }
+  if (typeof helper === "function") {
+    return (
+      <Typography.Text type={"secondary"}>
+        {helper(form as HFormInstance)}
+      </Typography.Text>
+    );
+  }
+  return <Typography.Text type={"secondary"}>{helper}</Typography.Text>;
+};
+
+export default Index;

package/src/components/Form/FormItem/RegularFormItem.tsx

@@ -0,0 +1,7 @@
+import BasicItem from "./BasicItem";
+import type { HItemProps } from "../modal";
+
+export default (props: HItemProps) => {
+  const { type, colon } = props;
+  return <BasicItem {...props} colon={type === "submit" ? false : colon} />;
+};

package/src/components/Form/FormItem/UpFormItem.tsx

@@ -0,0 +1,20 @@
+import { Form } from "antd";
+import BasicItem from "./BasicItem";
+import { useShouldUpdate } from "./hooks";
+import type { HFormItemProps } from "../modal";
+const { Item } = Form;
+export default ({
+  shouldUpdate,
+  dependencies,
+  hide,
+  ...props
+}: HFormItemProps) => {
+  const resultShouldUpdate = useShouldUpdate({ shouldUpdate, hide });
+  return (
+    <Item shouldUpdate={resultShouldUpdate} dependencies={dependencies} noStyle>
+      {() => {
+        return <BasicItem hide={hide} {...props} />;
+      }}
+    </Item>
+  );
+};

package/src/components/Form/FormItem/hooks.tsx

@@ -0,0 +1,40 @@
+import UpFormItem from "./UpFormItem";
+import RegularFormItem from "./RegularFormItem";
+import { useMemo } from "react";
+import type { HFormInstance, HItemProps } from "../modal";
+
+export const useFormItemDomControl = ({
+  shouldUpdate,
+  hide,
+  dependencies,
+}: HItemProps) => {
+  return useMemo(() => {
+    if (shouldUpdate || typeof hide === "function" || dependencies) {
+      return UpFormItem;
+    }
+    return RegularFormItem;
+  }, [shouldUpdate, hide]);
+}; //更新或者不更新组件
+
+interface UseHideUpItemModal extends Omit<HItemProps, "name"> {
+  form: HFormInstance;
+}
+export const useShouldUpdate = ({
+  hide,
+  shouldUpdate,
+}: Omit<HItemProps, "name">) => {
+  if (typeof hide === "function" && !shouldUpdate) {
+    return true;
+  }
+  return shouldUpdate;
+};
+
+export const useHide = ({ hide, form }: UseHideUpItemModal) => {
+  if (hide === true) {
+    return true;
+  }
+  if (typeof hide === "function") {
+    return hide(form);
+  }
+  return !!hide;
+};

package/src/components/Form/FormItem/index.tsx

@@ -0,0 +1,8 @@
+import { useFormItemDomControl } from "./hooks";
+import React from "react";
+import type { HItemProps } from "../modal";
+
+export default (props: HItemProps) => {
+  const Component = useFormItemDomControl(props);
+  return <Component {...props} />;
+};

package/src/components/Form/HFormConnect.tsx

@@ -0,0 +1,67 @@
+import { useFormContext } from "./Context";
+import type { HFormItemProps } from "@/components/Form/modal";
+import React, { useEffect } from "react";
+import type { ConnectConfigModal } from "@/components/Form/modal";
+import type { addFormatItemModal } from "@/components/Form/modal";
+import type { ConnectResultProps } from "@/components/Form/modal";
+import type { argsFn } from "@/components/Form/modal";
+
+const formatMaker = (
+  itemProps: HFormItemProps,
+  formats?: addFormatItemModal
+) => {
+  if (!formats) {
+    return formats;
+  }
+  const { inputValue, outputValue } = formats;
+  return {
+    inputValue: (value) => {
+      return inputValue(itemProps, value);
+    },
+    outputValue: (value) => {
+      return outputValue(itemProps, value);
+    },
+  };
+};
+
+export default (
+  component:
+    | React.FunctionComponent
+    | React.ComponentClass
+    | React.ForwardRefRenderFunction<any, any>,
+  config: ConnectConfigModal = {}
+) => {
+  const { format = {} } = config;
+  const Index: React.ForwardRefRenderFunction<any, HFormItemProps> = (
+    props: HFormItemProps,
+    ref
+  ) => {
+    const { name = "", dispatch } = props;
+
+    const { form, valueType = "float" } = useFormContext();
+
+    useEffect(() => {
+      form?.addFormat(name, formatMaker(props, format[valueType]));
+    }, [valueType, props]);
+
+    const addFormat = (aFormat: Record<string, addFormatItemModal>) => {
+      form?.addFormat(name, formatMaker(props, aFormat[valueType]));
+    };
+    const addDispatchListener = (key: string, fn: argsFn) => {
+      form?.addDispatchListener({ key, name, dispatch }, fn);
+    };
+    const Component = component as React.ForwardRefRenderFunction<
+      any,
+      ConnectResultProps
+    >;
+    return (
+      <Component
+        {...props}
+        addFormat={addFormat}
+        addDispatchListener={addDispatchListener}
+        ref={ref}
+      />
+    );
+  };
+  return React.forwardRef(Index);
+};

package/src/components/Form/InitSet.tsx

@@ -0,0 +1,10 @@
+import { useFormContext } from "./Context";
+import { useEffect } from "react";
+
+export default () => {
+  const { form } = useFormContext();
+  useEffect(() => {
+    form.initValues();
+  }, []);
+  return <></>;
+};

package/src/components/Form/Label.tsx

@@ -0,0 +1,50 @@
+import type { HoverModal } from "./modal";
+import React from "react";
+import { QuestionCircleOutlined } from "@ant-design/icons";
+import { Tooltip } from "antd";
+import { useClassName } from "../hooks";
+
+interface IProps {
+  labelWidth?: number;
+  hover?: string | HoverModal;
+  colon?: boolean;
+  required?: boolean;
+}
+const useHover = ({ hover }: IProps) => {
+  if (!hover || typeof hover === "string") {
+    return {
+      text: hover,
+      icon: <QuestionCircleOutlined />,
+    };
+  }
+  return hover;
+};
+const Index: React.FC<IProps> = ({
+  labelWidth,
+  children,
+  colon,
+  required,
+  hover,
+}) => {
+  const { text, icon } = useHover({ hover });
+  const array = [
+    colon ? "hw-form-item-colon" : "",
+    required ? "hw-form-item-required" : "",
+  ];
+
+  const className = useClassName(array);
+  return (
+    <div style={{ width: labelWidth }} className={className}>
+      {children}
+      {text && (
+        <span style={{ marginLeft: 4 }}>
+          <Tooltip placement="top" title={text}>
+            {icon}
+          </Tooltip>
+        </span>
+      )}
+    </div>
+  );
+};
+
+export default Index;

package/src/components/Form/config.ts

@@ -0,0 +1,43 @@
+import HSelect from "../Select";
+import HInput from "../Input";
+import HInputNumber from "../Input/InputNumber";
+import HSelectInput from "../Input/SelectInput";
+import HButtonInput from "../Input/ButtonInput";
+import HCheckboxGroup from "../CheckboxGroup";
+import HCheckBox from "../CheckboxGroup/CheckBox";
+import HRadioGroup from "../RadioGroup";
+import HSwitch from "../Switch";
+import HDatePicker from "../TDPicker";
+import HRangePicker from "../TDPicker/RangePicker";
+import HTimePicker from "../TDPicker/TimePicker";
+import HUpload from "../Upload";
+import HUrlUpload from "../Upload/UrlUpload";
+import HSubmit from "../Submit";
+import TextArea from "../TextArea";
+import ColorInput from "../Input/ColorInput";
+
+export const placeholderConfig = {
+  inputType: ["input", "inputNumber", "selectInput", "buttonInput"],
+  selectType: ["select", "datePicker", "timePicker", "colorInput"],
+};
+const componentConfig = {
+  select: HSelect,
+  inputNumber: HInputNumber,
+  selectInput: HSelectInput,
+  buttonInput: HButtonInput,
+  checkboxGroup: HCheckboxGroup,
+  checkBox: HCheckBox,
+  radioGroup: HRadioGroup,
+  switch: HSwitch,
+  datePicker: HDatePicker,
+  rangePicker: HRangePicker,
+  timePicker: HTimePicker,
+  input: HInput,
+  upload: HUpload,
+  urlUpload: HUrlUpload,
+  submit: HSubmit,
+  textArea: TextArea,
+  colorInput: ColorInput,
+};
+
+export default componentConfig;

package/src/components/Form/hooks/index.ts

@@ -0,0 +1,115 @@
+import { useRequest } from "ahooks";
+import type { HFormProps, HFormInstance } from "../modal";
+import useHForm from "./useHForm";
+import { useEffect, useMemo } from "react";
+import FormConfig from "../config";
+import { useFormConfigContext } from "../Context/FormConfigProvider";
+import type { DispatchModal } from "../modal";
+
+interface UseValuesChangeModal {
+  onValuesChange: HFormProps["onValuesChange"];
+  dispatch: DispatchModal;
+  form: HFormInstance;
+}
+
+export const useCurrentForm = (form?: HFormInstance) => {
+  const selfForm = useHForm();
+  return form || selfForm;
+};
+type ParamsModal = Omit<HFormProps, "configData">;
+
+export const useInfoReq = ({
+  initialValues,
+  infoRequest,
+  form,
+  params,
+  request,
+  onFinish,
+}: ParamsModal) => {
+  const reqData = useMemo(() => {
+    const saveParams = params || {};
+    return {
+      params: saveParams,
+    };
+  }, [params]);
+
+  const subControl = useRequest(
+    async (value) => {
+      const subVal = form?.outputValues(value);
+      if (request) {
+        await request(subVal, reqData.params);
+      }
+      onFinish?.(subVal, reqData.params);
+    },
+    { manual: true }
+  );
+  const infoControl = useRequest(async (reqParams = reqData.params) => {
+    let setValue = initialValues;
+    reqData.params = reqParams;
+    if (!initialValues && !infoRequest) {
+      return {};
+    }
+    if (infoRequest) {
+      setValue = await infoRequest(reqParams);
+    }
+    form?.setFieldsValue(setValue);
+    return setValue || {};
+  });
+  const { run, mutate } = infoControl;
+  useEffect(() => {
+    if (form) {
+      form.reload = (reloadParams) => {
+        mutate(undefined);
+        return run(reloadParams);
+      };
+    }
+  }, []);
+  return {
+    subControl,
+    infoControl,
+  };
+};
+
+export const useDefaultComponents = () => {
+  const defaultComponent = useFormConfigContext("defaultComponent");
+  return { ...FormConfig, ...defaultComponent };
+};
+
+const dispatchControl = (
+  form: HFormInstance,
+  params,
+  dispatch?: Record<string, DispatchModal>
+) => {
+  if (!dispatch) {
+    return;
+  }
+  const dispatchKey = Object.keys(dispatch);
+  dispatchKey.forEach((name) => {
+    const { fnKey, reset } = dispatch[name];
+    if (reset) {
+      form.setFields([{ name, value: null, errors: [] }]);
+    }
+    if (!fnKey) {
+      return;
+    }
+    form.dispatch(
+      {
+        key: fnKey,
+        name,
+      },
+      params
+    );
+  });
+}; //触发
+export const useValuesChange = ({
+  onValuesChange,
+  dispatch,
+  form,
+}: UseValuesChangeModal) => {
+  return (changedValues: any, values: any) => {
+    const changeKey = Object.keys(changedValues)[0];
+    const dispatchItem = dispatch[changeKey];
+    dispatchControl(form, { changedValues, oldValues: values }, dispatchItem);
+    onValuesChange?.(changedValues, values);
+  };
+};

package/src/components/Form/hooks/useDefaultRender.tsx

@@ -0,0 +1,42 @@
+import type {
+  DefaultComponentModal,
+  HFormItemProps,
+  ConfigComponentModal,
+} from "../modal";
+import FormConfig from "../config";
+import type { FormInstance } from "antd";
+import React from "react";
+
+export const useDefaultRender = (
+  props: HFormItemProps,
+  defaultComponents: DefaultComponentModal
+) => {
+  const {
+    render,
+    labelWidth,
+    colon,
+    type = "input",
+    itemProps = {},
+    ...componentProps
+  } = props;
+  const mergeComponent = { ...FormConfig, ...defaultComponents };
+  const dom = mergeComponent[type];
+  return (form: FormInstance) => {
+    let Component = dom;
+    if ((dom as ConfigComponentModal)?.Component) {
+      Component = (dom as ConfigComponentModal).Component;
+    }
+    const node = Component && (
+      <Component {...componentProps} {...itemProps} form={form} />
+    );
+    if (render) {
+      const resultNode = render(props, node, form);
+      return React.cloneElement<any>(resultNode as any, {
+        ...componentProps,
+        ...itemProps,
+        form,
+      });
+    }
+    return node;
+  };
+};

package/src/components/Form/hooks/useHForm.ts

@@ -0,0 +1,164 @@
+import { useMemo } from "react";
+import { Form } from "antd";
+import type { FormatItemModal, HFormInstance } from "../modal";
+import type { argsFn } from "../modal";
+
+interface DispatchItemData {
+  keysFn: Record<string, argsFn>;
+  defaultFn: argsFn[];
+}
+
+export default () => {
+  const [form] = Form.useForm();
+  return useMemo<HFormInstance>(() => {
+    const formatSourceData: Record<string, FormatItemModal> = {};
+    let dispatchSourceData: Record<string, DispatchItemData> = {};
+    const initDispatch: Record<string, argsFn> = {};
+    let cacheValues: Record<string, any> = {};
+    let isLoading = false;
+
+    const norAddItemDispatch = (name, manual, fn) => {
+      if (manual === false && name) {
+        initDispatch[name] = fn;
+      }
+      if (!name) {
+        return {
+          keysFn: {},
+          defaultFn: [fn],
+        };
+      }
+      return {
+        keysFn: {
+          [name]: fn,
+        },
+        defaultFn: [],
+      };
+    };
+    return {
+      reload: (params) => {
+        return Promise.resolve(params);
+      },
+      initValues() {
+        let newValue = {};
+        if (cacheValues) {
+          newValue = this.formatValues(cacheValues);
+          form.setFieldsValue(newValue);
+        }
+        const initKeys = Object.keys(initDispatch);
+        initKeys.forEach((key) => {
+          initDispatch[key]({ changedValues: newValue, oldValues: newValue });
+        });
+        isLoading = true;
+      },
+      addFormat(name: string, format?: FormatItemModal) {
+        if (!format) {
+          return;
+        }
+        const { inputValue, outputValue } = format;
+        formatSourceData[name] = {
+          inputValue,
+          outputValue,
+        };
+      }, //注册转化方法
+      formatValues(value = {}, formatKey = "inputValue") {
+        const valKeys = Object.keys(value).length;
+        if (!valKeys) {
+          return {};
+        }
+        let newValue = { ...value };
+        const keys = Object.keys(formatSourceData);
+        keys.forEach((key) => {
+          const format = formatSourceData[key]?.[formatKey];
+          if (!format) {
+            return;
+          }
+          const resultValue = format(value);
+          Reflect.deleteProperty(newValue, key);
+          newValue = {
+            ...newValue,
+            ...resultValue,
+          };
+        });
+        return newValue;
+      }, //转化方法
+      dispatch(action, ...args) {
+        const { key, name } = action;
+        const items = dispatchSourceData[key];
+        if (!items) {
+          return;
+        }
+        const { keysFn, defaultFn } = items;
+        if (name) {
+          return keysFn[name]?.(...args);
+        }
+        const fnArrays = Object.keys(keysFn).map((itemKey) => {
+          return keysFn[itemKey];
+        }); //不存在name就合并
+        [...fnArrays, ...defaultFn].forEach((fn) => {
+          fn(...args);
+        });
+      },
+      addDispatchListener(action, fn) {
+        const { key, name, dispatch = {} } = action;
+        const { manual } = dispatch;
+        const items = dispatchSourceData[key];
+        if (!items) {
+          dispatchSourceData[key] = norAddItemDispatch(name, manual, fn);
+          return;
+        }
+        const { keysFn, defaultFn } = items;
+        if (name) {
+          keysFn[name] = fn;
+        } else {
+          defaultFn.push(fn);
+        }
+        if (manual === false && name) {
+          initDispatch[name] = fn;
+        }
+        dispatchSourceData[key] = {
+          keysFn,
+          defaultFn,
+        };
+      },
+      removeDispatchListener(action) {
+        if (!action) {
+          dispatchSourceData = {};
+          return;
+        }
+        const { key, name } = action;
+        const items = dispatchSourceData[key];
+        if (!items) {
+          return;
+        }
+        if (name) {
+          const { keysFn } = items;
+          Reflect.deleteProperty(keysFn, name);
+          items.keysFn = keysFn;
+          dispatchSourceData[key] = items;
+          return;
+        }
+        Reflect.deleteProperty(dispatchSourceData, key);
+      },
+      outputValues(value) {
+        return this.formatValues(value, "outputValue");
+      },
+      ...form,
+      setFieldsValue(values) {
+        if (!isLoading) {
+          cacheValues = values;
+          return;
+        }
+        const newValue = this.formatValues(values);
+        form.setFieldsValue(newValue);
+      },
+      validateFields(nameList) {
+        return new Promise((resolve) => {
+          form.validateFields(nameList).then((value) => {
+            const result = this.formatValues(value, "outputValue");
+            return resolve(result);
+          });
+        });
+      },
+    };
+  }, []);
+};