Need help with django-crispy-forms?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

django-crispy-forms
4.0K Stars 677 Forks MIT License 1.6K Commits 76 Opened issues

Description

The best way to have DRY Django forms. The app provides a tag and filter that lets you quickly render forms in a div format while providing an enormous amount of capability to configure and control the rendered HTML.

Services available

!
?

Need anything else?

Contributors list

No Data

===================

django-crispy-forms

.. image:: https://github.com/django-crispy-forms/django-crispy-forms/workflows/C/I%20Testing./badge.svg

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg :target: https://github.com/psf/black

.. image:: http://codecov.io/github/django-crispy-forms/django-crispy-forms/coverage.svg?branch=master :target: http://codecov.io/github/django-crispy-forms/django-crispy-forms?branch=master

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
    and
    as_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.

.. _

Uni-form
: http://sprawsm.com/uni-form .. _
Bootstrap
: https://getbootstrap.com .. _
see the docs
: https://django-crispy-forms.readthedocs.io

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
    _

.. _

Daniel Greenfeld
: https://github.com/pydanny .. _
Miguel Araujo
: https://github.com/maraujop .. _
instructions
: https://django-crispy-forms.readthedocs.io/en/latest/install.html#moving-from-django-uni-form-to-django-crispy-forms

Example

This is a teaser of what you can do with latest django-crispy-forms.

Find here the gist
_ for generating this form:

.. image:: http://i.imgur.com/LSREg.png

.. _

Find here the gist
: https://gist.github.com/1838193

Documentation

For extensive documentation see the

docs
folder or
read it on readthedocs
_

.. _

read it on readthedocs
: https://django-crispy-forms.readthedocs.io/en/latest/index.html

Special thanks

  • To Daniel Feldroy (
    @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 Feldroy (
    @audreyfeldroy
    _)
  • To Kenneth Love (
    @kennethlove
    _) for creating django-uni-form-contrib from which bootstrap template pack was started.

.. _

@audreyfeldroy
: https://github.com/audreyfeldroy .. _
@pydanny
: https://github.com/pydanny .. _
@kennethlove
: https://github.com/kennethlove

.. _Django: http://djangoproject.com

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.