Skip to main content

Best way to have Django DRY forms

Project description

https://github.com/django-crispy-forms/django-crispy-forms/workflows/C/I%20Testing./badge.svg https://img.shields.io/badge/code%20style-black-000000.svg http://codecov.io/github/django-crispy-forms/django-crispy-forms/coverage.svg?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.

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.

Example

This is a teaser of what you can do with latest django-crispy-forms. Find here the gist for generating this form:

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

Documentation

For extensive documentation see the docs folder or read it on readthedocs

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-crispy-forms-1.11.2.tar.gz (63.8 kB view details)

Uploaded Source

Built Distribution

django_crispy_forms-1.11.2-py3-none-any.whl (113.0 kB view details)

Uploaded Python 3

File details

Details for the file django-crispy-forms-1.11.2.tar.gz.

File metadata

  • Download URL: django-crispy-forms-1.11.2.tar.gz
  • Upload date:
  • Size: 63.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/3.7.3 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.2

File hashes

Hashes for django-crispy-forms-1.11.2.tar.gz
Algorithm Hash digest
SHA256 88efa857ce6111bd696cc4f74057539a3456102fe9c3a3ece8868e1e4579e70a
MD5 031fc67e45de322f7dc4ba4505a4aa5b
BLAKE2b-256 8a79f976b92e8590108b1d03c55d13502c09bfad0235c836a1f140ad083e37ca

See more details on using hashes here.

File details

Details for the file django_crispy_forms-1.11.2-py3-none-any.whl.

File metadata

  • Download URL: django_crispy_forms-1.11.2-py3-none-any.whl
  • Upload date:
  • Size: 113.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/3.7.3 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.2

File hashes

Hashes for django_crispy_forms-1.11.2-py3-none-any.whl
Algorithm Hash digest
SHA256 3db71ab06d17ec9d0195c086d3ad454da300ac268752ac3a4f63d72f7a490254
MD5 ae31a2e2fcc5fb9c958d2441e623db69
BLAKE2b-256 2adff4618a94c3b1f748c6876bc178f2f80ec7a9fc6ef17a406c80009bbb130d

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page