srfm_on_trigger_form_submission

Description:

This event is triggered just before the form submission process begins. It allows external scripts to intercept and potentially modify or cancel the submission process. Calling event.preventDefault() stops the submission flow and prevents the loader from being displayed.

Parameters:

• form: The form element that is being submitted.
• loader: The loader element associated with the form, which will be activated during submission.
• formId: The unique identifier for the form being submitted.
• submitType: The type of form submission (e.g., “same page”, “different page”, “custom URL”).
• successElement: The element intended to display the success message after submission.
• successContainer: The container that wraps the success message element.

Event Implementation:

   const event = new CustomEvent( 'srfm_on_trigger_form_submission', {
          cancelable: true,
          detail: {
            form,
            loader,
            formId,
            submitType,
            successElement,
            successContainer,
          },
        } );

    if ( ! document.dispatchEvent( event ) ) {
        loader.classList.remove( 'srfm-active' );
        return; // Stop further execution if event.preventDefault() was called.
      }