/* * MIT License * * Copyright (c) 2020-present Cloudogu GmbH and Contributors * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all * copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE * SOFTWARE. */ import React, { FC, useCallback, useEffect, useState } from "react"; import { DeepPartial, SubmitHandler, useForm, UseFormReturn } from "react-hook-form"; import { ErrorNotification, Level } from "@scm-manager/ui-components"; import { ScmFormContextProvider } from "./ScmFormContext"; import { useTranslation } from "react-i18next"; import { Button } from "@scm-manager/ui-buttons"; import styled from "styled-components"; import { setValues } from "./helpers"; type RenderProps> = Omit< UseFormReturn, "register" | "unregister" | "handleSubmit" | "control" >; const ButtonsContainer = styled.div` display: flex; gap: 0.75rem; `; const SuccessNotification: FC<{ label?: string; hide: () => void }> = ({ label, hide }) => { if (!label) { return null; } return (
); }; type Props, DefaultValues extends FormType> = { children: ((renderProps: RenderProps) => React.ReactNode | React.ReactNode[]) | React.ReactNode; translationPath: [namespace: string, prefix: string]; onSubmit: SubmitHandler; defaultValues: DefaultValues; readOnly?: boolean; submitButtonTestId?: string; /** * Renders a button which resets the form to its default. * This reflects the default browser behavior for a form *reset*. * * @since 2.43.0 */ withDiscardChanges?: boolean; /** * Renders a button which acts as if a user manually updated all fields to supplied values. * The default use-case for this is to clear forms and this is also how the button is labelled. * You can also use it to reset the form to an original state, but it is then advised to change the button label * to *Reset to Defaults* by defining the *reset* translation in the form's translation object's root. * * > *Important Note:* This mechanism cannot be used to change the number of items in lists, * > neither on the root level nor nested. * > It is therefore advised not to use this property when lists or nested forms are involved. * * @since 2.43.0 */ withResetTo?: DefaultValues; /** * Message to display after a successful submit if no translation key is defined. * * If this is not supplied and the root level `submit-success-notification` translation key is not set, * no message is displayed at all. * * @since 2.43.0 */ successMessageFallback?: string; }; /** * @beta * @since 2.41.0 */ function Form, DefaultValues extends FormType = FormType>({ children, onSubmit, defaultValues, translationPath, readOnly, withResetTo, withDiscardChanges, successMessageFallback, submitButtonTestId, }: Props) { const form = useForm({ mode: "onChange", defaultValues: defaultValues as DeepPartial, }); const { formState, handleSubmit, reset, setValue } = form; const [ns, prefix] = translationPath; const { t } = useTranslation(ns, { keyPrefix: prefix }); const [defaultTranslate] = useTranslation("commons", { keyPrefix: "form" }); const translateWithFallback = useCallback( (key, ...args) => { const translation = t(key, ...(args as any)); if (translation === `${prefix}.${key}`) { return ""; } return translation; }, [prefix, t] ); const { isDirty, isValid, isSubmitting, isSubmitSuccessful } = formState; const [error, setError] = useState(); const [showSuccessNotification, setShowSuccessNotification] = useState(false); const submitButtonLabel = t("submit", { defaultValue: defaultTranslate("submit") }); const resetButtonLabel = t("reset", { defaultValue: defaultTranslate("reset") }); const discardChangesButtonLabel = t("discardChanges", { defaultValue: defaultTranslate("discardChanges") }); const successNotification = translateWithFallback("submit-success-notification", { defaultValue: successMessageFallback, }); const overwriteValues = useCallback(() => { if (withResetTo) { setValues(withResetTo, setValue); } }, [setValue, withResetTo]); // See https://react-hook-form.com/api/useform/reset/ useEffect(() => { if (isSubmitSuccessful) { setShowSuccessNotification(true); } }, [isSubmitSuccessful]); useEffect(() => reset(defaultValues as never), [defaultValues, reset]); useEffect(() => { if (isDirty) { setShowSuccessNotification(false); } }, [isDirty]); const submit = useCallback( async (data) => { setError(null); try { return await onSubmit(data); } catch (e) { if (e instanceof Error) { setError(e); } else { throw e; } } }, [onSubmit] ); return (
reset()} id={prefix} noValidate>
{showSuccessNotification ? ( setShowSuccessNotification(false)} /> ) : null} {typeof children === "function" ? children(form) : children} {error ? : null} {!readOnly ? ( {withDiscardChanges ? ( ) : null} {withResetTo ? ( ) : null} } /> ) : null}
); } export default Form;