https://github.com/infinityloop-dev/multistep-form

:wrench: Component for Nette framwork which helps with creation of multistep forms.
https://github.com/infinityloop-dev/multistep-form

component multistep-forms nette nette-component php

Last synced: about 1 month ago
JSON representation

:wrench: Component for Nette framwork which helps with creation of multistep forms.

• Host: GitHub
• URL: https://github.com/infinityloop-dev/multistep-form
• Owner: infinityloop-dev
• License: mit
• Created: 2020-01-17T19:15:40.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2020-02-02T21:03:14.000Z (almost 5 years ago)
• Last Synced: 2024-04-19T03:43:18.137Z (9 months ago)
• Topics: component, multistep-forms, nette, nette-component, php
• Language: PHP
• Homepage: https://www.infinityloop.dev
• Size: 28.3 KB
• Stars: 4
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Multistep form

:wrench: Component for Nette framwork which helps with creation of multistep forms.

## Introduction

This component provides a simple way to create a multistep form. Handles swapping between steps, passing values from previous steps to current one and passing all combined values to final success callback. Also handles common edge cases, such as distinction between multiple instances of one form accessed by one client.

## Installation

Install package using composer

```

composer require infinityloop-dev/multistep-form

```

## Dependencies

- PHP >= 7.4

- [nette/application](https://github.com/nette/application)

- [nette/http](https://github.com/nette/http)

- [nette/forms](https://github.com/nette/forms)

## How to use

- Register `\Infinityloop\MultistepForm\IMultiStepFormFactory` as service in cofiguration file.

- Inject it into component/presenter where you wish to use multi step form, 

    - write createComponent method and use macro {control} in template file

- Submit buttons for moving forward and backward are added automaticaly.

### Example createComponent method

```

protected function createComponentMultistepForm() : \Infinityloop\MultistepForm\MultistepForm

{

    $multistepForm = $this->multistepFormFactory->create()

        ->setDefaults(['action' => \App\Enum\EAction::ACTION2])

        ->setSuccessCallback(function(array $values) {

            $this->model->save($values);

        });

    // first step

    $multistepForm->addFactory(function() : \Nette\Forms\Form {

        $form = new \Nette\Application\UI\Form();

        $form->addProtection();

        $form->setTranslator($this->translator);

        $form->addSelect('action', 'Akce', \App\Enum\EAction::ENUM)

            ->setRequired();

        return $form;

    }, __DIR__ . '/step1.latte');

    // second step

    $multistepForm->addFactory(function(array $previousValues) : \Nette\Forms\Form {

        $form = new \Nette\Application\UI\Form();

        $form->addProtection();

        $form->setTranslator($this->translator);

        if (\in_array($previousValues['action'], [\App\Enum\EAction::ACTION1, \App\Enum\EAction::ACTION2], true)) {

            $form->addText('action_1or2', 'Action 1 or 2')

                ->setRequired();

        } else {

            $form->addText('action_xyz', 'Action Xyz')

                ->setRequired();

        }

    });

    return $multistepForm;

}

```

### Options

- setDefaults(array)

    - default values for your form, all steps at once

- addFactory(callable, ?string)

    - first argument is factory function from which the form is created

    - second argument is custom template path

        - the standard `{control form}` is used if no template is specified for current step

        - in custom template you can manualy render each step using `{form form} ... {/form}`

- setSuccessCallback(callable)

    - callback where values from all steps are sent after submitting last step