uktrade/lite-forms

# Generic views

In order to display a form/series of forms you should extend your template view from one of LITE-Form's generic views. There are currently two available:

## SingleFormView

SingleFormViews, as the name would suggest, enables you to display a form and handle submission of it.

```
class ApplicationEditReferenceName(SingleFormView):
    def init(self, request, **kwargs):
        self.object_pk = kwargs["pk"]
        self.data = get_application(request, self.object_pk)
        self.form = reference_name_form(self.object_pk)
        self.action = put_application
        self.success_url = reverse_lazy("applications:task_list", kwargs={"pk": self.object_pk})
```

**object_pk:** Refers to the object that the form is referencing. (Optional)

**data:** Refers to initial data to be displayed on the form. (Optional)

**form:** Refers to the form to be used.

**action:** Refers to the function that should be called on submission.

**success_url:** Refers to what page should be displayed on a successful submission.

**redirect:** If set to false, the form will just display itself rather than use the success_url. (Optional)

## MultiFormView

MultiFormViews enables you to display multiple forms (as part of a FormGroup) and handles submission of them.

```
class SetEndUser(MultiFormView):
    def init(self, request, **kwargs):
        self.object_pk = kwargs["pk"]
        application = get_application(request, self.object_pk)
        self.data = application["end_user"]
        self.forms = new_end_user_forms(application)
        self.action = post_end_user
        self.success_url = reverse_lazy("applications:end_user_attach_document", kwargs={"pk": self.object_pk})
```

**object_pk:** Refers to the object that the forms are referencing. (Optional)

**data:** Refers to initial data to be displayed on the form. (Optional)

**forms:** Refers to the form group to be used.

**action:** Refers to the function that should be called on submission.

**success_url:** Refers to what page should be displayed on a successful submission.