django-crispy-forms editorconfig travis-ci python

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.

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

django-crispy-forms

.. image:: https://travis-ci.org/maraujop/django-crispy-forms.png?branch=dev :alt: Build Status :target: https://travis-ci.org/maraujop/django-crispy-forms

.. image:: http://codecov.io/github/maraujop/django-crispy-forms/coverage.svg?branch=master :target: http://codecov.io/github/maraujop/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 Python 2.7/Python 3.2+ and Django 1.8+

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 and 3), 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: http://twitter.github.com/bootstrap/index.html .. _see the docs: http://django-crispy-forms.rtfd.org

Authors

django-crispy-forms is the new django-uni-form. django-uni-form was an application created by Daniel Greenfeld_ that I leaded 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: http://django-crispy-forms.readthedocs.org/en/1.1.1/migration.html

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: http://django-crispy-forms.readthedocs.org/en/latest/index.html

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.

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

.. _Django: http://djangoproject.com

Related Repositories

django-crispy-forms

django-crispy-forms

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

django-crispy-forms

django-crispy-forms

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

django-uni-form

django-uni-form

django-uni-form has been deprecated. Please use django-crispy-forms. Link provided in the README.rst ...

crispy-forms-foundation

crispy-forms-foundation

Django application to add 'django-crispy-forms' layout objects for Foundation ...

django-crispy-forms-fancy-formsets

django-crispy-forms-fancy-formsets

Trying to make sense of creating, validating, saving, rendering and dynamically adding rows to formsets ...


Top Contributors

maraujop pydanny carltongibson Stranger6667 jcomeauictx zoidbergwill meshy digi604 bmihelac treyhunner kavdev dbinit j0hnsmith mvaerle jamesmfriedman phoolish beezz fin agentk davidfischer-ch ikatson mrkre johnthedebs powderflask poswald pjdelport nott rh0dium laplacesdemon issackelly

Releases

-   1.6.0 zip tar
-   1.5.2 zip tar
-   1.5.1 zip tar
-   1.5.0 zip tar
-   1.4.0 zip tar
-   1.3.2 zip tar
-   1.3.1 zip tar
-   1.3.0 zip tar
-   1.2.8 zip tar
-   1.2.7 zip tar
-   1.2.6 zip tar
-   1.2.5 zip tar
-   1.2.4 zip tar
-   1.2.3 zip tar
-   1.2.2 zip tar
-   1.2.1 zip tar
-   1.2.0 zip tar
-   1.1.4 zip tar
-   1.1.3 zip tar
-   1.1.2 zip tar
-   1.1.1 zip tar
-   1.1.0 zip tar
-   0.9.0 zip tar
-   0.8.0 zip tar
-   0.7.0 zip tar
-   0.6.0 zip tar
-   0.5.0 zip tar