baseForm.tsx 10.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292
  1. /* eslint-disable prefer-template, max-len, @typescript-eslint/no-unused-vars */
  2. import React from 'react';
  3. import classNames from 'classnames';
  4. import PropTypes from 'prop-types';
  5. import FormFoundation, { BaseFormAdapter } from '@douyinfe/semi-foundation/form/foundation';
  6. import { strings, cssClasses } from '@douyinfe/semi-foundation/form/constants';
  7. import { getUuidv4 } from '@douyinfe/semi-foundation/utils/uuid';
  8. import warning from '@douyinfe/semi-foundation/utils/warning';
  9. import BaseComponent from '../_base/baseComponent';
  10. import { FormStateContext, FormApiContext, FormUpdaterContext } from './context';
  11. import { isEmptyChildren } from '../_base/reactUtils';
  12. import Row from '../grid/row';
  13. import { cloneDeep } from '../_utils/index';
  14. import Slot from './slot';
  15. import Section from './section';
  16. import Label from './label';
  17. import ErrorMessage from './errorMessage';
  18. import FormInputGroup from './group';
  19. import { noop } from 'lodash';
  20. import '@douyinfe/semi-foundation/form/form.scss';
  21. import { FormInput,
  22. FormInputNumber,
  23. FormTextArea,
  24. FormSelect,
  25. FormCheckboxGroup,
  26. FormCheckbox,
  27. FormRadioGroup,
  28. FormRadio,
  29. FormDatePicker,
  30. FormSwitch,
  31. FormSlider,
  32. FormTimePicker,
  33. FormTreeSelect,
  34. FormCascader,
  35. FormRating,
  36. FormAutoComplete,
  37. FormUpload,
  38. FormTagInput } from './field';
  39. import {
  40. BaseFormProps,
  41. FormState,
  42. FormApi,
  43. ErrorMsg
  44. } from './interface';
  45. const prefix = cssClasses.PREFIX;
  46. interface BaseFormState {
  47. formId: string;
  48. }
  49. class Form extends BaseComponent<BaseFormProps, BaseFormState> {
  50. static propTypes = {
  51. 'aria-label': PropTypes.string,
  52. onSubmit: PropTypes.func,
  53. onSubmitFail: PropTypes.func,
  54. /* Triggered from update, including field mount/unmount/value change/blur/verification status change/error prompt change, input parameter is formState, currentField */
  55. onChange: PropTypes.func,
  56. onReset: PropTypes.func,
  57. // Triggered when the value of the form is updated, only when the value of the subfield changes. The entry parameter is formState.values
  58. onValueChange: PropTypes.func,
  59. initValues: PropTypes.object,
  60. getFormApi: PropTypes.func,
  61. component: PropTypes.oneOfType([PropTypes.node, PropTypes.func]),
  62. render: PropTypes.func,
  63. validateFields: PropTypes.func,
  64. style: PropTypes.object,
  65. className: PropTypes.string,
  66. layout: PropTypes.oneOf(strings.LAYOUT),
  67. labelPosition: PropTypes.oneOf(strings.LABEL_POS),
  68. labelWidth: PropTypes.oneOfType([PropTypes.number, PropTypes.string]),
  69. labelAlign: PropTypes.oneOf(strings.LABEL_ALIGN),
  70. labelCol: PropTypes.object, // Control labelCol {span: number, offset: number} for all field child nodes
  71. wrapperCol: PropTypes.object, // Control wrapperCol {span: number, offset: number} for all field child nodes
  72. allowEmpty: PropTypes.bool,
  73. autoScrollToError: PropTypes.oneOfType([PropTypes.bool, PropTypes.object]),
  74. disabled: PropTypes.bool,
  75. showValidateIcon: PropTypes.bool,
  76. extraTextPosition: PropTypes.oneOf(strings.EXTRA_POS),
  77. id: PropTypes.string,
  78. };
  79. static defaultProps = {
  80. onChange: noop,
  81. onSubmitFail: noop,
  82. onSubmit: noop,
  83. onReset: noop,
  84. onValueChange: noop,
  85. layout: 'vertical',
  86. labelPosition: 'top',
  87. allowEmpty: false,
  88. autoScrollToError: false,
  89. showValidateIcon: true,
  90. };
  91. static Input = FormInput;
  92. static TextArea = FormTextArea;
  93. static InputNumber = FormInputNumber;
  94. static Select = FormSelect;
  95. static Checkbox = FormCheckbox;
  96. static CheckboxGroup = FormCheckboxGroup;
  97. static Radio = FormRadio;
  98. static RadioGroup = FormRadioGroup;
  99. static DatePicker = FormDatePicker;
  100. static TimePicker = FormTimePicker;
  101. static Switch = FormSwitch;
  102. static Slider = FormSlider;
  103. static TreeSelect = FormTreeSelect;
  104. static Cascader = FormCascader;
  105. static Rating = FormRating;
  106. static AutoComplete = FormAutoComplete;
  107. static Upload = FormUpload;
  108. static TagInput = FormTagInput;
  109. static Slot = Slot;
  110. static ErrorMessage = ErrorMessage;
  111. static InputGroup = FormInputGroup;
  112. static Label = Label;
  113. static Section = Section;
  114. formApi: FormApi;
  115. constructor(props: BaseFormProps) {
  116. super(props);
  117. this.state = {
  118. formId: getUuidv4(),
  119. };
  120. warning(
  121. Boolean(props.component && props.render),
  122. '[Semi Form] You should not use <Form component> and <Form render> in ths same time; <Form render> will be ignored'
  123. );
  124. warning(
  125. props.component && props.children && !isEmptyChildren(props.children),
  126. '[Semi Form] You should not use <Form component> and <Form>{children}</Form> in ths same time; <Form>{children}</Form> will be ignored'
  127. );
  128. warning(
  129. props.render && props.children && !isEmptyChildren(props.children),
  130. '[Semi Form] You should not use <Form render> and <Form>{children}</Form> in ths same time; <Form>{children}</Form> will be ignored'
  131. );
  132. this.submit = this.submit.bind(this);
  133. this.reset = this.reset.bind(this);
  134. this.foundation = new FormFoundation(this.adapter);
  135. this.formApi = this.foundation.getFormApi();
  136. if (this.props.getFormApi) {
  137. this.props.getFormApi(this.formApi);
  138. }
  139. }
  140. componentWillUnmount() {
  141. this.foundation.destroy();
  142. this.foundation = null;
  143. this.formApi = null;
  144. }
  145. get adapter(): BaseFormAdapter<BaseFormProps, BaseFormState> {
  146. return {
  147. ...super.adapter,
  148. cloneDeep,
  149. notifySubmit: (values: any) => {
  150. this.props.onSubmit(values);
  151. },
  152. notifySubmitFail: (errors: ErrorMsg, values: any) => {
  153. this.props.onSubmitFail(errors, values);
  154. },
  155. forceUpdate: (callback?: () => void) => {
  156. this.forceUpdate(callback);
  157. },
  158. notifyChange: (formState: FormState) => {
  159. this.props.onChange(formState);
  160. },
  161. notifyValueChange: (values: any, changedValues: any) => {
  162. this.props.onValueChange(values, changedValues);
  163. },
  164. notifyReset: () => {
  165. this.props.onReset();
  166. },
  167. getInitValues: () => this.props.initValues,
  168. getFormProps: (keys: undefined | string | Array<string>) => {
  169. if (typeof keys === 'undefined') {
  170. return this.props;
  171. } else if (typeof keys === 'string') {
  172. return this.props[keys];
  173. } else {
  174. const props = {};
  175. keys.forEach(key => {
  176. props[key] = this.props[key];
  177. });
  178. return props;
  179. }
  180. },
  181. getAllErrorDOM: () => {
  182. const { formId } = this.state;
  183. return document.querySelectorAll(
  184. `form[x-form-id="${formId}"] .${cssClasses.PREFIX}-field-error-message`
  185. );
  186. },
  187. getFieldDOM: (field: string) =>
  188. document.querySelector(`.${cssClasses.PREFIX}-field[x-field-id="${field}"]`),
  189. };
  190. }
  191. get content() {
  192. const { children, component, render } = this.props;
  193. const formState = this.foundation.getFormState();
  194. const props = {
  195. formState,
  196. formApi: this.foundation.getFormApi(),
  197. values: formState.values,
  198. };
  199. if (component) {
  200. return React.createElement(component, props, children);
  201. }
  202. if (render) {
  203. return render(props);
  204. }
  205. if (typeof children === 'function') {
  206. return children(props);
  207. }
  208. return children;
  209. }
  210. submit(e: React.FormEvent<HTMLFormElement>) {
  211. e.preventDefault();
  212. this.foundation.submit();
  213. }
  214. reset(e: React.FormEvent<HTMLFormElement>) {
  215. e.preventDefault();
  216. this.foundation.reset();
  217. }
  218. render() {
  219. const needClone = false;
  220. const formState = this.foundation.getFormState(needClone);
  221. const updaterApi = this.foundation.getModifyFormStateApi();
  222. const { formId } = this.state;
  223. const {
  224. children,
  225. getFormApi,
  226. onChange,
  227. onSubmit,
  228. onSubmitFail,
  229. onValueChange,
  230. component,
  231. render,
  232. validateFields,
  233. initValues,
  234. layout,
  235. style,
  236. className,
  237. labelPosition,
  238. labelWidth,
  239. labelAlign,
  240. labelCol,
  241. wrapperCol,
  242. allowEmpty,
  243. autoScrollToError,
  244. showValidateIcon,
  245. extraTextPosition,
  246. ...rest
  247. } = this.props;
  248. const formCls = classNames(prefix, className, {
  249. [prefix + '-vertical']: layout === 'vertical',
  250. [prefix + '-horizontal']: layout === 'horizontal',
  251. });
  252. const showldAppendRow = wrapperCol && labelCol;
  253. const formContent = (
  254. <form
  255. style={style}
  256. {...rest}
  257. onReset={this.reset}
  258. onSubmit={this.submit}
  259. className={formCls}
  260. x-form-id={formId}
  261. >
  262. {this.content}
  263. </form>
  264. );
  265. const withRowForm = <Row>{formContent}</Row>;
  266. return (
  267. <FormUpdaterContext.Provider value={updaterApi}>
  268. <FormApiContext.Provider value={this.formApi}>
  269. <FormStateContext.Provider value={formState}>
  270. {showldAppendRow ? withRowForm : formContent}
  271. </FormStateContext.Provider>
  272. </FormApiContext.Provider>
  273. </FormUpdaterContext.Provider>
  274. );
  275. }
  276. }
  277. export default Form;