@digigov/form 2.0.0-2445d5cb → 2.0.0-264e5fff

package/src/FieldArray/FormDialog/index.tsx

@@ -0,0 +1,302 @@
+import React, {
+  useCallback,
+  useEffect,
+  useMemo,
+  useRef,
+  useState,
+} from 'react';
+import type { ErrorOption, UseFormReturn } from 'react-hook-form';
+import { useFieldArray } from 'react-hook-form';
+import type { FieldProps, FormData } from '@digigov/form/Field/types';
+import { ArrayDisplay } from '@digigov/form/FieldArray/FormDialog/ArrayDisplay';
+import { ArrayEditModal } from '@digigov/form/FieldArray/FormDialog/ArrayEditModal';
+import { useFormContext } from '@digigov/form/FormContext';
+import { useModal } from '@digigov/ui/app/Modal';
+import { Button } from '@digigov/ui/form/Button';
+import { Hint } from '@digigov/ui/typography/Hint';
+
+export interface FormDialogProps extends FieldProps {
+  control: UseFormReturn['control'];
+  trigger: UseFormReturn['trigger'];
+  register: UseFormReturn['register'];
+  clearErrors: UseFormReturn['clearErrors'];
+  formState: UseFormReturn['formState'];
+  error?: ErrorOption;
+  getValues: UseFormReturn['getValues'];
+  setValue: UseFormReturn['setValue'];
+  reset: UseFormReturn['reset'];
+  resetField?: UseFormReturn['resetField'];
+  sortable: boolean;
+  Field: React.FC<FieldProps>;
+}
+
+export const FormDialog = React.forwardRef<HTMLButtonElement, FormDialogProps>(
+  (
+    {
+      name: fieldArrayName,
+      control,
+      error,
+      getValues,
+      Field,
+      sortable,
+      ...customField
+    },
+    ref
+  ) => {
+    const [isAppending, setIsAppending] = useState(false);
+    const [editingIndex, setEditingIndex] = useState(0);
+    const { fields, append, remove, update, move } = useFieldArray({
+      control,
+      name: fieldArrayName,
+    });
+    const { open, close, registerModal } = useModal();
+    const currentLength = fields.length;
+    const arrayItemName = isAppending
+      ? `${fieldArrayName}.${currentLength}`
+      : `${fieldArrayName}.${editingIndex}`;
+
+    useEffect(() => {
+      if (isAppending) {
+        open(`modal-${fieldArrayName}`);
+      }
+    }, [isAppending, fieldArrayName, open]);
+
+    const fieldArrayValues = getValues(fieldArrayName);
+    const ofField = useMemo(
+      () => ({
+        ...customField.extra?.of,
+        name: arrayItemName,
+      }),
+      [arrayItemName, customField.extra?.of]
+    );
+    if (ofField.type !== 'object') {
+      ofField.name = ofField.key ?? fieldArrayName;
+      ofField.key = ofField.key ?? fieldArrayName;
+    }
+
+    const defaultValue = useMemo(() => {
+      // If appending, use default value from field spec
+      if (isAppending) {
+        if (ofField.type === 'object') return ofField.defaultValue;
+        else return { [ofField.name]: ofField.defaultValue };
+      }
+
+      if (ofField.type === 'object') return getValues(ofField.name);
+      else return { [ofField.name]: fieldArrayValues?.[editingIndex] };
+    }, [
+      editingIndex,
+      fieldArrayValues,
+      getValues,
+      isAppending,
+      ofField.defaultValue,
+      ofField.name,
+      ofField.type,
+    ]);
+
+    const hasCommitedValues = fields.length > 0 || !!fieldArrayValues?.length;
+
+    const title = useMemo(() => {
+      if (!customField.extra?.label.object.title) return null;
+
+      let title = customField.extra.label.object.title;
+      if (customField.extra.label.object.titleNumbering)
+        title += ` ${currentLength + 1}`;
+
+      return title;
+    }, [
+      currentLength,
+      customField.extra?.label.object.title,
+      customField.extra?.label.object.titleNumbering,
+    ]);
+
+    const focusReturnRef = useRef<HTMLElement | null>(null);
+
+    /** Handle closing the modal and restoring focus */
+    const closeModal = useCallback(() => {
+      close();
+      // Return focus to the element that was focused before the modal opened
+      if (focusReturnRef.current) {
+        focusReturnRef.current.focus();
+        focusReturnRef.current = null;
+      }
+    }, [close]);
+
+    const { clearErrors, setError } = useFormContext();
+
+    /** Handle modal form submission */
+    const handleEditOrAppend = useCallback(
+      (data: FormData) => {
+        if (isAppending) {
+          setIsAppending(false);
+          if (ofField.type === 'object') append(data);
+          else if (data) {
+            const submittedValue = data[ofField.key ?? fieldArrayName];
+            if (submittedValue) append(submittedValue);
+          }
+        } else {
+          clearErrors(`${fieldArrayName}.${editingIndex}`);
+          if (ofField.type === 'object') update(editingIndex, data);
+          else if (data) {
+            const submittedValue = data[ofField.key ?? fieldArrayName];
+            if (submittedValue) update(editingIndex, submittedValue);
+          }
+        }
+        closeModal();
+      },
+      [
+        clearErrors,
+        append,
+        closeModal,
+        editingIndex,
+        fieldArrayName,
+        isAppending,
+        ofField.key,
+        ofField.type,
+        update,
+      ]
+    );
+
+    /** Handle cancelling the modal operation */
+    const handleCancel = useCallback(() => {
+      if (isAppending) setIsAppending(false);
+      closeModal();
+    }, [closeModal, isAppending]);
+
+    /** Handle opening the modal to edit an existing item */
+    const handleOpenEditModal = useCallback(
+      (index: number) => {
+        // Store the currently focused element to restore focus later
+        if (document.activeElement instanceof HTMLElement) {
+          focusReturnRef.current = document.activeElement;
+        }
+        setEditingIndex(index);
+        open(`modal-${fieldArrayName}`);
+      },
+      [fieldArrayName, open]
+    );
+
+    /** Handle opening the modal to add a new item */
+    const handleAddClick = useCallback((ev: React.MouseEvent) => {
+      ev.preventDefault();
+      // Store the currently focused element to restore focus later
+      if (document.activeElement instanceof HTMLElement) {
+        focusReturnRef.current = document.activeElement;
+      }
+      setIsAppending(true);
+    }, []);
+
+    /** Handle removing an item from the array */
+    const handleRemove = useCallback(
+      (index: number) => {
+        remove(index);
+
+        if (error) {
+          // Re-index errors for subsequent items
+          for (let i = index; i < fields.length - 1; i++) {
+            // Clear current index errors
+            clearErrors(`${fieldArrayName}.${i}`);
+
+            // Shift next index errors down
+            if (error[i + 1]) {
+              Object.keys(error[i + 1]).forEach((fieldName) => {
+                setError(
+                  `${fieldArrayName}.${i}.${fieldName}`,
+                  error[i + 1][fieldName]
+                );
+              });
+            }
+          }
+          // Clear the last index since it's been shifted
+          clearErrors(`${fieldArrayName}.${fields.length - 1}`);
+        }
+      },
+      [clearErrors, error, fieldArrayName, fields.length, remove, setError]
+    );
+
+    const handleMove = useCallback(
+      (from: number, to: number) => {
+        if (error && (error[from] || error[to])) {
+          const temp = error[from];
+          error[from] = error[to];
+          error[to] = temp;
+        }
+
+        move(from, to);
+      },
+      [error, move]
+    );
+
+    return (
+      <>
+        {!hasCommitedValues && (
+          <Hint {...customField.extra?.label.object?.nothing_added_props}>
+            {customField.extra?.label.object?.nothing_added}
+          </Hint>
+        )}
+        <ArrayEditModal
+          editOrAppend={handleEditOrAppend}
+          cancel={handleCancel}
+          type={isAppending ? 'append' : 'edit'}
+          appendLabel={customField.extra?.label.object.append.label}
+          appendProps={customField.extra?.label.object.append.props}
+          editLabel={customField.extra?.label.object.edit.label}
+          editProps={customField.extra?.label.object.edit.props}
+          cancelLabel={customField.extra?.label.object.cancel.label}
+          cancelProps={customField.extra?.label.object.cancel.props}
+          ofField={ofField}
+          title={title}
+          hint={customField.label?.secondary}
+          name={fieldArrayName}
+          defaultValue={defaultValue || undefined}
+          Field={Field}
+          error={error?.[editingIndex] ? error[editingIndex] : undefined}
+          {...registerModal(`modal-${fieldArrayName}`)}
+        />
+        {hasCommitedValues && (
+          <ArrayDisplay
+            fieldArrayName={fieldArrayName}
+            fieldArrayValues={fieldArrayValues}
+            ofField={ofField}
+            customField={customField}
+            onEdit={handleOpenEditModal}
+            onRemove={handleRemove}
+            move={handleMove}
+            sortable={sortable}
+            error={error}
+          />
+        )}
+        {customField.extra?.editVariant !== 'display' && // add noAdd: necessary for dilosi's 'fixed' fieldsets
+          !customField.extra?.noAdd && (
+            <div
+              className={
+                customField.extra?.label.object?.addButtonVariant === 'link'
+                  ? 'my-2 px-2 py-2 bg-gray-200 border-t border-b border-gray-400'
+                  : ''
+              }
+              {...customField?.extra?.label.object?.buttonGroup}
+            >
+              <Button
+                ref={ref}
+                type="button"
+                name={`${fieldArrayName}-add-object`}
+                color="secondary"
+                variant={customField.extra?.label.object?.addButtonVariant}
+                onClick={handleAddClick}
+                disabled={
+                  customField?.editable === false ||
+                  customField.extra?.editVariant === 'noinput' ||
+                  fields.length >= (customField.extra?.max ?? Number.MAX_VALUE)
+                }
+              >
+                {customField.extra?.label.object?.add}
+              </Button>
+            </div>
+          )}
+      </>
+    );
+  }
+);
+
+FormDialog.displayName = 'FormDialog';
+
+export default FormDialog;

package/src/FieldArray/__stories__/CardsWithError.tsx

@@ -0,0 +1,124 @@
+import React from 'react';
+import FormBuilder, { Field, FieldSpec } from '@digigov/form';
+import { Button } from '@digigov/ui/form/Button';
+
+export const CardsWithError = {
+  render: (args) => {
+    const field = {
+      key: 'multiplicity',
+      editable: true,
+      required: true,
+      type: 'array',
+      label: {
+        primary: 'Συνυπογράφοντες',
+        secondary: 'Οι συνυπογράφοντες είναι άνθρωποι σαν και εμάς',
+      },
+      extra: {
+        layout: args.layout,
+        noIndex: true,
+        border: false,
+        variant: 'dialog',
+        noHeader: false,
+        label: {
+          object: {
+            title: 'Συνυπογράφοντας',
+            title_added: 'Οι συνυπογράφοντες που έχετε προσθέσει',
+            add: 'Προσθήκη',
+            delete: 'Αφαίρεση συνυπογράφοντος',
+            append: {
+              label: 'Αποθήκευση',
+              props: {
+                color: 'primary',
+              },
+            },
+            edit: {
+              label: 'Αποθήκευση',
+              props: {
+                color: 'primary',
+              },
+            },
+            cancel: {
+              label: 'Ακύρωση',
+              props: {
+                variant: 'link',
+              },
+            },
+          },
+          question: {
+            title: 'Θέλετε να προσθέσετε επιπλέον συνυπογράφοντες;',
+            objectLabel: {
+              primary: 'Προσθήκη νέου συνυπογράφοντα',
+              secondary: 'Συμπληρώστε τα στοιχεία και μετά πατήστε «Προσθήκη»',
+            },
+            yes: 'Ναι',
+            no: 'Όχι',
+          },
+        },
+        min: 2,
+        // max: 4,
+        of: {
+          type: 'object',
+          extra: {
+            fields: [
+              {
+                key: 'firstName',
+                required: true,
+                type: 'string',
+                label: {
+                  primary: 'Όνομα',
+                },
+              },
+              {
+                key: 'lastName',
+                required: true,
+                type: 'string',
+                label: {
+                  primary: 'Επώνυμο',
+                },
+              },
+            ],
+          },
+        },
+      },
+    } as FieldSpec;
+
+    return (
+      <FormBuilder
+        initial={{
+          multiplicity: [
+            { firstName: 'Γιάννης', lastName: 'Παπαδόπουλος' },
+
+            { firstName: 'Μαρία', lastName: 'Ιωαννίδου' },
+          ],
+        }}
+        errors={
+          {
+            multiplicity: {
+              message: 'wrong_update_fields',
+              0: {
+                firstName: { message: 'Φτιάξε το first name', type: 'manual' },
+                lastName: { message: 'Φτιάξε το last name', type: 'manual' },
+              },
+            },
+          } as any
+        }
+        onSubmit={(data) => {
+          console.log(data);
+          window.alert('Submit success');
+        }}
+      >
+        <Field name="multiplicity" {...field} />
+        <Button>Συνέχεια</Button>
+      </FormBuilder>
+    );
+  },
+  args: {
+    layout: 'card',
+  },
+  argTypes: {
+    layout: {
+      options: ['card', 'table'],
+      control: { type: 'select' },
+    },
+  },
+};

package/src/FieldArray/__stories__/Default.tsx

@@ -15,6 +15,7 @@ const fields = [
   {
     key: 'multiplicity',
     type: 'array',
+    editable: true,
     label: {
       primary: 'Συνυπογράφοντες',
       secondary: 'Οι συνυπογράφοντες είναι άνθρωποι σαν και εμάς',
@@ -80,7 +81,7 @@ const fields = [
   },
 ] as FieldSpec[];
 
-export const Default = () => (
+export const Default = (_: any) => (
   <FormBuilder
     onSubmit={(data) => {
       console.log(data);

package/src/FieldArray/__stories__/WithExactLength.tsx

@@ -15,6 +15,7 @@ const fields = [
   {
     key: 'multiplicity',
     type: 'array',
+    editable: true,
     label: {
       primary: 'Συνυπογράφοντες',
       secondary: 'Οι συνυπογράφοντες είναι άνθρωποι σαν και εμάς',
@@ -80,7 +81,7 @@ const fields = [
   },
 ] as FieldSpec[];
 
-export const WithExactLength = () => (
+export const WithExactLength = (_: any) => (
   <FormBuilder
     onSubmit={(data) => {
       console.log(data);

package/src/FieldArray/__stories__/WithModal.tsx

@@ -0,0 +1,160 @@
+import React from 'react';
+import FormBuilder, { Field, FieldSpec } from '@digigov/form';
+import { Button } from '@digigov/ui/form/Button';
+
+const fields = [
+  {
+    key: 'string',
+    type: 'string',
+    label: {
+      primary: 'Πεδίο κειμένου',
+      secondary:
+        'Το multiplicity field είναι ένα πεδίο οπότε φαίνεται και είναι μέρος της φόρμας',
+    },
+  },
+  {
+    key: 'multiplicity',
+    editable: true,
+    required: true,
+    type: 'array',
+    label: {
+      primary: 'Συνυπογράφοντες',
+      secondary: 'Οι συνυπογράφοντες είναι άνθρωποι σαν και εμάς',
+    },
+    extra: {
+      noIndex: true,
+      border: false,
+      variant: 'dialog',
+      noHeader: false,
+      label: {
+        object: {
+          title: 'Συνυπογράφοντας',
+          title_added: 'Οι συνυπογράφοντες που έχετε προσθέσει',
+          add: 'Προσθήκη',
+          delete: 'Αφαίρεση συνυπογράφοντος',
+          append: {
+            label: 'Αποθήκευση',
+            props: {
+              color: 'primary',
+            },
+          },
+          edit: {
+            label: 'Αποθήκευση',
+            props: {
+              color: 'primary',
+            },
+          },
+          cancel: {
+            label: 'Ακύρωση',
+            props: {
+              variant: 'link',
+            },
+          },
+        },
+        question: {
+          title: 'Θέλετε να προσθέσετε επιπλέον συνυπογράφοντες;',
+          objectLabel: {
+            primary: 'Προσθήκη νέου συνυπογράφοντα',
+            secondary: 'Συμπληρώστε τα στοιχεία και μετά πατήστε «Προσθήκη»',
+          },
+          yes: 'Ναι',
+          no: 'Όχι',
+        },
+      },
+      min: 2,
+      // max: 4,
+      of: {
+        type: 'object',
+        extra: {
+          fields: [
+            {
+              key: 'firstName',
+              required: true,
+              type: 'string',
+              label: {
+                primary: 'Όνομα',
+              },
+            },
+            {
+              key: 'lastName',
+              required: true,
+              type: 'string',
+              label: {
+                primary: 'Επώνυμο',
+              },
+            },
+          ],
+        },
+      },
+    },
+  },
+  {
+    key: 'arrayofafm',
+    editable: true,
+    type: 'array',
+    label: {
+      primary: 'Συνυπογράφοντες',
+      secondary: 'Οι συνυπογράφοντες είναι άνθρωποι σαν και εμάς',
+    },
+    extra: {
+      variant: 'dialog',
+      noHeader: false,
+      label: {
+        object: {
+          title: 'Συνυπογράφοντας',
+          title_added: 'Οι συνυπογράφοντες που έχετε προσθέσει',
+          add: 'Προσθήκη',
+          delete: 'Αφαίρεση συνυπογράφοντος',
+          append: {
+            label: 'Αποθήκευση',
+            props: {
+              color: 'primary',
+            },
+          },
+          edit: {
+            label: 'Αποθήκευση',
+            props: {
+              color: 'primary',
+            },
+          },
+          cancel: {
+            label: 'Ακύρωση',
+            props: {
+              variant: 'link',
+            },
+          },
+        },
+        question: {
+          title: 'Θέλετε να προσθέσετε επιπλέον συνυπογράφοντες;',
+          objectLabel: {
+            primary: 'Προσθήκη νέου συνυπογράφοντα',
+            secondary: 'Συμπληρώστε τα στοιχεία και μετά πατήστε «Προσθήκη»',
+          },
+          yes: 'Ναι',
+          no: 'Όχι',
+        },
+      },
+      // min: 2,
+      // max: 4,
+      of: {
+        required: true,
+        type: 'afm',
+        label: {
+          primary: 'ΑΦΜ',
+        },
+      },
+    },
+  },
+] as FieldSpec[];
+
+export const WithModal = (_: any) => (
+  <FormBuilder
+    onSubmit={(data) => {
+      console.log(data);
+      window.alert('Submit success');
+    }}
+  >
+    <Field name="multiplicity" {...fields[1]} />
+    <Button>Συνέχεια</Button>
+  </FormBuilder>
+);