@hi-ui/form 4.0.0-alpha.1

package/lib/esm/use-form.js

@@ -0,0 +1,519 @@
+/** @LICENSE
+ * @hi-ui/form
+ * https://github.com/XiaoMi/hiui/tree/master/packages/ui/form#readme
+ *
+ * Copyright (c) HIUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import _regeneratorRuntime from '@babel/runtime/regenerator';
+import { __rest, __awaiter } from 'tslib';
+import React, { useMemo, useReducer, useCallback, useRef } from 'react';
+import { useLatestRef, useLatestCallback } from '@hi-ui/use-latest';
+import { isArray, isFunction } from '@hi-ui/type-assertion';
+import { getNested, callAllFuncs, setNested } from '@hi-ui/func-utils';
+import { stopEvent } from '@hi-ui/dom-utils';
+var EMPTY_RULES = {};
+var EMPTY_ERRORS = {};
+var EMPTY_TOUCHED = {};
+var DEFAULT_VALIDATE_TRIGGER = ['onChange', 'onBlur'];
+
+var useForm = function useForm(_a) {
+  var initialValues = _a.initialValues,
+      _a$initialErrors = _a.initialErrors,
+      initialErrors = _a$initialErrors === void 0 ? EMPTY_ERRORS : _a$initialErrors,
+      _a$initialTouched = _a.initialTouched,
+      initialTouched = _a$initialTouched === void 0 ? EMPTY_TOUCHED : _a$initialTouched,
+      onValuesChange = _a.onValuesChange,
+      onReset = _a.onReset,
+      onSubmit = _a.onSubmit,
+      _a$rules = _a.rules,
+      rules = _a$rules === void 0 ? EMPTY_RULES : _a$rules,
+      _a$validateAfterTouch = _a.validateAfterTouched,
+      validateAfterTouched = _a$validateAfterTouch === void 0 ? true : _a$validateAfterTouch,
+      _a$validateTrigger = _a.validateTrigger,
+      validateTriggerProp = _a$validateTrigger === void 0 ? DEFAULT_VALIDATE_TRIGGER : _a$validateTrigger,
+      rest = __rest(_a, ["initialValues", "initialErrors", "initialTouched", "lazyValidate", "onValuesChange", "onReset", "onSubmit", "rules", "validateAfterTouched", "validateTrigger"]);
+  /**
+   * 处理校验触发器，保证 memo 依赖的是数组每个项，避免无效重渲染
+   */
+
+
+  var validateTrigger = isArray(validateTriggerProp) ? validateTriggerProp : [validateTriggerProp]; // eslint-disable-next-line react-hooks/exhaustive-deps
+
+  var validateTriggersMemo = useMemo(function () {
+    return validateTrigger;
+  }, validateTrigger);
+  /**
+   * 收集 Field 的校验器注册表
+   */
+
+  var _useCollection = useCollection(),
+      getValidation = _useCollection[0],
+      registerField = _useCollection[1],
+      unregisterField = _useCollection[2];
+  /**
+   * form 数据管理中心
+   */
+
+
+  var _useReducer = useReducer(formReducer, {
+    values: initialValues,
+    errors: initialErrors,
+    touched: initialTouched,
+    validating: false,
+    submitting: false
+  }),
+      formState = _useReducer[0],
+      formDispatch = _useReducer[1]; // 使用 latest ref 维护，保证每次主动拿取的 formState 都是最新的
+
+
+  var formStateRef = useLatestRef(formState); // @ts-ignore
+
+  var getFieldNames = useCallback(function () {
+    return Object.keys(formStateRef.current.values);
+  }, [formStateRef]); // @ts-ignore
+
+  var getFieldValue = useCallback(function (fieldName) {
+    return formStateRef.current.values[fieldName];
+  }, [formStateRef]);
+  var getFieldError = useCallback(function (fieldName) {
+    return formStateRef.current.errors[fieldName];
+  }, [formStateRef]);
+  var setFieldError = useCallback(function (field, errorMessage) {
+    formDispatch({
+      type: 'SET_FIELD_ERROR',
+      // @ts-ignore
+      payload: {
+        field: field,
+        value: errorMessage
+      }
+    });
+  }, []);
+  var setFieldTouched = useCallback(function (field, touched) {
+    if (touched === void 0) {
+      touched = false;
+    }
+
+    formDispatch({
+      type: 'SET_FIELD_TOUCHED',
+      // @ts-ignore
+      payload: {
+        field: field,
+        value: touched
+      }
+    });
+  }, []);
+  /**
+   * 使用单个 Field 规则对给定值进行校验
+   */
+
+  var validateField = useCallback(function (field, value) {
+    return __awaiter(void 0, void 0, void 0, /*#__PURE__*/_regeneratorRuntime.mark(function _callee() {
+      var fieldValidation, errorResultAsPromise;
+      return _regeneratorRuntime.wrap(function _callee$(_context) {
+        while (1) {
+          switch (_context.prev = _context.next) {
+            case 0:
+              fieldValidation = getValidation(field);
+
+              if (fieldValidation) {
+                _context.next = 3;
+                break;
+              }
+
+              return _context.abrupt("return");
+
+            case 3:
+              formDispatch({
+                type: 'SET_VALIDATING',
+                payload: true
+              });
+              errorResultAsPromise = fieldValidation.validate(value);
+              console.log('validate', errorResultAsPromise);
+              errorResultAsPromise.then(function (result) {
+                console.log('result', result);
+                formDispatch({
+                  type: 'SET_VALIDATING',
+                  payload: false
+                });
+                setFieldError(field, '');
+              })["catch"](function (errorMsg) {
+                // @ts-ignore
+                setFieldError(field, errorMsg.fields[field][0].message);
+              })["finally"](function () {
+                formDispatch({
+                  type: 'SET_VALIDATING',
+                  payload: false
+                });
+              });
+
+            case 7:
+            case "end":
+              return _context.stop();
+          }
+        }
+      }, _callee);
+    }));
+  }, [getValidation, setFieldError]);
+  /**
+   * 校验单个 Field 及其当前值
+   */
+
+  var validateFieldState = useCallback(function (field) {
+    var value = getFieldValue(field);
+    return validateField(field, value);
+  }, [validateField, getFieldValue]);
+  /**
+   * 检验所有字段
+   */
+
+  var validateAll = useCallback(function () {
+    var fieldNames = getFieldNames();
+    return Promise.all(fieldNames.map(function (fieldName) {
+      return validateFieldState(fieldName);
+    }));
+  }, [getFieldNames, validateFieldState]);
+  /**
+   * 控件值更新策略
+   */
+
+  var setFieldValue = useCallback(function (field, value, shouldValidate) {
+    // @ts-ignore
+    formDispatch({
+      type: 'SET_FIELD_VALUE',
+      payload: {
+        field: field,
+        value: value
+      }
+    });
+    var shouldValidateField = shouldValidate !== null && shouldValidate !== void 0 ? shouldValidate : validateAfterTouched ? formState.touched[field] : true;
+
+    if (shouldValidateField) {
+      validateField(field, value);
+    }
+  }, [validateField, validateAfterTouched, formState]);
+  var normalizeValueFromChange = useCallback(function (eventOrValue) {
+    // TODO: handle correct value
+    return eventOrValue.target.value;
+  }, []);
+  var handleFieldChange = useCallback(function (fieldName, valueCollectPipe, shouldValidate) {
+    return function (evt) {
+      var _Object$assign; // TODO: 传递 onChange 其它参数
+
+
+      var nextValue = isFunction(valueCollectPipe) ? valueCollectPipe(evt) : normalizeValueFromChange(evt);
+      setFieldValue(fieldName, nextValue, shouldValidate); // @ts-ignore
+
+      onValuesChange === null || onValuesChange === void 0 ? void 0 : onValuesChange(Object.assign(Object.assign({}, formState.values), (_Object$assign = {}, _Object$assign[fieldName] = nextValue, _Object$assign)), formState.values);
+    };
+  }, [setFieldValue, onValuesChange, formState.values, normalizeValueFromChange]);
+  /**
+   * 控件失焦策略
+   */
+
+  var handleFieldBlur = useCallback(function (fieldName, shouldValidate) {
+    return function (evt) {
+      if (shouldValidate) {
+        validateFieldState(fieldName);
+      }
+
+      setFieldTouched(fieldName, true);
+    };
+  }, [setFieldTouched, validateFieldState]);
+  var handleFieldTrigger = useCallback(function (fieldName) {
+    return function (evt) {
+      validateFieldState(fieldName);
+    };
+  }, [validateFieldState]);
+  /**
+   * 表单重置，永远使用第一次的初始值
+   */
+
+  var initialValuesRef = useRef(initialValues);
+  var initialErrorsRef = useRef(initialErrors);
+  var initialTouchedRef = useRef(initialTouched);
+  var onResetLatestRef = useLatestRef(onReset);
+  var resetForm = useCallback(function (nextState) {
+    return __awaiter(void 0, void 0, void 0, /*#__PURE__*/_regeneratorRuntime.mark(function _callee2() {
+      var values, errors, touched, submitting, validating, dispatchFn;
+      return _regeneratorRuntime.wrap(function _callee2$(_context2) {
+        while (1) {
+          switch (_context2.prev = _context2.next) {
+            case 0:
+              values = nextState && nextState.values ? nextState.values : initialValuesRef.current;
+              errors = nextState && nextState.errors ? nextState.errors : initialErrorsRef.current;
+              touched = nextState && nextState.touched ? nextState.touched : initialTouchedRef.current;
+              initialValuesRef.current = values; // @ts-ignore
+
+              initialErrorsRef.current = errors;
+              initialTouchedRef.current = touched;
+              submitting = !!(nextState && nextState.submitting);
+              validating = !!(nextState && nextState.validating);
+
+              dispatchFn = function dispatchFn() {
+                formDispatch({
+                  type: 'SET_FORM',
+                  payload: {
+                    submitting: submitting,
+                    validating: validating,
+                    errors: errors,
+                    touched: touched,
+                    values: values
+                  }
+                });
+              };
+
+              if (!onResetLatestRef.current) {
+                _context2.next = 15;
+                break;
+              }
+
+              _context2.next = 12;
+              return onResetLatestRef.current(formState.values);
+
+            case 12:
+              dispatchFn();
+              _context2.next = 16;
+              break;
+
+            case 15:
+              dispatchFn();
+
+            case 16:
+            case "end":
+              return _context2.stop();
+          }
+        }
+      }, _callee2);
+    }));
+  }, [onResetLatestRef, formState.values]);
+  /**
+   * 表单提交
+   */
+
+  var submitForm = useCallback(function () {
+    return __awaiter(void 0, void 0, void 0, /*#__PURE__*/_regeneratorRuntime.mark(function _callee3() {
+      return _regeneratorRuntime.wrap(function _callee3$(_context3) {
+        while (1) {
+          switch (_context3.prev = _context3.next) {
+            case 0:
+              formDispatch({
+                type: 'SUBMIT_ATTEMPT'
+              });
+              return _context3.abrupt("return", validateAll().then(function (combinedErrors) {
+                var isInstanceOfError = combinedErrors instanceof Error;
+                var isActuallyValid = !isInstanceOfError && Object.keys(combinedErrors).length === 0;
+
+                if (isActuallyValid) {
+                  var promiseOrUndefined;
+
+                  try {
+                    // @ts-ignore
+                    promiseOrUndefined = onSubmit === null || onSubmit === void 0 ? void 0 : onSubmit(formState.values);
+                  } catch (error) {// throw error
+                  }
+
+                  if (promiseOrUndefined === undefined) return;
+                  return Promise.resolve(promiseOrUndefined).then(function (result) {
+                    formDispatch({
+                      type: 'SUBMIT_DONE'
+                    });
+                    return result;
+                  })["catch"](function (_errors) {
+                    formDispatch({
+                      type: 'SUBMIT_DONE'
+                    });
+                    throw _errors;
+                  });
+                } else {
+                  formDispatch({
+                    type: 'SUBMIT_DONE'
+                  });
+
+                  if (isInstanceOfError) {
+                    throw combinedErrors;
+                  }
+                }
+              }));
+
+            case 2:
+            case "end":
+              return _context3.stop();
+          }
+        }
+      }, _callee3);
+    }));
+  }, [formState, onSubmit, validateAll]);
+  var handleSubmit = useCallback(function (evt) {
+    stopEvent(evt);
+    submitForm()["catch"](console.error);
+  }, [submitForm]);
+  var handleReset = useCallback(function (evt) {
+    stopEvent(evt);
+    resetForm();
+  }, [resetForm]);
+  useCallback(function () {}, []);
+  useCallback(function () {
+    formDispatch({
+      // TODO: reset errorMsg
+      type: 'SET_ERRORS',
+      payload: {}
+    });
+  }, []);
+  var setFormState = React.useCallback(function (stateOrFunc) {
+    // @ts-ignore
+    formDispatch({
+      type: 'SET_STATE',
+      payload: stateOrFunc
+    });
+  }, []);
+  var getRootProps = useLatestCallback(function () {
+    return Object.assign(Object.assign({}, rest), {
+      onSubmit: handleSubmit,
+      onReset: handleReset
+    });
+  });
+  var getFieldProps = useCallback(function (props, ref) {
+    var _returnProps;
+
+    if (props === void 0) {
+      props = {};
+    }
+
+    if (ref === void 0) {
+      ref = null;
+    }
+
+    var _props = props,
+        field = _props.field,
+        _props$valuePropName = _props.valuePropName,
+        valuePropName = _props$valuePropName === void 0 ? 'value' : _props$valuePropName,
+        _props$valueCollectPr = _props.valueCollectPropName,
+        valueCollectPropName = _props$valueCollectPr === void 0 ? 'onChange' : _props$valueCollectPr,
+        valueCollectPipe = _props.valueCollectPipe,
+        _props$validateTrigge = _props.validateTrigger,
+        validateTriggerProp = _props$validateTrigge === void 0 ? validateTriggersMemo : _props$validateTrigge,
+        onBlur = _props.onBlur;
+    var validateTrigger = isArray(validateTriggerProp) ? validateTriggerProp : [validateTriggerProp];
+    var validateOnCollect = validateTrigger.includes(valueCollectPropName);
+    var validateOnBlur = validateTrigger.includes('onChange');
+    var returnProps = (_returnProps = {
+      ref: ref
+    }, _returnProps[valuePropName] = getNested(formState.values, field), _returnProps[valueCollectPropName] = callAllFuncs(props[valueCollectPropName], handleFieldChange(field, valueCollectPipe, validateOnCollect)), _returnProps.onBlur = callAllFuncs(onBlur, handleFieldBlur(field, validateOnBlur)), _returnProps.invalid = getFieldError(field), _returnProps);
+    validateTrigger.filter(function (triggerName) {
+      return [valueCollectPropName, 'onBlur'].indexOf(triggerName) === -1;
+    }) // @ts-ignore
+    .forEach(function (triggerName) {
+      // @ts-ignore
+      returnProps[triggerName] = callAllFuncs(props[triggerName], handleFieldTrigger(field));
+    });
+    return returnProps;
+  }, [formState, handleFieldChange, handleFieldBlur, validateTriggersMemo, handleFieldTrigger, getFieldError]);
+  var getFieldRules = useCallback(function (fieldName) {
+    return rules[fieldName];
+  }, [rules]);
+  return Object.assign(Object.assign({}, formState), {
+    setFormState: setFormState,
+    setFieldValue: setFieldValue,
+    setFieldError: setFieldError,
+    setFieldTouched: setFieldTouched,
+    getFieldError: getFieldError,
+    getFieldRules: getFieldRules,
+    getRootProps: getRootProps,
+    getFieldProps: getFieldProps,
+    registerField: registerField,
+    unregisterField: unregisterField,
+    submitForm: submitForm,
+    resetForm: resetForm
+  });
+}; // TODO: field 支持数组
+
+
+function formReducer(state, action) {
+  switch (action.type) {
+    case 'SET_STATE':
+      var nextState = isFunction(action.payload) ? action.payload(state) : action.payload;
+      return Object.assign(Object.assign({}, state), nextState);
+
+    case 'SET_VALUES':
+      return Object.assign(Object.assign({}, state), {
+        values: action.payload
+      });
+
+    case 'SET_ERRORS':
+      return Object.assign(Object.assign({}, state), {
+        errors: action.payload
+      });
+
+    case 'SET_TOUCHED':
+      return Object.assign(Object.assign({}, state), {
+        touched: action.payload
+      });
+
+    case 'SET_SUBMITTING':
+      return Object.assign(Object.assign({}, state), {
+        submitting: action.payload
+      });
+
+    case 'SET_VALIDATING':
+      return Object.assign(Object.assign({}, state), {
+        validating: action.payload
+      });
+
+    case 'SET_FIELD_VALUE':
+      return Object.assign(Object.assign({}, state), {
+        values: setNested(state.values, action.payload.field, action.payload.value)
+      });
+
+    case 'SET_FIELD_TOUCHED':
+      return Object.assign(Object.assign({}, state), {
+        touched: setNested(state.touched, action.payload.field, action.payload.value)
+      });
+
+    case 'SET_FIELD_ERROR':
+      return Object.assign(Object.assign({}, state), {
+        errors: setNested(state.errors, action.payload.field, action.payload.value)
+      });
+
+    case 'SET_FORM':
+      return Object.assign(Object.assign({}, state), action.payload);
+
+    case 'SUBMIT_DONE':
+      return Object.assign(Object.assign({}, state), {
+        submitting: false
+      });
+
+    default:
+      return state;
+  }
+}
+/**
+ * 一个注册表的收集器
+ */
+
+
+var useCollection = function useCollection() {
+  var collectionMp = useMemo(function () {
+    return new Map();
+  }, []);
+  var collectionRef = useRef(collectionMp);
+  var register = useCallback(function (key, value) {
+    collectionRef.current.set(key, value);
+  }, []);
+  var unregister = useCallback(function (key) {
+    collectionRef.current["delete"](key);
+  }, []);
+  var getCollection = useCallback(function (key) {
+    if (collectionRef.current.has(key)) {
+      return collectionRef.current.get(key);
+    }
+
+    return null;
+  }, []);
+  return [getCollection, register, unregister];
+};
+
+export { useForm };
+//# sourceMappingURL=use-form.js.map

package/lib/esm/use-form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-form.js","sources":["../../src/use-form.ts"],"sourcesContent":[null],"names":["EMPTY_RULES","EMPTY_ERRORS","EMPTY_TOUCHED","DEFAULT_VALIDATE_TRIGGER","useForm","_a","initialValues","initialErrors","initialTouched","onValuesChange","onReset","onSubmit","rules","validateAfterTouched","validateTrigger","validateTriggerProp","rest","isArray","validateTriggersMemo","useMemo","useCollection","getValidation","registerField","unregisterField","useReducer","formReducer","values","errors","touched","validating","submitting","formState","formDispatch","formStateRef","useLatestRef","getFieldNames","useCallback","Object","keys","current","getFieldValue","fieldName","getFieldError","setFieldError","field","errorMessage","type","payload","value","setFieldTouched","validateField","fieldValidation","errorResultAsPromise","validate","console","log","then","result","errorMsg","fields","message","validateFieldState","validateAll","fieldNames","Promise","all","map","setFieldValue","shouldValidate","shouldValidateField","normalizeValueFromChange","eventOrValue","target","handleFieldChange","valueCollectPipe","evt","nextValue","isFunction","handleFieldBlur","handleFieldTrigger","initialValuesRef","useRef","initialErrorsRef","initialTouchedRef","onResetLatestRef","resetForm","nextState","dispatchFn","submitForm","combinedErrors","isInstanceOfError","Error","isActuallyValid","length","promiseOrUndefined","error","undefined","resolve","_errors","handleSubmit","stopEvent","handleReset","setFormState","React","stateOrFunc","getRootProps","useLatestCallback","getFieldProps","props","ref","valuePropName","valueCollectPropName","onBlur","validateOnCollect","includes","validateOnBlur","returnProps","getNested","callAllFuncs","invalid","filter","triggerName","indexOf","forEach","getFieldRules","state","action","setNested","collectionMp","Map","collectionRef","register","key","set","unregister","getCollection","has","get"],"mappings":"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"}

package/lib/types/Form.d.ts

@@ -0,0 +1,35 @@
+import React from 'react';
+import { UseFormProps } from './use-form';
+import { HiBaseHTMLProps } from '@hi-ui/core';
+import { FormRuleModel, FormHelpers } from './types';
+export declare const FORM_REGISTER_TABLE: Record<string, FormRuleModel>;
+/**
+ * TODO: What is Form
+ */
+export declare const Form: React.ForwardRefExoticComponent<FormProps<Record<string, any>> & React.RefAttributes<HTMLFormElement | null>>;
+export interface FormProps<Values = Record<string, any>> extends Omit<HiBaseHTMLProps<'form'>, 'onSubmit' | 'onReset'>, UseFormProps<Values> {
+    /**
+     * 提供辅助方法的内部引用
+     */
+    innerRef?: React.RefObject<FormHelpers<Values>>;
+    /**
+     * label 宽度，可用任意 CSS 长度单位
+     */
+    labelWidth?: React.ReactText;
+    /**
+     * label 对齐的方式
+     */
+    labelPlacement?: 'left' | 'right' | 'top';
+    /**
+     * label 和表单控件的放置方式
+     */
+    placement?: 'vertical' | 'horizontal';
+    /**
+     * 在 vertical 放置时，label 相对表单控件垂直对齐的方式
+     */
+    verticalAlign?: 'top' | 'center' | 'bottom';
+    /**
+     * 配置是否展示冒号
+     */
+    colon?: boolean;
+}

package/lib/types/FormField.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import { UseFormFieldProps } from './use-form-field';
+/**
+ * TODO: What is FormField
+ */
+export declare const FormField: React.FC<FormFieldProps>;
+export interface FormFieldProps extends UseFormFieldProps {
+    /**
+     * 表单控件
+     */
+    children?: React.ReactElement;
+}

package/lib/types/FormItem.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import { UseFormFieldProps } from './use-form-field';
+import { FormLabelProps } from './FormLabel';
+/**
+ * TODO: What is FormItem
+ */
+export declare const FormItem: React.FC<FormItemProps>;
+export interface FormItemProps extends UseFormFieldProps, FormLabelProps {
+    /**
+     * 表单控件
+     */
+    children?: React.ReactElement;
+}

package/lib/types/FormLabel.d.ts

@@ -0,0 +1,28 @@
+import React from 'react';
+import { HiBaseHTMLProps } from '@hi-ui/core';
+/**
+ * TODO: What is FormLabel
+ */
+export declare const FormLabel: React.ForwardRefExoticComponent<FormLabelProps & React.RefAttributes<HTMLDivElement | null>>;
+export interface FormLabelProps extends HiBaseHTMLProps<'div'> {
+    /**
+     * label 放置的位置
+     */
+    labelPlacement?: 'right' | 'left' | 'top';
+    /**
+     * 标记是否必填
+     */
+    required?: boolean;
+    /**
+     * 是否显示冒号
+     */
+    colon?: boolean;
+    /**
+     * label 宽度，可使用任意 CSS 长度单位。优先级高于 Form 设置的 labelWidth
+     */
+    labelWidth?: React.ReactText;
+    /**
+     * label 文案
+     */
+    label?: React.ReactNode;
+}

package/lib/types/FormList.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+/**
+ * TODO: What is FormList
+ */
+export declare const FormList: React.FC<FormListProps>;
+export interface FormListProps {
+    /**
+     * 表单控件
+     */
+    children?: (fields: any[], action: any) => React.ReactElement | null;
+    /**
+     * 列表名称
+     */
+    name: string | string[];
+}

package/lib/types/FormMessage.d.ts

@@ -0,0 +1,27 @@
+import React from 'react';
+/**
+ * TODO: What is FormMessage
+ */
+export declare const FormMessage: React.ForwardRefExoticComponent<FormMessageProps & React.RefAttributes<HTMLSpanElement | null>>;
+export interface FormMessageProps {
+    /**
+     * 组件默认的选择器类
+     */
+    prefixCls?: string;
+    /**
+     * 组件的语义化 Role 属性
+     */
+    role?: string;
+    /**
+     * 组件的注入选择器类
+     */
+    className?: string;
+    /**
+     * 组件的注入样式
+     */
+    style?: React.CSSProperties;
+    /**
+     * 	字段名
+     */
+    field?: string;
+}