Template-based rendering of Django forms (excluding widgets).
Project description
django-formrenderingtools is an application for the Django framework. It provides tools for the template designer to customize forms.
Rather than using {{ form.as_p }}, set up and reuse templates to render Django’s form elements.
For the impatient, use the bundled demo project to discover and try the application (see docs/demo.txt for details).
This application provides a “form_layouts” template tag library which itself provides the following template tags:
form: renders a full form, i.e. non field errors, all fields, field errors, labels and help texts
form_errors: renders global form errors, i.e. non field errors
field_list: renders a set of fields in a form, with corresponding field errors, labels and help texts
field: renders a field, with field errors, label and help text
field_errors: renders errors related to a field
label: renders a field’s label
help_text: renders a field’s help text
The goal of this application is to provide a pack of template tags which helps you render each element of a form: full form, list of fields, non field errors (global errors), field errors (specific errors), field, label, help text…
Every form element has a corresponding template tag, which uses templates to generate the output. Template designers no longer rely on developers to customize the form output.
This application uses a template-naming system that lets you reuse generic templates or use specific ones, depending on your needs. You can reuse built-in templates, override them or create your own templates.
Links
- HTML documentation
Browse the HTML documentation online at http://packages.python.org/django-formrenderingtools/
- RestructuredText documentation
Read the RestructuredText documentation in the docs/ folder in the source code
- Source code repository
Follow the project on BitBucket at http://bitbucket.org/benoitbryon/django-formrenderingtools
- Pypi
The project is known as “django-formrenderingtools” in the Python package index. See http://pypi.python.org/pypi/django-formrenderingtools
Credits and license
This application is published under the BSD license. See docs/LICENSE.txt for details.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Hashes for django-formrenderingtools-0.2.1.zip
Algorithm | Hash digest | |
---|---|---|
SHA256 | 810ef3d8d269b42df843354cadcce3b68773b15134ed3e6c9a299e422710df4c |
|
MD5 | 73b51756756b3b513a2b1cda726e8c27 |
|
BLAKE2b-256 | fc81f1946a58e8b6ed4751c9cb125ff663d280cfde83b7597ef578c92af3b62e |
Hashes for django-formrenderingtools-0.2.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1078ae3604cdec5ef552763378e7819c799a680efe9361d9da2c7f8193bc9809 |
|
MD5 | 6cd86cb62dbe036ee48da392cf56041a |
|
BLAKE2b-256 | cf6fbe130bca6102a3f546d000a94ef9592a9137f3209750c6d852dc49e76efd |