django-crispy-forms
The best way to have Django DRY forms. Build programmatic reusable layouts out of components, having full control of the rendered HTML without writing HTML in templates. All this without breaking the standard way of doing things in Django, so it plays nice with any other form application.
django-crispy-forms supports Django 2.2, 3.0 and 3.1 with Python 3.5+. Note: Django 3.1 requires `django-crispy-forms` version 1.9 or higher.
Versions of django-crispy-forms prior to 1.9.0 also supported Python 2.7 and Django 1.11/2.1
The application mainly provides:
- A filter named
|crispy
that will render elegant div based forms. Think of it as the built-in methods:as_table
,as_ul
andas_p
. You cannot tune up the output, but it is easy to start using it. - A tag named
{% crispy %}
that will render a form based on your configuration and specific layout setup. This gives you amazing power without much hassle, helping you save tons of time.
Django-crispy-forms supports several frontend frameworks, such as Twitter Bootstrap (versions 2, 3, and 4), Uni-form and Foundation. You can also easily adapt your custom company's one, creating your own, see the docs for more information. You can easily switch among them using CRISPY_TEMPLATE_PACK
setting variable.
Authors
django-crispy-forms is the new django-uni-form. django-uni-form was an application created by Daniel Greenfeld that I led since version 0.8.0. The name change tries to better explain the purpose of the application, which changed in a significant way since its birth.
If you are upgrading from django-uni-form, we have instructions for helping you.
- Lead developer: Miguel Araujo
Example
This is a teaser of what you can do with latest django-crispy-forms. Find here the gist for generating this form:
Documentation
For extensive documentation see the docs
folder or read it on readthedocs
Special thanks
- To Daniel Greenfeld (@pydanny) for his support, time and the opportunity given to me to do this.
- The name of the project was suggested by the fantastic Audrey Roy (@audreyr)
- To Kenneth Love (@kennethlove) for creating django-uni-form-contrib from which bootstrap template pack was started.