Topic guide Formsets

BaseFormSet has a couple of methods that are closely related to the ManagementForm, total_form_count and initial_form_count. total_form_count returns the total number of forms in this formset.

dev

Topic guide Formsets

BaseFormSet provides an additional attribute empty_form which returns a form instance with a prefix of __prefix__ for easier use in dynamic forms with JavaScript.

dev

Topic guide Working with forms

The HTML output when rendering a form is itself generated via a template. You can control this by creating an appropriate template file and setting a custom FORM_RENDERER to use that form_template_name site-wide.

dev

Reference JavaScript customizations in the admin

You may want to execute some JavaScript when an inline form is added or removed in the admin change form. The formset:added and formset:removed events allow this. event.detail.formsetName is the formset the row belongs to.

4.2 5.0 5.1 5.2 6.0

Reference The Forms API

Form.initial Use initial to declare the initial value of form fields at runtime. For example, you might want to fill in a username field with the username of the current session.

4.2 5.0 5.1 5.2 6.0

Reference Model forms

classModelFormOptions[source] The _meta API is used to build forms that reflect a Django model. It is accessible through the _meta attribute of each model form, and is an django.forms.models.ModelFormOptions instance.

5.2 6.0

Reference Model forms

5.2 6.0

Reference

Django’s form widgets are rendered using Django’s template engines system. The form rendering process can be customized at several levels: Widgets can specify custom template names. Forms and widgets can specify custom renderer classes.

4.2 5.0 5.1 5.2 6.0

Reference The form rendering API

4.2 5.0 5.1 5.2 6.0

Reference The form rendering API

Form templates receive a context from Form.get_context(). By default, forms receive a dictionary with the following values: form: The bound form. fields: All bound fields, except the hidden fields. hidden_fields: All hidden bound fields.

4.2 5.0 5.1 5.2 6.0

Reference The form rendering API

Form.template_name To override form templates, you must use the TemplatesSetting renderer. Then overriding form templates works the same as overriding any other template in your project.

4.2 5.0 5.1 5.2 6.0

Topic guide Working with forms Working with form templates

The HTML output when rendering a form is itself generated via a template. You can control this by creating an appropriate template file and setting a custom FORM_RENDERER to use that form_template_name site-wide.

5.0 5.1 5.2 6.0

Reference

Model Form API reference. For introductory material about model forms, see the Creating forms from models topic guide.

4.2 5.0 5.1

Topic guide Working with forms Working with form templates

The HTML output when rendering a form is itself generated via a template. You can control this by creating an appropriate template file and setting a custom FORM_RENDERER to use that form_template_name site-wide.

4.2

How-to How to create custom model fields

To customize the form field used by ModelForm, you can override formfield(). The form field class can be specified via the form_class and choices_form_class arguments; the latter is used if the field has choices specified, the former otherwise.

dev

Tutorial Writing your first Django app, part 4

Let’s update our poll detail template (“polls/detail.html”) from the last tutorial, so that the template contains an HTML <form> element: polls/templates/polls/detail.html A quick rundown: The above template displays a radio button for each question choice.

dev

Tutorial Writing your first Django app, part 7

By registering the Question model with admin.site.register(Question), Django was able to construct a default form representation. Often, you’ll want to customize how the admin form looks and works.

dev

Reference

All of these fields and widgets are available from the django.contrib.postgres.forms module.

dev

Reference The Forms API

Form.has_changed() Use the has_changed() method on your Form when you need to check if the form data has been changed from the initial data.

dev

Reference The Forms API

Form.error_css_class Form.required_css_class It’s pretty common to style form rows and fields that are required or have errors. For example, you might want to present required form rows in bold and highlight errors in red.

dev