https://github.com/zagaran/django-multiform-views
An expansion of django's FormView to handle multiple form submissions
https://github.com/zagaran/django-multiform-views
open-source
Last synced: 13 days ago
JSON representation
An expansion of django's FormView to handle multiple form submissions
- Host: GitHub
- URL: https://github.com/zagaran/django-multiform-views
- Owner: zagaran
- License: mit
- Created: 2019-11-12T19:31:08.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-04-21T20:41:40.000Z (about 2 years ago)
- Last Synced: 2025-04-11T04:35:43.026Z (3 months ago)
- Topics: open-source
- Language: Python
- Size: 24.4 KB
- Stars: 2
- Watchers: 6
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# django-multiple-forms
An expansion of django's FormView to handle multiple form submissions
## How To Use
#### Install the dependency
```
pip install django-multiform-views
```
or add `django-multiform-views` to your `requirements.in` file, then run
```
pip compile
pip install -r requirements.txt
```
#### Usage
Have your view inherit from ```FormsView```.
Render `multiform_key` as a hidden input in the frontend form. This can be done manually or by
appending `multiform_key` to the layout is using crispy forms. The key is already added to the
form initial so only the frontend addition is needed.
Instead of the `FormView` `form_class` property, define the `form_classes` property as a dictionary of
`String`, `Form` class pairs:
```
form_classes = {
'first_form': FirstForm,
'second_form': SecondForm,
}
```
Alternatively you can override the `get_form_classes()` function, which by default returns the
`form_classes` property
The package will detect which form was submitted in the view. You can perform
individual validation for each form:
```
def first_form_valid(self, form):
...
def second_form_valid(self, form):
...
```
This same pattern is true for all form instantiation and handling methods from FormView. They can be
defined individually for each form using the form key defined in form_classes as an infix, e.g.
`get_initial` becomes `get_first_form_initial` and `get_form_kwargs` becomes `get_second_form_kwargs`.
All other class properties and methods behave identically to those in Django's `FormView`